Когда покупатель сообщает об отказе оплаты, поддержке нужен конкретный платёж и причина отмены, а не предположение по тексту на экране. ЮKassa разделяет инициатора и основание отказа. Документация проверена редакцией 12 октября 2026 года; ниже — порядок разбора обращения интернет-магазином.

Найдите операцию без лишних данных

В cancellation_details передаются party и reason. Инициатором может быть магазин, ЮKassa либо другой участник платёжного процесса. Поэтому одинаковое сообщение «не удалось оплатить» может требовать совершенно разных действий.

Попросите номер заказа и примерное время попытки. Найдите связанный платёж в своём учёте. Для такого поиска не нужны полный номер карты, защитный код или пароль покупателя. Не просите клиента пересылать снимок банковского приложения, если задача решается идентификатором заказа и доступными служебными данными.

Разделите устранимую причину и неизвестный отказ

В справке insufficient_funds означает нехватку средств, card_expired — истёкший срок карты, expired_on_confirmation — незавершённую вовремя оплату. Для general_decline причина не детализирована: уточнения нужны у инициатора отмены.

Подготовьте короткие ответы под разные случаи. При нехватке средств покупателю полезно предложить доступный ему другой способ или пополнение, а при неизвестном отказе — сообщить, что магазин не видит точного банковского основания. Не приписывайте отказ «блокировке магазина», если данные этого не подтверждают.

Не пытайтесь оживить завершённый отказ

Статус canceled является конечным. Чтобы повторить оплату, создают новый платёж с новым ключом идемпотентности. Это отличается от повторной передачи запроса с неизвестным результатом: здесь отказ исходной операции уже установлен.

Внутренний заказ при этом может оставаться одной покупкой. Сохраните историю попыток, чтобы менеджер видел, какая из них была отклонена, а какая ещё рассматривается. Прежде чем отправлять новую ссылку, проверьте, не поступило ли успешное подтверждение по другой попытке того же заказа.

Верните результат в процесс магазина

Условный пример: клиент трижды пытался заплатить, затем связался с поддержкой. Нужно собрать историю всех трёх операций, установить актуальную и не создавать четвёртую автоматически по первому сообщению. Это снижает путаницу в переписке и помогает объяснить покупателю следующий шаг.

После успешной новой оплаты проверьте, что склад получает одну задачу и заказ не остался отмеченным как окончательно отменённый. Общий принцип сопоставления описан в разборе платёжных ссылок. Для статистики магазина сохраняйте подтверждённую причину: неизвестные отказы не следует распределять по удобным категориям без оснований.