Коды ошибок Платежного сервиса

Формат сообщений об ошибках

Платежный сервис возвращает как свои собственные ошибки, так и ошибки банков. Информация об ошибке передается в полях errorCode и errorMessage.

Критерием определения принадлежности ошибки (Платежный сервис или банк) является код ошибки errorCode:

Буквенно-цифровой код формата АА-000 — ошибки Платежного сервиса. Пример:
```
{
    "errorCode": "VR-209",
    "errorMessage": "amount is a required parameter"
}
```
Значения в другом формате — ошибки платежного шлюза конкретного банка. Платежный сервис транслирует коды ошибок от платежного шлюза банка Партнеру без изменения. Формат значений при этом зависит от конкретного банка.
```
{
    "errorCode": "8",
    "errorMessage": "Card data is incorrect"
}
```

Значение errorCode=0 говорит о том, что выполнение операции прошло без технических ошибок (сбоев) и в Платежном сервисе, и в банке. Однако, это не гарантирует того, что операция в банке выполнена успешно.

Процессинг банка во многих случаях возвращает свой собственный код исполнения операции, значение которого включается в ответ Платежного сервиса в параметре actionCode и может говорить о том, что запрошенная операция не выполнена процессингом банка, даже если errorCode=0. Коды ответов процессингового центра (actionCode) см. здесь.

Ошибки Платежного сервиса

Точный текст ошибки не приводится, поскольку может быть изменен без предварительного уведомления. Для анализа следует использовать код ошибки — он уникален для каждой причины.

Буквенный код обозначает тип ошибки.

BD — ошибки связок

HTTP код	Код ошибки	Тип данных	Описание	Возможные причины
400	BD-101	String	Связка не найдена по известному `bindingId` (при оплате связкой, деактивации связки и т.п.).	В запросе указан неверный `bindingId` или `clientId`. Временно недоступен сервис хранения связок для банка, которому принадлежит связка.
200	BD-102	String	В ответе на запрос `getBindings.do` список связок может быть неполным, так как возникли ошибки при получении связок как минимум из одного банка	Временно недоступен сервис связок в одном или нескольких банках
200	BD-103	String	В ответе на запрос `getBindings.do` поля `bankName` и `paymentSystem` могут быть пустыми или содержать некорректное значение, так как соответствующий сервис не вернул данных по картам.	Временно недоступен сервис данных по картам
200	BD-104	String	При сборе списка связок возникли ошибки BD-102 и BD-103, т.е. и список связок может быть неполным, и поля могут быть некорректны	Временно недоступен сервис связок в одном или нескольких банках и одновременно недоступен сервис данных по картам
424	BD-105	String	Некорректный формат передачи идентификатора связки `bindingId`	В идентификаторе связки не указана принадлежность банку
424	BD-120	String	Ошибка деактивации связки	При деактивации связки в банке, банк не вернул подтверждение успешного выполнения операции (timeout, failure и т.д.)
424	BD-201	String	СБП связка (подписка) не найдена по переданному `bindingId` (деактивация СБП подписки).	В запросе указан неверный `bindingId`. Временно недоступен сервис хранения связок для банка, которому принадлежит связка.

MD — ошибки получения данных по заказу

HTTP код	Код ошибки	Тип данных	Описание	Возможные причины
200 или 400	MD-101	String	Заказ не найден в Платежном сервисе. HTTP код 200 возвращается в ответе на запрос `getOrderStatusExtended.do`, в остальных случаях - 400	В запросе указан неверный `orderNumber` или `mdOrder` заказа
424	MD-102	String	Заказ не найден в банке. Платежному сервису известен банк и идентификатор заказа в банке, но при запросе информации из банка банк сообщает, что такого заказа не существует	Ошибка в данных Платежного сервиса о местонахождении заказа
424	MD-103	String	Не удалось получить статус заказа из банка	В настоящий момент банк недоступен Ошибка в данных Платежного сервиса о местонахождении заказа
400	MD-105	String	При выполнении операции с заказом (возврат, отмена) не указан идентификатор заказа	В запросе не указаны ни `orderNumber` ни `mdOrder` заказа
424	MD-202	String	Заказ уже существует в банке, и был создан не Платежным сервисом. Оплата через Платежный сервис не допускается.	Заказ был создан напрямую в банке в обход Платежного сервиса
424	MD-204	String	Ошибка получения данных о заказе из шлюза Платежного сервиса	Ошибка в Платежном сервисе Проблемы с доступом к шлюзу Платежного сервиса

PM — ошибки в процессе оплаты заказа

HTTP код	Код ошибки	Тип данных	Описание	Возможные причины
424	PM-101	String	Не удалось определить способ оплаты (карта, связка, seToken и т.п.)	Ошибка в Платежном сервисе
400	PM-102	String	Для указанных параметров платежа (сумма, карта, способ оплаты и т.д.) запрещено выполнять оплату	В настройках маршрутизации имеется правило, запрещающие принимать оплату с такими параметрами
424	PM-110	String	Невозможно установить блокировку заказа перед началом оплаты	Ошибка при взаимодействии с БД Платежного сервиса
424	PM-111	String	Невозможно снять блокировку с заказа после окончания оплаты	Ошибка при взаимодействии с БД Платежного сервиса
424	PM-112	String	Заказ заблокирован другой операцией	Попытка выполнить операцию с заказом в то время, как заказ заблокирован другой операцией.
424	PM-121	String	Оплата в банк (рассрочка или рекуррент) завершилась неудачей	Некорректные данные заказа (например, дублирующийся номер заказа) Отказ процессинга в проведении транзакции
424	PM-122	String	Оплата в банк (`instantPayment`) завершилась неудачей	Некорректные данные заказа (например, дублирующийся номер заказа) Отказ процессинга в проведении транзакции
424	PM-131	String	Не удалось конвертировать исходную валюту заказа в целевую для выбранного банка	Некорректные настройки конвертации в Платежном сервисе Сервис конвертации временно недоступен

RC - ошибки взаимодействия с внешними сервисами

HTTP код	Код ошибки	Тип данных	Описание	Возможные причины
424	RC-101	String	Ответ от внешнего сервиса содержит ошибку в теле ответа, но без кода ошибка этого сервиса	Некорректный запрос Платежного сервиса во внешний сервис Ошибка в самом сервисе
424	RC-201	String	Не удалось отправить запрос во внешний сервис	Сетевая недоступность сервиса Ошибка SSL сертификата
424	RC-202	String	Таймаут при вызове внешнего сервиса	Ответ на запрос не получен в течение времени ожидания ответа
424	RC-203	String	Неожиданный ответ внешнего сервиса	Тело ответа не является валидным JSON
424	RC-211	String	Не удалось отправить запрос в платежный шлюз банка	Сетевая недоступность банка Ошибка SSL сертификата
424	RC-212	String	Таймаут при вызове платежного шлюза банка	Ответ на запрос не получен в течение времени ожидания ответа
424	RC-213	String	Неожиданный ответ платежного шлюза банка	Тело ответа не является валидным JSON
424	RC-221	String	Не удалось отправить запрос в шлюз Платежного сервиса	Сетевая недоступность банка Ошибка SSL сертификата
424	RC-222	String	Таймаут при вызове платежного шлюза Платежного сервиса	Ответ на запрос не получен в течение времени ожидания ответа
424	RC-223	String	Неожиданный ответ платежного шлюза Платежного сервиса	Тело ответа не является валидным JSON
424	RC-231	String	Не удалось отправить запрос в платежный шлюз банка	Сетевая недоступность банка Ошибка SSL сертификата
424	RC-232	String	Таймаут при вызове платежного шлюза банка	Ответ на запрос не получен в течение времени ожидания ответа
424	RC-233	String	Неожиданный ответ платежного шлюза банка	Тело ответа не является валидным JSON

RI - ошибки при использовании платежного шлюза банка

HTTP код	Код ошибки	Тип данных	Описание	Возможные причины
424	RI-151	String	Не удалось получить токен доступа к шлюзу	Сетевая недоступность банка Некорректные настройки Партнера в Платежном сервисе
424	RI-152	String	Ошибка создания платежной криптограммы	Некорректные настройки Партнера в Платежном сервисе Отсутствует необходимый ключ шифрования
424	RI-201	String	Результат платежа (редирект) не получен от банка	Некорректные данные платежного запроса из Платежного сервиса в банк Сетевая недоступность банка
424	RI-202	String	В Платежном сервисе отсутствует внутренний идентификатор заказа банка	При попытке оплатить заказ банк отклонил запрос как невалидный и не создал заказ на своей стороне.

RO — ошибки при маршрутизации

HTTP код	Код ошибки	Тип данных	Описание	Возможные причины
424	RO-101	String	Недоступен сервис аутентификации Партнера	Платежный сервис временно деактивировал все банки, доступные Партнеру (из-за сетевой недоступности, превышения порога ошибок и т.п.)
424	RO-102	String	По правилам маршрутизации не удалось определить целевой шлюз	Ошибка в настройках маршрутизации
400	RO-201	String	Вызываемый API-метод Платежного сервиса подразумевает, что заказ уже должен быть в каком-либо банке, однако заказ еще не поступил ни в один банк	Попытка возврата или отмены по заказу, который не ушел ни в один банк
424	RO-202	String	Не удалось зарегистрировать заказ в банке, доступном для данного способа оплаты, и нет альтернатив.	Платежный сервис временно деактивировал все банки, доступные Партнеру (из-за сетевой недоступности, превышения порога ошибок и т.п.) Для оплаты доступен только один банк (без альтернатив), и регистрация заказа в нем завершилась ошибкой

RT — внутренние ошибки во время исполнения

Ошибки с кодом RT-xxx являются внутренними системными ошибками Платежного сервиса (перехваченными исключениями, exceptions). Полный перечень не приводится.

Текст всех ошибок RT-xxx: System error. Please contact support if the issue persists
Причина таких ошибок как правило техническая, например, некорректная конфигурация, отсутствие необходимых конфигурационных данных, ошибки на уровне БД, и т.п.

ST - ошибки в конфигурации

HTTP код	Код ошибки	Тип данных	Описание	Возможные причины
424	ST-101	String	Ошибка получения настроек Платежного сервиса	Ошибка конфигурирования самого Платежного сервиса
424	ST-201	String	Партнер не зарегистрирован в Платежном сервисе	Ошибка конфигурирования Партнера в Платежном сервисе
424	ST-203	String	В настройках Партнера отсутствуют необходимые параметры	Ошибка конфигурирования Партнера в Платежном сервисе
424	ST-212	String	Для модуля BNPL отсутствуют необходимые параметры	Ошибка конфигурирования самого Платежного сервиса
424	ST-301	String	Ошибка получения настроек банка	Ошибка конфигурирования банка в Платежном сервисе
424	ST-401	String	В настройках Партнера отсутствуют необходимые параметры	Ошибка конфигурирования Партнера в Платежном сервисе

VP — ошибки, связанные с vendor pays

HTTP код	Код ошибки	Тип данных	Описание	Возможные причины
424	VP-201	String	Ошибка T-Pay - не удалось зарегистрировать заказ для оплаты по T-Pay	Недоступность сервисов банка
424	VP-202	String	Ошибка T-Pay - не удалось получить ссылку на QR-код	Недоступность сервисов банка
424	VP-203	String	Ошибка T-Pay - не удалось отменить QR-код	Недоступность сервисов банка
424	VP-211	String	Ошибка Yandex PayBox - не удалось зарегистрировать заказ для оплаты по Yandex PayBox	Недоступность сервисов банка
424	VP-212	String	Ошибка Yandex PayBox - не удалось получить платежную ссылку	Недоступность сервисов банка
400	VP-251	String	QR-код (при оплате по СБП) еще не зарегистрирован	Попытка вызвать статус или отмену СБП QR-кода до того как он был зарегистрирован
424	VP-301	String	Ошибка MirPay - ссылка не была получена от банка	Недоступность сервисов банка Ошибка конфигурирования Партнера в банке

VR — ошибки валидации входящих запросов

HTTP код	Код ошибки	Тип данных	Описание	Возможные причины
400	VR-101	String	Ошибка аутентификации - неверный логин или пароль	Неверный логин или пароль
400	VR-102	String	Не валидный JSON в теле запроса	Не валидный JSON в теле запроса
400	VR-110	String	Заказ с таким номером уже зарегистрирован	Попытка повторной регистрации заказа с тем же самым orderNumber
400	VR-201	String	При регистрации указан способ оплаты, который не поддерживается в Платежном сервисе	Неверное указание допустимых способов оплаты
400	VR-202	String	Инициирующий рекуррентный платеж (с `tii=RI`) должен иметь доп. параметры `recurringFrequency` и `recurringExpiry`	Отсутствуют обязательные параметры запроса
400	VR-203	String	Инициирующий рекуррентный платеж (с `tii=RI`) должен иметь непустой `clientId`	Отсутствуют обязательные параметры запроса
400	VR-204	String	Инициирующая рассрочка (с `tii=II`) должна иметь доп. параметры `installments`, `recurringFrequency` и `recurringExpiry`	Отсутствуют обязательные параметры запроса
400	VR-205	String	Инициирующая рассрочка (с `tii=II`) должна иметь непустой `clientId`	Отсутствуют обязательные параметры запроса
400	VR-206	String	Оба параметра `recurringFrequency` и `recurringExpiry` необходимы в запросе	Отсутствуют обязательные параметры запроса
400	VR-207	String	Инициирующий рекуррентный платеж или рассрочка должен иметь непустой `clientId` (для случая когда tii не передавался явно)	Отсутствуют обязательные параметры запроса
400	VR-208	String	При использовании `feature VERIFY` необходимо указание `clientId`	Отсутствуют обязательные параметры запроса
400	VR-209	String	{имя поля} является обязательным	Отсутствуют обязательные параметры запроса
400	VR-210	String	Ошибки формальной валидации параметров запроса	Недопустимое значение переданных параметров Неверный тип/формат переданных параметров
400	VR-211	String	При использовании специального логина Партнера для привязки карт необходимо указание `clientId`	Отсутствуют обязательные параметры запроса
400	VR-212	String	При использовании фичи `FORCE_CREATE_BINDING` необходимо указание `clientId`	Отсутствуют обязательные параметры запроса
400	VR-215	String	В запросе указана валюта, недоступная Партнеру ни в одном банке	Ошибка при указании валюты Ошибка конфигурирования Партнера
400	VR-221	String	На момент выполнения запроса время жизни заказа уже истекло, операции над заказом не допускаются	Долгий период времени между регистрацией и оплатой заказа При регистрации указан слишком короткое время жизни заказа
400	VR-222	String	Заказ был явно отменен, операции над заказом не допускаются	Попытка выполнить операцию над заказом в статусе `DECLINED`
400	VR-223	String	Заказ уже был обработан. Повторные запросы оплаты по этому заказу не принимаются	Попытка повторно оплатить уже оплаченный заказ
400	VR-230	String	Некорректные данные в поле `orderBundle.orderCreationDate`	Неверный формат даты или дата в будущем
400	VR-231	String	Некорректные данные в блоке `orderBundle.customerDetails`	Одно или несколько обязательных полей в блоке `customerDetails` отсутствует или заполнено неверно
400	VR-232	String	Некорректные данные в блоке `orderBundle.customerDetails.deliveryInfo`	Одно или несколько обязательных полей в блоке `customerDetails.deliveryInfo` отсутствует или заполнено неверно
400	VR-233	String	Некорректные данные в блоке `orderBundle.cartItems.items`	Одно или несколько обязательных полей в блоке `orderBundle.cartItems.items` отсутствует или заполнено неверно
400	VR-234	String	`itemAmount` должно быть равно произведению `itemPrice` на количество	Значение `itemAmount` не совпадает с произведением `itemPrice` x `quantity`
400	VR-235	String	Сумма заказа должна быть равна сумме стоимости всех позиций	Стоимость всех позиций заказа не совпадает с суммой заказа
400	VR-236	String	Некорректные данные в `orderBundle.cartItems.items.itemAttributes`	Одно или несколько обязательных полей в блоке `orderBundle.cartItems.items.itemAttributes` отсутствует или заполнено неверно
400	VR-242	String	При регистрации заказа с `bindingId` указание `clientId` обязательно	Отсутствуют обязательные параметры запроса
400	VR-244	String	При регистрации заказа допускается указывать либо `bindingId` либо `defaultBindingId`, но не оба	При регистрации заказа указаны оба параметра `bindingId` и `defaultBindingId`. Необходимо указать что-то одно.
400	VR-245	String	Некорректный тип связки при оплате заказа. Эта связка не может использоваться для оплаты e-com заказа	При оплате e-com заказа используется `recurrent` или `installment` связка
400	VR-246	String	Некорректный тип связки при оплате заказа. Эта связка не может использоваться для рекуррентной оплаты	При рекуррентной оплате используется не рекуррентная связка
400	VR-261	String	Доп. параметры `back2app` and `app2app` не должны использоваться одновременно	Некорректное значение переданных параметров
400	VR-264	String	Недопустимое значение доп. параметра `app.osType`	Некорректное значение переданных параметров
400	VR-265	String	Недопустимое значение доп. параметра `app.deepLink`	Некорректное значение переданных параметров
400	VR-271	String	Недопустимое значение доп. параметра `yandex_paymentWay`	Некорректное значение переданных параметров
400	VR-275	String	Целевой банк для оплаты указан некорректно	Некорректное значение переданных параметров Ошибка конфигурирования Партнера
400	VR-306	String	Заказ с таким номером уже обработан	Попытка выполнить повторный вызов `instantPayment.do` с тем же самым номером заказа `orderNumber` или `instantPayment.do` c номером заказа, который был ранее зарегистрирован в Платежном сервисе
400	VR-307	String	Заказ с таким номером уже обработан	Попытка выполнить повторный `recurrentPayment.do` с тем же самым номером заказа или `recurrentPayment.do` c номером заказа, который был ранее зарегистрирован в Платежном сервисе
424	VR-330	String	Отсутствуют активные ключи для дешифрации SeToken	Ошибка конфигурации Платежного сервиса
400	VR-331	String	Ни один ключ в Платежном сервисе не смог дешифровать SeToken	Партнер использует неверный ключ
400	VR-332 ... VR-337	String	Ошибки валидации содержания seToken. Причина уточняется в тексте ошибки.	Содержимое токена некорректно.
400	VR-351	String	Ошибка проверки подписи запроса. Пустое тело запроса	Отсутствует тело запроса.
400	VR-352	String	Ошибка проверки подписи запроса. Пустой заголовок X-Hash	Отсутствует хэш тела запроса
400	VR-353	String	Ошибка проверки подписи запроса. Неправильный хэш в заголовке X-Hash	Хэш запроса сгенерирован неправильно или передан в неверной кодировке. Передавайте хэш в кодировке base64.
400	VR-354	String	Ошибка проверки подписи запроса. Пустой заголовок X-Signature	Отсутствует подпись запроса
400	VR-355	String	Ошибка проверки подписи запроса. Неправильная подпись	Подпись запроса сформирована неверно
424	VR-356	String	Отсутствуют активные ключи для проверки подписи	Ошибка конфигурации Платежного сервиса
400	VR-357	String	Ошибки проверки подписи запроса - подпись не закодирована корректно в base64	Подпись закодирована некорректно
400	VR-990	String	Generic ошибка в запросе (без уточнения причины)	Конкретная ошибка еще не получила индивидуального кода