Skip to main content

Статусы и типы операций, коды ошибок

Коды ошибок​

Протокол приема платежей использует для запросов API следующие HTTP-коды ошибок:

Коды ошибкиОписание
400Bad Request — Ваш запрос некорректен (ошибка в данных или в формате запроса).
401Unauthorized — Неправильный ключ доступа к API.
403Forbidden — Доступ к API запрещен.
404Not Found — Указанный ресурс не найден.
405Method Not Allowed — Для создания платежа использовался неправильный метод.
406Not Acceptable — Формат данных отличается от JSON.
410Gone — Запрашиваемый ресурс удален.
429Too Many Requests — Слишком много запросов.
500Internal Server Error — Внутренняя ошибка сервиса. Если тело ответа пустое, повторите запрос с теми же параметрами. Если тело ответа не пустое, выполните запрос статуса платежа или статуса счета.
502Bad Gateway — Нет связи с сервисом.
503Service Unavailable — Сервер временно недоступен по техническим причинам, попробуйте позже.

Типы операций​

Тип операции возвращается в поле {operation}.type уведомления.

Тип операцииОписание
PAYMENTПлатеж. В уведомлении может присутствовать поле flag: [ "SALE" ] (одношаговый платёж) или flag: [ "AUTH" ] (платеж с холдированием средств).
CAPTUREОперация подтверждения.
REFUNDОперация возврата.

Статусы серверных уведомлений​

В уведомлениях статус помещается в поле {operation}.status.value.

В таблице перечислены возможные типы операций, в которых эти статусы используются.

Статус операцииТип операцииОписание статуса
SUCCESSPAYMENTУспешность платежа
DECLINEPAYMENTЗапрос авторизации отклонен
SUCCESSCAPTUREУспешность подтверждения
DECLINECAPTUREНеуспешное подтверждение
SUCCESSREFUNDУспешность отмены/возврата
DECLINEREFUNDНеуспешная отмена/возврат

Статусы операций​

Статус операции отражает ее текущее состояние.

API возвращает синхронный статус операции в поле status.value.

В таблице перечислены возможные статусы и типы операций, в которых эти статусы используются.

Статус операцииТип операцииОписание статуса
CREATEDINVOICEИнвойс создан
PAIDINVOICEИнвойс оплачен
SUCCESSPAYMENTУспешность платежа
DECLINEPAYMENTЗапрос авторизации отклонен
SUCCESSCAPTUREУспешность подтверждения
DECLINECAPTUREНеуспешное подтверждение
SUCCESSREFUNDУспешность отмены/возврата
DECLINEREFUNDНеуспешная отмена/возврат

Справочник ошибок API​

Ошибки API описывают причину отклонения операции и передаются:

  • в ответах на запросы — в поле status.reason;
  • в уведомлениях — в поле status.reasonCode.
Ошибка APIОписание
VALIDATION_INVALID_CURRENCYВалюта не найдена
VALIDATION_INVALID_AMOUNTНекорректная сумма
VALIDATION_INVALID_URLНекорректный URL
VALIDATION_INVALID_INVOICE_UIDНекорректный номер счета
INVOICE_ALREADY_PAIDСчет уже оплачен
INVALID_STATEСчет просрочен
INVOICE_CLIENT_COMMISSION_CHANGEDОшибка в коммиссии
INVALID_CAPTURE_REQUESTОшибка во входящем запросе подтверждении платежа(CAPTURE)
INVALID_REFUND_REQUESTОшибка во входящем запросе возврате платежа(REFUND)
ACQUIRING_VALIDATION_ERRORОшибка в валидции
ACQUIRING_ACQUIRER_ERRORВнутренняя ошибка
ACQUIRING_NOT_PERMITTEDЗапрос запрещен в эквайринг
ACQUIRING_DECLINED_MPIДля мерчанта запрещены запросы в эквайринг
ACQUIRING_INVALID_REQUEST_DATAОшибка во входящем запросе
ACQUIRING_PROXY_3DS_ERRORОшибка в 3-D Secure прокси
ACQUIRING_INSUFFICIENT_FUNDSНет суммы для оплаты
ACQUIRING_LIMIT_EXCEEDEDПревышен лимит суммы для оплаты
ACQUIRING_SUSPECTED_FRAUDТранзакция запрещена по террористическим домыслам
ACQUIRING_EXPIRED_CARDКарта просрочена
ACQUIRING_INVALID_CARDКарта не действительна
ACQUIRING_ISSUER_NOT_AVAILABLEЭмитент недоступен
ACQUIRING_GATEWAY_TECH_ERRORТехнические ошибка в шлюзе
VALIDATION_INVALID_SITE_SIGN_HMACОшибка в валидации Signature
SITE_NOT_FOUNDСайт не найден
GATEWAY_NOT_FOUNDШлюз не найден
PAYMETHOD_NOT_FOUNDМетод оплаты не найден
PAYMENT_NOT_FOUNDПлатеж не найден
PAYMENT_EXPIRED_WAIT_APPROVEВремя ожидания подтверждения платежа просрочен
DENY_PAY_BY_TOKENЗапрещена оплата по платежному токену
UNKNOWN_ERRORНеизвестная ошибка