# Error codes

# HTTP error codes

2xx: Success (successfully):

response_code description status
200 Operation completed successfully OK
201 Operation completed successfully Created
202 Operation completed successfully Accepted

4xx: Client Error:

response_code description error
400 Invalid request. Please check your request parameters and try again. Bad request
401 Authorisation Error. Check the authorization information in the request and try again. Unauthorized
402 The request cannot be completed until the client makes payment Payment Required
403 Access to the method is limited. Contact support. Forbidden
404 Method not found. Please check your request parameters and try again. Not Found
405 The specified method is not allowed by the service. Please check your request parameters and try again. Method Not Allowed
408 The waiting time has expired. We recommend that you try again. Request Timeout
415 Format not supported. Please check your request parameters and try again. Unsupported Media Type
429 Too many requests received. Please try again later. Too Many Requests

5xx: Server Error:

response_code description error
500 Internal Server Error. Contact support. Internal Server Error
502 Internal Server Error. Contact support. Bad Gateway
503 Service is temporarily unavailable. Contact support. Service Unavailable
504 Internal Server Error. Contact support. Gateway Timeout

# Errors with API requests

response_code description error
401 Merchant id was not specified to authenticate the request. Authentication error: Failed to get merchant id from token Basic Oj0w*********=
403 The request was fulfilled by a sub-merchant. The request must be completed by the master merchant. API requests for sub-merchants are not allowed. Please contact your account manager.
400 There is already a successful payment for the specified order id. Duplicate order id your_unique_order_id found for incomplete payout transaction
400 OrderID not specified. Order id is missing
400 Invalid request. You need to check the request you are sending or contact technical support. Internal server error
400 This type of request is prohibited. You need to contact your manager or technical support service. API requests are forbidden. Please contact your account manager for details.
400 The shipper block has been transferred for the agent scheme. You need to delete the shipper block and repeat the request. Agent scheme disabled but you sent shipper information.Please remove shipper information from request or contact your account manager. , MerchantId: ****
403 Access denied/denied. Contact support. For the Routing service, an error means that the request is being executed by a sub-merchant; you must repeat the request on behalf of the master merchant. Forbidden
401 Authentication error. Check your credentials. Authentication failed
400 The amount must match the format. The error means that an incorrect amount was sent in the request; there should not be more than 2 characters after the separator. The amount must match the format: 123,45. Please round the amount to the nearest penny

# Errors in modules No code

response_code Error description
666 Unknown error. The error can be received for various reasons. You need to contact technical support.
406 UnknownResponse("unknown status response: {'RESULT': 'DECLINED', 'RESULT_PS': 'CANCELLED', '3DSECURE': 'SYSERROR') The operation was rejected by the payment system at the 3ds verification stage.
404 Access is denied due to restrictions on the list of allowed users. Access to work with the module is limited. To set up access rights, you must contact the head of the company. Read more about rights management at the link (opens new window)
- Invalid phone format. The phone number was entered incorrectly.
- Order id is missing. order_id not specified
- The transaction already exists. An operation already exists for the specified order_id. To carry out a new operation, you need to specify a unique order_id.
- Fiscal checks aren't configured for this merchant. Fiscal receipts are not configured for the project. You need to contact technical support.

# Payment system response codes

Below are the error codes of existing issuing banks and payment systems.

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

# Definitely negative response codes

Receiving a negative response code from this group does not allow a second attempt to perform card transactions. For regular payments (recurring), it is necessary to set restrictions on sending repeated requests for debiting from the card - if response codes from the “Unconditionally Negative” group were received, stop further attempts to debit funds from the card.

response_code description_en
3 Invalid merchant
4 Card is restricted
5 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