Коды ошибок (отказы)
В колбеке и ответе статуса поле status_code передаётся всегда. Это целое число — код детализации на стороне процессинга или банка.
Обрабатывайте status_code только при ошибке (status = 4, status_description = FAILURE). При успешном платеже приходит дефолтное значение 0 — его можно игнорировать.
Расшифровка кодов — в таблице ниже.
Ошибки запроса к API (
error_codeв HTTP 400) — в разделе Коды ошибок (API).
Справочник status_code
| Код | Что означает | Что делать |
|---|---|---|
0 | Дефолтный код (ошибок нет). При FAILURE может также означать, что причина отказа не определена. | При успехе — игнорируйте. При отказе уточните у менеджера 1Payment (order_id, время операции). |
1 | Подозрение во фроде. | Не повторяйте массово; свяжитесь с поддержкой. |
2 | Таймаут. | Предложите клиенту повторить оплату. |
3 | Внутренняя ошибка процессинга. | Повторите операцию позже. |
4 | Неверный номер карты. | Проверьте реквизиты; другая карта. |
5 | Неверный номер телефона. | Проверьте номер в запросе. |
6 | Недостаточно средств. | Другая карта или пополнение счёта. |
7 | Не пройдена 3-D Secure. | Повторите оплату с аутентификацией. |
8 | Превышен суточный лимит по каналу. | Повторите позже или другой канал. |
9 | Превышен лимит по номеру карты. | Другая карта или позже. |
10 | Карта просрочена. | Другая карта. |
11 | Отказ эмитента. | Клиенту — в банк; предложите другой способ оплаты. |
12 | Неверный cvc. | Проверьте CVC/CVV. |
13 | Неверный card_holder. | Проверьте имя держателя карты. |
14 | Оплата этой картой недоступна. | Другая карта или способ оплаты. |
15 | Аннулирование: клиент отказался от подписки. | При необходимости — новая попытка привязки. |
См. также Статусы транзакций.