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

---

Коды ошибок

---

Протокол приема платежей использует для запросов 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	Неизвестная ошибка