Неуспешные платежи
В процессе платежа что-то может пойти не так. Например, пользователю может не хватить денег для оплаты, эмитент может быть недоступен, Яндекс.Касса может заподозрить попытку мошенничества. В этом случае платеж будет отменен и перейдет в статус
canceled
.
Чтобы вы могли лучше понимать, что произошло и что с этим делать, Яндекс.Касса пришлет в объекте платежа  комментарий к отмене платежа (
cancellation_details
). В нем будут указаны инициатор (
cancellation_details.party
) и причина отмены (
cancellation_details.reason
). Вы можете использовать эти данные для анализа и решения проблем, вывода сообщений пользователю и любых других целей.
 Инициаторы отмены платежа
ЗначениеОписание
merchantПродавец товаров и услуг (вы)
yandex_checkoutЯндекс.Касса
payment_network«Внешние» участники платежного процесса — все остальные участники платежного процесса, кроме Яндекс.Кассы и вас (например, эмитент, сторонний платежный сервис)
 Причины отмены платежа
ЗначениеОписание
3d_secure_failedНе пройдена аутентификация по 3-D Secure. Пользователю следует повторить платеж, обратиться в банк за уточнениями или использовать другое платежное средство
call_issuerОплата данным платежным средством отклонена по неизвестным причинам. Пользователю следует обратиться в организацию, выпустившую платежное средство
card_expiredИстек срок действия банковской карты. Пользователю следует использовать другое платежное средство
country_forbiddenНельзя заплатить банковской картой, выпущенной в этой стране. Пользователю следует использовать другое платежное средство.
Вы можете настроить ограничения на оплату иностранными банковскими картами
fraud_suspectedПлатеж заблокирован из-за подозрения в мошенничестве. Пользователю следует использовать другое платежное средство
general_declineПричина не детализирована. Пользователю следует обратиться к инициатору отмены платежа за уточнением подробностей
identification_requiredПревышены ограничения на платежи для кошелька в Яндекс.Деньгах. Пользователю следует идентифицировать кошелек или выбрать другое платежное средство
insufficient_fundsНе хватает денег для оплаты. Пользователю следует пополнить баланс или использовать другое платежное средство
invalid_card_numberНеправильно указан номер карты. Пользователю следует повторить платеж и ввести корректные данные
invalid_cscНеправильно указан код CVV2 (CVC2, CID). Пользователю следует повторить платеж и ввести корректные данные
issuer_unavailableОрганизация, выпустившая платежное средство, недоступна. Пользователю следует повторить платеж позже или использовать другое платежное средство
payment_method_limit_exceededИсчерпан лимит платежей для данного платежного средства или вашего магазина. Пользователю следует повторить платеж на следующий день или использовать другое платежное средство
payment_method_restrictedЗапрещены операции данным платежным средством (например, карта заблокирована из-за утери, кошелек — из-за взлома мошенниками). Пользователю следует обратиться в организацию, выпустившую платежное средство
permission_revokedНельзя провести безакцептное списание: пользователь отозвал разрешение на автоплатежи. Если пользователь еще хочет оплатить, вам необходимо создать новый платеж, а пользователю — подтвердить оплату.
Статус
canceled
 — финальный и неизменяемый. Чтобы повторить платеж, вы должны создать новый объект платежа  с другим ключом идемпотентности.
Пример объекта платежа в статусе canceled
JSON
{
  "id": "22979b7b-000f-5000-9000-1a603a795739",
  "status": "canceled",
  "paid": false,
  "amount": {
    "value": "2.00",
    "currency": "RUB"
  },
  "created_at": "2018-05-23T15:24:43.812Z",
  "metadata": {},
  "payment_method": {
    "type": "bank_card",
    "id": "22979b7b-000f-5000-9000-1a603a795739",
    "saved": false
  },
  "recipient": {
    "account_id": "100001",
    "gateway_id": "1000001"
  },
  "requestor": {
    "type": "merchant",
    "account_id": "100001"
  },
  "refundable": false,
  "test": false,
  "cancellation_details": {
    "party": "payment_network",
    "reason": "payment_method_restricted"
  }
}
Вы можете протестировать отмену платежа с помощью тестовых банковских карт.
 Что почитать еще
HTTP-коды ответовПроведение платежейСпособы оплатыТестирование