В процессе платежа что-то может пойти не так. Например, пользователю может не хватить денег для оплаты, эмитент может быть недоступен, ЮKassa может заподозрить попытку мошенничества. В этом случае платеж будет отменен и перейдет в статус
canceled
.Чтобы вы могли лучше понимать, что произошло и что с этим делать, ЮKassa пришлет в объекте платежа комментарий к отмене платежа (
cancellation_details
). В нём будут указаны инициатор (cancellation_details.party
) и причина отмены (cancellation_details.reason
). Вы можете использовать эти данные для анализа и решения проблем, вывода сообщений пользователю и любых других целей.Значение | Описание |
---|---|
merchant | Продавец товаров и услуг (вы) |
yoo_money | ЮKassa |
payment_network | Любые участники процесса платежа, кроме ЮKassa и вас (например, эмитент, сторонний платежный сервис) |
Значение | Описание |
---|---|
3d_secure_failed | Не пройдена аутентификация по 3-D Secure. При новой попытке оплаты пользователю следует пройти аутентификацию, использовать другое платежное средство или обратиться в банк за уточнениями |
call_issuer | Оплата данным платежным средством отклонена по неизвестным причинам. Пользователю следует обратиться в организацию, выпустившую платежное средство |
canceled_by_merchant | Платеж отменен по API при оплате в две стадии |
card_expired | Истек срок действия банковской карты. При новой попытке оплаты пользователю следует использовать другое платежное средство |
country_forbidden | Нельзя заплатить банковской картой, выпущенной в этой стране. При новой попытке оплаты пользователю следует использовать другое платежное средство. Вы можете настроить ограничения на оплату иностранными банковскими картами |
deal_expired | Для тех, кто использует Безопасную сделку: закончился срок жизни сделки. Если вы еще хотите принять оплату, создайте новую сделку и проведите для нее новый платеж |
expired_on_capture | Истек срок списания оплаты у двухстадийного платежа. Если вы еще хотите принять оплату, повторите платеж с новым ключом идемпотентности и спишите деньги после подтверждения платежа пользователем |
expired_on_confirmation | Истек срок оплаты: пользователь не подтвердил платеж за время, отведенное на оплату выбранным способом. Если пользователь еще хочет оплатить, вам необходимо повторить платеж с новым ключом идемпотентности, а пользователю — подтвердить его |
fraud_suspected | Платеж заблокирован из-за подозрения в мошенничестве. При новой попытке оплаты пользователю следует использовать другое платежное средство |
general_decline | Причина не детализирована. Пользователю следует обратиться к инициатору отмены платежа за уточнением подробностей |
identification_required | Превышены ограничения на платежи для кошелька ЮMoney. При новой попытке оплаты пользователю следует идентифицировать кошелек или выбрать другое платежное средство |
insufficient_funds | Не хватает денег для оплаты. Пользователю следует пополнить баланс или использовать другое платежное средство |
internal_timeout | Технические неполадки на стороне ЮKassa: не удалось обработать запрос в течение 30 секунд. Повторите платеж с новым ключом идемпотентности |
invalid_card_number | Неправильно указан номер карты. При новой попытке оплаты пользователю следует ввести корректные данные |
invalid_csc | Неправильно указан код CVV2 (CVC2, CID). При новой попытке оплаты пользователю следует ввести корректные данные |
issuer_unavailable | Организация, выпустившая платежное средство, недоступна. При новой попытке оплаты пользователю следует использовать другое платежное средство или повторить оплату позже |
payment_method_limit_exceeded | Исчерпан лимит платежей для данного платежного средства или вашего магазина. При новой попытке оплаты пользователю следует использовать другое платежное средство или повторить оплату на следующий день |
payment_method_restricted | Запрещены операции данным платежным средством (например, карта заблокирована из-за утери, кошелек — из-за взлома мошенниками). Пользователю следует обратиться в организацию, выпустившую платежное средство |
permission_revoked | Нельзя провести безакцептное списание: пользователь отозвал разрешение на автоплатежи. Если пользователь еще хочет оплатить, вам необходимо создать новый платеж, а пользователю — подтвердить оплату |
unsupported_mobile_operator | Нельзя заплатить с номера телефона этого мобильного оператора. При новой попытке оплаты пользователю следует использовать другое платежное средство. Список поддерживаемых операторов |
Пример объекта платежа в статусе canceled
{ "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": "100500", "gateway_id": "100700" }, "refundable": false, "test": false, "cancellation_details": { "party": "payment_network", "reason": "payment_method_restricted" } }
Вы можете протестировать отмену платежа с помощью тестовых банковских карт.
Коды ответа (состояния) HTTPПроведение платежейСпособы оплатыТестирование платежей