# Коды ошибок

# HTTP-коды ошибок

2xx: Success (успешно):

response_code description_ru description_en
200 Операция выполнена успешно OK
201 Операция выполнена успешно Created
202 Операция выполнена успешно Accepted

4xx: Client Error (ошибка клиента):

response_code description_ru description_en
400 Некорректный запрос. Проверьте параметры запроса и повторите попытку. Bad request
401 Ошибка авторизации. Проверьте авторизационные данные в запросе и повторите попытку. Unauthorized
402 Запрос не может быть выполнен до тех пор, пока клиент не совершит оплату Payment Required
403 Доступ к методу ограничен. Свяжитесь со службой поддержки. Forbidden
404 Метод не найден. Проверьте параметры запроса и повторите попытку. Not Found
405 Указанный метод не разрешен сервисом. Проверьте параметры запроса и повторите попытку. Method Not Allowed
408 Время ожидания истекло. Рекомендуем повторить попытку. Request Timeout
415 Неподдерживаемы формат. Проверьте параметры запроса и повторите попытку. Unsupported Media Type
429 Получено слишком много запросов. Повторите попытку позднее. Too Many Requests

5xx: Server Error (ошибка сервера):

response_code description_ru description_en
500 Внутренняя ошибка сервера. Свяжитесь со службой поддержки. Internal Server Error
502 Внутренняя ошибка сервера. Свяжитесь со службой поддержки. Bad Gateway
503 Сервис временно недоступен. Свяжитесь со службой поддержки. Service Unavailable
504 Внутренняя ошибка сервера. Свяжитесь со службой поддержки. Gateway Timeout

# Ошибки при запросах API

response_code description_ru description_en
401 Не указан merchant id для аутентификации запроса. Authentication error: Failed to get merchant id from token Basic Oj0w**********=
403 Запрос выполнен от саб мерчанта. Запрос необходимо выполнить от мастер-мерчанта. API requests for sub-merchants are not allowed. Please contact your account manager.
400 По указанному order id уже есть успешная выплата. Duplicate order id your_unique_order_id found for incomplete payout transaction
400 Не указан OrderID. Order id is missing
400 Некорректный запрос. Необходимо проверить отправляемый запрос или обратиться в службу технической поддержки. Internal server error
400 Данный тип запроса запрещен. Необходимо обратиться к менеджеру или в службу технической поддержки. API requests are forbidden. Please contact your account manager for details.
400 Для агентской схемы передан блок shipper. Необходимо удалить блок shipper и повторить запрос. Agent scheme disabled but you sent shipper information.Please remove shipper information from request or contact your account manager. , MerchantId: ****
403 Доступ закрыт/запрещен. Свяжитесь со службой поддержки. Для сервиса Роутинг ошибка означает, что запрос выполняется саб-мерчантом, необходимо повторить запрос от лица мастер-мерчанта. Forbidden
401 Ошибка аутентификации. Проверьте авторизационные данные. Authentication failed
400 Сумма должна соответствовать формату. Ошибка означает, что в запросе передана некорректная сумма, после разделителя не должно быть больше 2-х знаков. The amount must match the format: 123,45. Please round the amount to the nearest penny

# Ошибки в модулях No code

response_code Error description
666 Неизвесная ошибка. Ошибка может быть получена по разным причинам. Свяжитесь со службой поддержки.
406 UnknownResponse("unknown status response: {'RESULT': 'DECLINED', 'RESULT_PS': 'CANCELLED', '3DSECURE': 'SYSERROR') Операция отклонена платёжной системой на этапе проверки 3ds.
404 Доступ запрещен в связи с ограничением списка разрешенных пользователей. Ограничен доступ для работы с модулем. Для настройки прав доступа необходимо обратиться к руководителю компании. Подробнее про управление правами по ссылке (opens new window)
- Invalid phone format. Номер телефона введён некорректно.
- Order id is missing. Не указан order_id
- Транзакция уже существует. По указанному order_id уже существует операция. Для осуществления новой операции нужно указать уникальный order_id.
- Fiscal checks aren't configured for this merchant. Для проекта не настроены фискальные чеки. Свяжитесь со службой поддержки.

# Коды ответов платежных систем

Ниже собраны коды ошибок действующих банков-эмитентов и платежных систем.

response_code description_ru description_en
-32 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Re-declined transaction
-30 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Transaction was rejected as fraudulent
-29 Ошибка в прохождении 3D secure. Пожалуйста, обратитесь в службу поддержки. Error in authentication link (damaged or duplicated)
-28 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Error in additional data
-27 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Seller name error
-24 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Inconsistency in the context of a transaction
-23 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Error in transaction context
-22 Ошибка в прохождении 3D secure. Пожалуйста, обратитесь в службу поддержки. Transaction contains invalid authentication information
-20 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Expired transaction
-19 Ошибка в прохождении 3D secure. Пожалуйста, обратитесь в службу поддержки. Authentication failed
-18 Ошибка в CVV карты. Пожалуйста, проверьте данные и повторите операцию. Error in the CVC2 or CVC2 Description field of the request
-17 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Access denied
-15 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Error in the RRN field of the request
-14 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. No connection
-13 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. System error
-12 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Error in merchant terminal field
-10 Некорретная сумма операции. Пожалуйста, проверьте сумму и повторите операцию. Error in amount field
-9 Ошибка в сроке действия карты. Пожалуйста, проверьте данные и повторите операцию. Error in card expiration date field
-8 Ошибка в номере карты. Пожалуйста, проверьте данные и повторите операцию. Error in card number field
-7 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Incorrect response from the acquirer host
-6 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Configuration error
-5 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Connect failed
-4 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Server is not responding
-3 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. No or Invalid response received
-2 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Bad CGI request
-1 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Invalid transaction state
0 Операция выполнена успешно. Approved
1 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Call your bank
2 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Refer to card issuer, special condition
3 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Invalid merchant
4 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Your card is restricted
5 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Transaction declined
6 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Error
7 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Pickup card, special condition (other than lost/stolen card)
8 Ошибка в прохождении 3D secure. Пожалуйста, обратитесь в службу поддержки. Honor with identification
12 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Invalid transaction
13 Некорректная сумма операции. Пожалуйста, проверьте сумму и повторите операцию. Invalid amount
14 Операция отклонена. Некорректные данные карты, пожалуйста проверьте данные и повторите операцию. No such card
15 Операция отклонена. Некорректные данные карты, пожалуйста проверьте данные и повторите операцию. No such card/issuer
16 Операция выполнена успешно. Approved, update track 3
17 Операция отклонена по требованию владельца карты. Пожалуйста, свяжитесь с банком-эмитентом. Customer cancellation
18 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Customer dispute
20 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Invalid response
22 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Suspected malfunction
23 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Unacceptable transaction fee
24 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. File update not supported
25 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Unable to locate record
26 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Duplicate record
27 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. File update edit error
28 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. File update file locked
30 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Format error
31 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Bank not supported
33 Ошибка в сроке действия карты. Пожалуйста, свяжитесь с банком-эмитентом. Expired card, pick-up
34 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Issuer suspects fraud, pick-up card
35 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Contact acquirer, pick-up
36 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Restricted card, pick-up
37 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Call ECHO security, pick-up
38 Превышен лимит ввода ПИН-кода. Пожалуйста, свяжитесь с банком-эмитентом. PIN tries exceeded, pick-up
39 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. No credit account
40 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Function not supported
41 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Lost card
42 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. No universal account
43 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Stolen card
44 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. No investment account
51 Операция отклонена. Недостаточно средств для совершения операции. Not sufficient funds
52 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. No checking account
53 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. No savings account
54 Срок действия карты истек. Пожалуйста, обратитесь в банк-эмитент Expired card
56 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. No card record
57 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Transaction not permitted to cardholder
58 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Transaction not permitted on terminal
59 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Suspected fraud
60 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Contact ECHO
61 Превышен лимит операций. Пожалуйста, свяжитесь службой поддержки. Exceeds amount limit
62 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Restricted card
63 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Security violation
64 Некорретная сумма операции. Пожалуйста, проверьте сумму и повторите операцию. Original amount incorrect
65 Превышен лимит операций. Пожалуйста, обратитесь в службу поддержки Activity count limit exceeded
66 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Call acquirer security
68 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Response received too late
75 Превышен лимит ввода ПИН-кода. PIN tries exceeded
76 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Invalid to account
77 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Invalid from account
78 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Invalid account specified (general)
80 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Visa transactions: credit issuer unavailable
81 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. PIN cryptographic error found
82 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Time-out at issuer
83 Невозможно проверить ПИН-код Unable to verify PIN
84 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Invalid authorization life cycle
86 Невозможно проверить ПИН-код Unable to verify PIN
87 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Network Unavailable
88 Ошибка в CVV карты. Пожалуйста, проверьте данные и повторите операцию. Invalid CVC2
89 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Ineligible to receive financial position information
91 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Issuer unavailable
92 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Routing error
93 Операция отклонена. Пожалуйста, свяжитесь с банком-эмитентом. Violation of law
95 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. Reconcile error
96 Операция отклонена. Пожалуйста, свяжитесь службой поддержки. System malfunction
98 Превышен лимит операций. Пожалуйста, обратитесь в службу поддержки Exceeds cash limit

# Безусловно негативные коды ответов

Получение негативного кода ответа из данной группы не допускает повторной попытки совершения операций по карте. Для регулярных платежей (рекуррентов) необходимо установить ограничения на отправку повторных запросов на списание с карты - в случае, если были получены коды ответов из группы «Безусловно негативные», прекратить дальнейшие попытки списания средств с карты.

response_code description_en description_ru
03 Invalid merchant Операция отклонена из-за запрета выполнения операций в данной категории ТСП.
04 Capture card Операция отклонена из-за попытки использования постоянно заблокированной карты.
05 Do not honor Операция отклонена Эмитентом без объяснения причин.
12 Invalid transaction Операция отклонена из-за запрета выполнения операций данного типа.
15 Invalid issuer Операция отклонена из-за отсутствия у Эмитента карты в БИН-таблице.
33 Expired card, pick up Операция отклонена из-за попытки использования постоянно заблокированной карты при условии, что карта не утеряна и не украдена.
41 Lost card, pick up Операция отклонена из-за попытки использования утерянной карты.
43 Stolen card, pick up Операция отклонена из-за попытки использования украденной карты.
57 Transaction not permitted to issuer/cardholder Операция отклонена из-за ограничений на продукт карты.
58 Transaction not permitted to acquirer/terminal Операция отклонена из-за недопустимости выполнения Эквайером операций данного типа.
62 Restricted card Операция отклонена из-за ограничений на карту или счет Держателя карты.
76 Unable to locate previous message Операция отклонена из-за отсутствия оригинального запроса.
78 Invalid/nonexistent account specified Операция отклонена из-за попытки использования закрытой карты.
92 Unable to route transaction Операция отклонена из-за невозможности его маршрутизации получателю.
93 Transaction cannot be completed, violation of law Операция отклонена по причине нарушения требований законодательства.
94 Duplicate transmission detected Операция отклонена из-за задублированного запроса.

# Условно негативные коды ответов

Получение любого из кодов ответа этой группы допускает повторение попытки совершения операции по карте только при условии изменения одного или нескольких параметров операции, которые указаны в таблице.

response_code description_en description_ru
13 Invalid amount Некорректная сумма операции. Пожалуйста, проверьте сумму и повторите операцию.
14 No such card Некорректные данные карты (карта не существует, не активирована), пожалуйста проверьте данные и повторите операцию.
30 Format error Операция отклонена. Пожалуйста, свяжитесь службой поддержки для уточнения причин.
54 Expired card Срок действия карты истек. Пожалуйста, обратитесь в банк-эмитент.
63 Security violation Операция отклонена. Пожалуйста, свяжитесь службой поддержки для уточнения причин.