Перейти к содержимому

Коды ошибок

Полный справочник кодов ошибок API АТОЛ Pay Ecom - общие ошибки, регистрация, отмена, вторая стадия и фискализация.

Ошибки возвращаются в едином формате:

json
{
  "errorCode": "PAYMENT_NOT_FOUND",
  "errorMessage": "Платеж не найден",
  "status": "error"
}

Общие

Код ошибкиЗначение
USER_NOT_FOUNDПользователь не найден
PERMISSION_DENIEDНет доступа
BANK_SETTINGS_NOT_FOUNDБанковские настройки не найдены
CARD_NOT_FOUNDКарта пользователя не найдена
INVALID_ORDER_IDНе указан идентификатор платежа
PAYMENT_NOT_FOUNDПлатеж не найден
ORDER_NOT_FOUNDЗаказ не найден - так эту же ситуацию называет само API (см. Callout ниже)
PAYMENT_PROCESSEDПлатеж с таким номером уже обработан
AUTH_ERRORОшибка авторизации. Неверный токен (HTTP 403)
NO_AUTH_DATAОтсутствуют данные для входа: заголовок Authorization не распознан - например, токен передан без префикса Bearer (HTTP 412)
PAYMENT_SETTINGS_NOT_FOUNDНе заданы настройки оплаты в личном кабинете АТОЛ Pay (раздел Настройки > Настройки заказов)
SERVER_ERRORОшибка обработки запроса на стороне сервиса (HTTP 400, из OpenAPI-спецификации)
SERVICE_IS_UNAVAILABLEСервис временно недоступен (HTTP 500, из OpenAPI-спецификации) - повторите запрос позже

API называет часть кодов иначе, чем документ-источник

Таблицы на этой странице собраны по документу «Интеграция c API АТОЛ Pay Ecom». Проверка реальными запросами к тестовому контуру croc-sandbox-api-mobile.atolpay.ru показала, что для тех же ситуаций API возвращает другие названия кодов:

СитуацияКод в документеКод от API (подтвержден запросом)
Заказ не найденPAYMENT_NOT_FOUNDORDER_NOT_FOUND
Заказ с таким номером уже существуетPAYMENT_EXISTSORDER_EXISTS
Токен не распознан-NO_AUTH_DATA

Оба набора названий оставлены в таблицах намеренно: какой именно код придет, зависит от контура и версии сервиса. Сравнивайте errorCode со списком допустимых значений и предусматривайте ветку для неизвестного кода - не рассчитывайте на одно ожидаемое название.

Регистрация платежа (POST /payments)

Код ошибкиЗначение
PAYMENT_EXISTSТакой заказ уже существует
ORDER_EXISTSЗаказ с таким номером уже существует - так эту же ситуацию называет само API. Повторный POST /payments с занятым orderId отклоняется, дубль заказа не создается
UNEXPECTED_REGISTER_PAYMENT_ERRORНеизвестная ошибка регистрации заказа
INVALID_RECEIPT_AMOUNTСумма платежа отличается от суммы по позициям

Отмена/возврат (POST /cancel, callback отмены и возврата)

Код ошибкиЗначение
INVALID_CANCEL_ACTIONТип отмены не определен
CANCEL_ALREADY_MADEПлатеж уже отменен
CANCEL_IS_NOT_POSSIBLEОтмена платежа невозможна
FULL_REFUND_IS_NOT_POSSIBLEПолный возврат невозможен: часть платежа уже была возвращена
WRONG_REFUND_AMOUNTСумма возврата превышает сумму оплаты
PARTIAL_REFUND_IS_NOT_POSSIBLEЧастичный возврат невозможен на первой стадии двухстадийного платежа
UNEXPECTED_CANCEL_PAYMENT_ERRORНеизвестная ошибка отмены платежа
PARENT_RECEIPT_NOT_FOUNDРодительский чек не найден
EMPTY_REFUND_RECEIPT_POSITIONSОтсутствуют позиции возврата
EMPTY_REFUND_RECEIPT_AMOUNTОтсутствует сумма возврата
INVALID_REFUND_RECEIPT_AMOUNTСумма возврата отличается от суммы по позициям
INVALID_POSITION_PARENT_ITEM_IDНекорректный родитель позиции
INVALID_POSITION_AMOUNTНекорректная сумма позиции
INVALID_POSITION_QUANTITYКоличество товара позиции превышает остаток
UNSUPPORTED_RECEIPT_TYPEНекорректный тип чека
DUPLICATE_POSITION_PARENT_ITEM_IDНайдены одинаковые позиции возврата

Callback оплаты

Код ошибкиЗначение
UNEXPECTED_PAY_PAYMENT_ERRORНеизвестная ошибка оплаты
UNEXPECTED_PAY_PAYMENT_3DS2_ERRORНеизвестная ошибка оплаты 3DS 2.0
UNEXPECTED_COMPLETE_PAYMENT_ERRORНеизвестная ошибка завершения оплаты
UNEXPECTED_COMPLETE_PAYMENT_3DS2_ERRORНеизвестная ошибка завершения оплаты 3DS 2.0
PROCESSING_ERRORОшибка процессинга (например, errorMessage: "Ошибка 3-D Secure авторизации.")
PAYMENT_DECLINEDБанк отклонил оплату; причина - текстом в errorMessage (например, «Недостаточно средств на карте»)

Коды PROCESSING_ERROR и PAYMENT_DECLINED встречаются в примерах callback документа «Интеграция c API АТОЛ Pay Ecom», но отсутствуют в его сводной таблице кодов ошибок. Обрабатывайте errorCode в callback устойчиво к неизвестным значениям.

Вторая стадия (POST /deposit, callback второй стадии)

Код ошибкиЗначение
DEPOSIT_IS_NOT_POSSIBLEСписание средств невозможно
UNEXPECTED_DEPOSIT_PAYMENT_ERRORНеизвестная ошибка проведения второй стадии платежа

Callback фискализации

Код ошибкиЗначение
SEND_RECEIPT_ERRORОшибка отправки чека в провайдер фискализации
SEND_REFUND_RECEIPT_ERRORОшибка отправки чека возврата в провайдер фискализации
CHECK_RECEIPT_STATUS_RESPONSE_ERRORЧек доставлен в провайдер фискализации, но провайдер ответил ошибочным статусом
CHECK_RECEIPT_STATUS_WAIT_ERRORНе удалось дождаться результата отправки чека
CHECK_RECEIPT_STATUS_UNKNOWN_ERRORНеожиданная ошибка получения статуса чека