Статусы и типы операций, коды ошибок
Коды ошибок
Протокол приема платежей использует для запросов API следующие HTTP-коды ошибок:
| Коды ошибки | Описание |
|---|---|
| 400 | Bad Request — Ваш запрос некорректен (ошибка в данных или в формате запроса). |
| 401 | Unauthorized — Неправильный ключ доступа к API. |
| 403 | Forbidden — Доступ к API запрещен. |
| 404 | Not Found — Указанный ресурс не найден. |
| 405 | Method Not Allowed — Для создания платежа использовался неправильный метод. |
| 406 | Not Acceptable — Формат данных отличается от JSON. |
| 410 | Gone — Запрашиваемый ресурс удален. |
| 429 | Too Many Requests — Слишком много запросов. |
| 500 | Internal Server Error — Внутренняя ошибка сервиса. Если тело ответа пустое, повторите запрос с теми же параметрами. Если тело ответа не пустое, выполните запрос статуса платежа или статуса счета. |
| 502 | Bad Gateway — Нет связи с сервисом. |
| 503 | Service Unavailable — Сервер временно недоступен по техническим причинам, попробуйте позже. |
Типы операций
Тип операции возвращается в поле {operation}.type уведомления.
| Тип операции | Описание |
|---|---|
| PAYMENT | Платеж. В уведомлении может присутствовать поле flag: [ "SALE" ] (одношаговый платёж) или flag: [ "AUTH" ] (платеж с холдированием средств). |
| CAPTURE | Операция подтверждения. |
| REFUND | Операция возврата. |
Статусы серверных уведомлений
В уведомлениях статус помещается в поле {operation}.status.value.
В таблице перечислены возможные типы операций, в которых эти статусы используются.
| Статус операции | Тип операции | Описание статуса |
|---|---|---|
| SUCCESS | PAYMENT | Успешность платежа |
| DECLINE | PAYMENT | Запрос авторизации отклонен |
| SUCCESS | CAPTURE | Успешность подтверждения |
| DECLINE | CAPTURE | Неуспешное подтверждение |
| SUCCESS | REFUND | Успешность отмены/возврата |
| DECLINE | REFUND | Неуспешная отмена/возврат |
Статусы операций
Статус операции отражает ее текущее состояние.
API возвращает синхронный статус операции в поле status.value.
В таблице перечислены возможные статусы и типы операций, в которых эти статусы используются.
| Статус операции | Тип операции | Описание статуса |
|---|---|---|
| CREATED | INVOICE | Инвойс создан |
| PAID | INVOICE | Инвойс оплачен |
| SUCCESS | PAYMENT | Успешность платежа |
| DECLINE | PAYMENT | Запрос авторизации отклонен |
| SUCCESS | CAPTURE | Успешность подтверждения |
| DECLINE | CAPTURE | Неуспешное подтверждение |
| SUCCESS | REFUND | Успешность отмены/возврата |
| DECLINE | REFUND | Неуспешная отмена/возврат |
Справочник ошибок 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 | Неизвестная ошибка |