Ошибки

Введение

Верификация без предъявления карты использует стандартные коды ответов HTTP для обозначения успеха или неудачи запроса к API.

Общее правило таково:

• Коды в диапазоне 2xx означают успешное выполнение запроса.
• Коды в диапазоне 4xx означают некорректные или неполные параметры (например, был пропущен обязательный параметр, или произошёл сбой при взаимодействии с третьими сторонами и т. д.).
• Коды в диапазоне 5xx означают ошибку на серверах продукта Верификации без предъявления карты.

Верификация без предъявления карты также генерирует сообщение об ошибке и код ошибки в формате JSON:

{
    "error": {
        "code": "40004",
        "description": "transaction id is invalid"
    }
}

Возможные ошибки

В этом разделе вы найдёте возможные ошибки для эндпоинтов, сгруппированные по их HTTP-ответу.

Создание транзакции

HTTP-код	Код	Описание	Причина
400	40001	error decoding json	Отправленные данные не соответствуют контракту сервиса.
400	40002	error validating json	Некоторая информация некорректно отформатирована или отсутствует.
400	40021	invalid phone	Указанный номер телефона недействителен, он должен соответствовать формату: 55 DDD НОМЕР. Например: 5543999999999.
400	40022	invalid email	Указанный email недействителен.
400	40027	replicated transaction	Отправленная транзакция уже существует и не может быть создана повторно.
400	40045	max value reached	Когда значение транзакции превышает допустимый лимит.
403	40301	not allowed	У пользователя нет прав для выполнения этого действия.
404	40404	company not found	Указанная компания не существует.
429	40001	too many requests	Достигнут лимит частоты запросов.
500	50001	internal error	Внутренний сбой сервиса.

Получение статуса транзакции

HTTP-код	Код	Описание	Причина
400	40001	error decoding json	Отправленные данные не соответствуют контракту сервиса.
400	40002	error validating json	Некоторая информация некорректно отформатирована или отсутствует.
400	40004	transaction id is invalid	Идентификатор транзакции недействителен (по формату).
400	40301	not allowed	У пользователя нет прав для выполнения этого действия.
429	40401	transaction not found	Транзакция не найдена.
500	50001	internal error	Внутренний сбой сервиса.

Получение доказательного набора транзакции

HTTP-код	Код	Описание	Причина
400	40004	transaction id is invalid	Идентификатор транзакции недействителен (по формату).
400	40009	transaction status is invalid	Статус транзакции недействителен (не допускается для формирования доказательного набора).
403	40301	not allowed	У пользователя нет прав для выполнения этого действия.
404	40401	transaction not found	Транзакция не найдена.
500	50001	internal error	Внутренний сбой сервиса.

Повторная отправка уведомления о транзакции

HTTP-код	Код	Описание	Причина
400	40001	error decoding json	Отправленные данные не соответствуют контракту сервиса.
400	40002	error validating json	Некоторая информация некорректно отформатирована или не была заполнена.
400	40004	transaction id is invalid	Идентификатор транзакции недействителен (по формату).
400	40009	transaction status is invalid	Статус транзакции не допускает повторную отправку уведомления (процесс уже завершён).
400	40021	invalid phone	Указанный номер телефона недействителен, он должен соответствовать формату: 55 DDD НОМЕР. Например: 5543999999999.
400	40022	invalid email	Указанный email недействителен.
403	40301	not allowed	У пользователя нет прав для выполнения этого действия.
404	40401	transaction not found	Транзакция не найдена.
429	40001	too many requests	Достигнут лимит частоты запросов.
500	50001	internal error	Достигнут лимит частоты запросов.

Onboarding кредитной карты

HTTP-код	Код	Описание	Причина
400	40001	error decoding json	Отправленные данные не соответствуют контракту сервиса.
400	40002	error validating json	Некоторая информация некорректно отформатирована или отсутствует.
400	40027	replicated transaction	Отправленная транзакция уже существует и не может быть создана повторно.
400	40030	invalid identity	CPF, указанный в запросе, отличается от CPF, связанного с указанным processID.
400	40045	max value reached	Когда транзакция превышает допустимую сумму.
400	40054	processID is invalid	Когда processID, указанный в запросе, недействителен (или не существует).
400	40055	processID is expired	Когда используемый processID слишком устарел.
403	40301	not allowed	У пользователя нет прав для выполнения этого действия.
404	40404	company not found	Указанная компания не существует.
404	40410	processID not found	Когда указанный процесс не существует.
404	40412	image not found	Когда у процесса, указанного пользователем, нет изображения.
429	40001	too many requests	Достигнут лимит частоты запросов.
429	42901	too many requests	Когда клиент отправляет слишком много запросов, превышая заранее установленный лимит.
500	50001	internal error	Внутренний сбой сервиса.