Ошибки API¶
Ошибки API описывают причину отклонения операции и передаются:
- в ответах на запросы — в поле
status.reason; - в уведомлениях — в поле
status.reasonCode.
Некоторые ошибки API сопровождаются детализацией ошибки и рекомендованными действиями, полученными от платёжной системы в поле status.psErrorCode.
| Ошибка API | Описание |
|---|---|
| INVALID_STATE | Некорректный статус транзакции |
| INVALID_AMOUNT | Некорректная сумма |
| INVALID_RECEIVER_DATA | Ошибка при передаче данных о получателе |
| DECLINED_BY_MPI | Отклонено MPI |
| DECLINED_BY_FRAUD | Отклонено fraud-мониторингом |
| REATTEMPT_NOT_PERMITTED | Повторный запрос авторизации запрещен на основании правил Платёжной системы |
| REATTEMPT_NOT_PERMITTED_BY_PS | Операция отклонена платёжной системой. Детализация ошибки содержится в поле status.psErrorCode. По данной карте повторная операция невозможна |
| GATEWAY_INTEGRATION_ERROR | Ошибка взаимодействия с банком |
| GATEWAY_TECHNICAL_ERROR | Техническая ошибка на стороне банка |
| ACQUIRING_MPI_TECH_ERROR | Техническая ошибка при проведении 3DS аутентификации |
| ACQUIRING_GATEWAY_TECH_ERROR | Техническая ошибка |
| ACQUIRING_ACQUIRER_ERROR | Техническая ошибка |
| ACQUIRING_AUTH_TECHNICAL_ERROR | Ошибка при проведении авторизации средств |
| ACQUIRING_ISSUER_NOT_AVAILABLE | Ошибка эмитента. Банк-эмитент недоступен |
| ACQUIRING_SUSPECTED_FRAUD | Ошибка эмитента. Подозрение на мошенничество |
| ACQUIRING_LIMIT_EXCEEDED | Ошибка эмитента. Превышен один из лимитов |
| ACQUIRING_NOT_PERMITTED | Ошибка эмитента. Операция не разрешена |
| ACQUIRING_INCORRECT_CVV | Ошибка эмитента. Некорректный CVV |
| ACQUIRING_EXPIRED_CARD | Ошибка эмитента. Неверный срок действия карты |
| ACQUIRING_INVALID_CARD | Ошибка эмитента. Проверьте корректность введенных данных |
| ACQUIRING_INSUFFICIENT_FUNDS | Ошибка эмитента. Недостаточно средств |
| ACQUIRING_UNKNOWN | Неизвестная ошибка |
| BILL_ALREADY_PAID | Счёт уже оплачен |
| PAYIN_PROCESSING_ERROR | Ошибка при проведении платежа |
| PAYMENT_EXPIRED_3DS | Не пройдена 3DS-аутентификация |
| TRY_AGAIN_LATER | Повторите запрос через некоторое время |
Справочник кодов детализации ошибки¶
Коды детализации ошибки и рекомендованных действий, полученные от платёжной системы, возвращаются в поле status.psErrorCode.
| Код | Ошибка API, с которой возвращается | Детализация причины ошибки и рекомендация по ее устранению |
|---|---|---|
| 03 | REATTEMPT_NOT_PERMITTED_BY_PS | Операция в данную категорию ТСП запрещена эмитентом |
| 04 | REATTEMPT_NOT_PERMITTED_BY_PS | Карта заблокирована |
| 05 | ACQUIRING_NOT_PERMITTED | Отклонение запроса по иным причинам |
| 12 | REATTEMPT_NOT_PERMITTED_BY_PS | Операция данного типа запрещена Правилами и Стандартами платёжной системой |
| 13 | ACQUIRING_NOT_PERMITTED | Некорректная сумма. Повторите попытку совершения операции с другой суммой |
| 14 | ACQUIRING_NOT_PERMITTED | Некорректный номер карты. Введите корректный номер карты или используйте другую карту |
| 15 | REATTEMPT_NOT_PERMITTED_BY_PS | Эмитента с данной картой не существует |
| 30 | ACQUIRING_NOT_PERMITTED | Операция отклонена, обратитесь в Qiwi за дополнительной информацией |
| 33 | REATTEMPT_NOT_PERMITTED_BY_PS | Данная карта недоступна для использования |
| 41 | REATTEMPT_NOT_PERMITTED_BY_PS | Данная карта недоступна для использования |
| 43 | REATTEMPT_NOT_PERMITTED_BY_PS | Данная карта недоступна для использования |
| 51 | ACQUIRING_INSUFFICIENT_FUNDS | Клиенту может быть рекомендовано повторить попытку совершения операции после пополнения счёта |
| 54 | ACQUIRING_EXPIRED_CARD | Срок действия карты отсутствует или передан неверно |
| 57 | REATTEMPT_NOT_PERMITTED_BY_PS | Операция данного типа недоступна для карты |
| 58 | REATTEMPT_NOT_PERMITTED_BY_PS | Операция данного типа недоступна для эквайера |
| 61 | ACQUIRING_LIMIT_EXCEEDED | Клиенту может быть рекомендовано повторить попытку совершения операции в другой день — после переустановки Эмитентом лимита по общей сумме операций данного типа |
| 62 | REATTEMPT_NOT_PERMITTED_BY_PS | Операция недоступна из-за ограничений на карте или счёте Держателя карты |
| 63 | ACQUIRING_NOT_PERMITTED | Операция отклонена, обратитесь в Qiwi за дополнительной информацией |
| 65 | ACQUIRING_LIMIT_EXCEEDED | Клиенту может быть рекомендовано повторить попытку совершения операции в другой день — после переустановки Эмитентом лимита по общему количеству операций данного типа |
| 75 | ACQUIRING_INCORRECT_CVV | Отклонение запроса по причине неверного ввода PIN-кода ранее |
| 76 | REATTEMPT_NOT_PERMITTED_BY_PS | Отклонение отмены запроса из-за отсутствия оригинального запроса |
| 78 | REATTEMPT_NOT_PERMITTED_BY_PS | Отклонение запроса из-за попытки использования закрытой карты |
| 86 | ACQUIRING_INCORRECT_CVV | Отклонение запроса по причине неверного ввода PIN-кода ранее |
| 88 | ACQUIRING_AUTH_TECHNICAL_ERROR | Отклонение запроса из-за ошибки криптографии, может возникнуть из-за неправильного CVV2/CVC2 |
| 91 | ACQUIRING_ISSUER_NOT_AVAILABLE | Клиенту может быть рекомендовано повторить попытку совершения операции в другое время — после восстановления работоспособности Эмитента |
| 92 | REATTEMPT_NOT_PERMITTED_BY_PS | Отклонение Платёжной Системой из-за невозможности проведения операции |
| 93 | REATTEMPT_NOT_PERMITTED_BY_PS | Отклонение запроса по причине нарушения требований законодательства |
| 94 | REATTEMPT_NOT_PERMITTED_BY_PS | Отклонение задублированного запроса |
| 96 | ACQUIRING_NOT_PERMITTED | Клиенту может быть рекомендовано повторить попытку совершения операции в другое время — после восстановления работоспособности Эмитента или Платформы |
| TS | REATTEMPT_NOT_PERMITTED_BY_PS | Отклонение запроса в связи с отменой длительного поручения Держателя карты |
| CB | ACQUIRING_ACQUIRER_ERROR | Отклонение запроса из-за некорректной даты рождения Держателя карты |
| CD | REATTEMPT_NOT_PERMITTED_BY_PS | Отклонение запроса по причине смерти Держателя карты |
Правила работы с детализированной информацией¶
Существуют две группы кодов ошибок:
- Группа 1:
03,04,12,15,33,41,43,57,58,62,76,78,92,93,94,CD,TS,05. - Группа 2:
13,14,30,54,51,61,63,65,75,86,88,91,96,CB.
По правилам НСПК действуют следующие условия совершения повторов транзакций с non-3DS авторизацией по картам платёжной системы МИР:
- После ответа из группы 1 проводить транзакции больше нельзя в течение суток.
- После ответа из группы 2 разрешается ещё одна попытка проведения транзакций в течение суток.
Ограничения применяются в отношении конечного получателя, в случае если нами были получены соответствующие коды ответа.
Общие HTTP-коды ошибок¶
Протокол приёма платежей использует для запросов 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 — Сервер временно недоступен по техническим причинам, попробуйте позже |