Status Codes

Every order, payout, and P2P transaction carries a status code that provides detailed information about the reason for its current status. Status codes follow the format X-YY-ZZ:

X-YY-ZZ
│  │  └── Result code: specific outcome within the scenario.
│  └───── Scenario code: processing stage or scenario. See Scenario Codes below.
└──────── Source code: origin of the status. See Source Codes below.

Source Codes

Code	Source	Description
0	—	Global success (approve)
1	System	Status originated on the system side
2	Provider	Status originated on the payment provider side

Scenario Codes

The scenario code is shared across all sources. For example, 1-02-XX and 2-02-XX are both Request Validation, but on the System and Provider side respectively.

Code	Scenario
01	General statuses that cannot be tied to a specific scenario
02	Request validation
03	Payment method definition
04	3DS
05	Antifraud
06	Limits control
07	Payment processing
08	Payment participant actions (merchant, payer, recipient)
09	Card processing
10	Wallet errors
11	Payout processing
12	P2P transfer processing

note

Result code 99 is reserved for technical errors (e.g. unexpected internal error).

---

Success Code

statusCode	statusDescription	Resulting Order Status
0	Payment successfully processed (approve)	completed

This is the only code that does not follow the X-YY-ZZ format — it is represented as a single digit 0, not 0-00-00.

---

Status Codes in Responses and Callbacks

Status codes are returned as statusCode (with a human-readable statusDescription) in:

• Orders: Retrieve Order Details and Order Status Callback.
• Payouts: Retrieve Payout Status and Payout Status Callback.
• P2P transactions: Retrieve P2P Transaction Status and P2P Status Callback.

---

System Status Codes (1-XX-XX)

These codes indicate errors or declines that originated on the system side.

General Statuses (1-01-XX)

statusCode	statusDescription	Retry allowed
1-01-01	Gateway timeout	✅
1-01-02	The payment was automatically failed due to the expiration of the predefined timeout window set by the provider for completing the transaction or for the customer to submit the required payment method data	❌
1-01-03	The payment was cancelled due to the expiration of the timeout window for the merchant's customer to submit the required payment method data on the PSP payment page	❌
1-01-04	The order was moved to need_action due to a provider response timeout	❌
1-01-05	The payment was cancelled due to the expiration of the timeout window for obtaining the final payment status from the provider	❌
1-01-06	DNS resolution failed	✅
1-01-07	Payment gateway is temporarily unavailable	✅
1-01-99	General error	❌

Request Validation (1-02-XX)

statusCode	statusDescription	Retry allowed
1-02-01	Payout order creation via H2H is not configured	❌
1-02-02	Payment setting mismatch	❌
1-02-03	Required payment method fields are missing	❌
1-02-04	Missing customer identifier	❌
1-02-05	Missing saved payment method identifier	❌
1-02-06	Customer mismatch	❌
1-02-07	Required sender fields are missing	❌
1-02-08	Required recipient fields are missing	❌
1-02-10	Customer not found	❌
1-02-11	Order type mismatch	❌
1-02-12	Shop mismatch	❌
1-02-13	Missing shop identifier	❌
1-02-14	Only one of company or shop identifier should be specified	❌
1-02-15	Payment identifier is required to order a partial refund	❌
1-02-16	Card data submission is not permitted	❌

Payment Method Definition (1-03-XX)

statusCode	statusDescription	Retry allowed
1-03-01	No suitable payment method found for the provided parameters	❌
1-03-02	No routing rules found for order parameters	❌
1-03-03	No cascading rules found for order parameters	❌
1-03-04	No payment settings were found for the provided alias	❌
1-03-05	Too many payment settings were found with requested alias	❌
1-03-06	The provided order parameters do not match the payment settings alias	❌
1-03-07	Routing resolved a routing rule, but it does not contain any active payment settings	❌
1-03-08	Routing resolved a routing rule, but active payment settings in this rule have exceeded their limits	❌
1-03-09	Routing resolved a routing rule, but the payment settings in this rule have no scores assigned	❌
1-03-10	Payment settings selection by routing is not enabled	❌
1-03-11	No payment settings were found after routing, and the system is configured not to use fallback to the payment page	❌
1-03-12	No payment settings found on retry and cascading is disabled	❌
1-03-13	Required routing parameters are missing and collection on payment page is disabled	❌
1-03-14	No payment settings were found after routing	❌

Antifraud (1-05-XX)

statusCode	statusDescription	Retry allowed
1-05-01	Declined by timeout after antifraud decision "review"	❌
1-05-02	Declined by merchant after antifraud decision "review"	❌

Payment Processing (1-07-XX)

statusCode	statusDescription	Retry allowed
1-07-01	Missing required parameters for the selected payment method	✅
1-07-02	The provided currency value is not supported by the payment settings	✅
1-07-03	The provided dataEntryMode value is not supported by the payment settings	✅
1-07-04	The payment settings contain several data entry modes, but none were provided in the request	✅
1-07-05	Payment setting is disabled	✅
1-07-06	The provided amount is not allowed by the payment settings	✅
1-07-08	The payer must be over 18 years old	✅
1-07-09	The provided payer country is not supported by the payment settings	✅
1-07-10	The provided MCC is not supported by the payment settings	✅
1-07-11	The customerId is required for a saved payment method	✅
1-07-12	The savedPaymentMethodId is required for a saved payment method	✅
1-07-13	Required payment setting parameter failed validation	✅
1-07-14	Exceeds the balance limits for operation	❌
1-07-15	Exceeds the balance limits for shop/MID	❌
1-07-16	The order has no payments available for capture	❌
1-07-17	The order has no payments available for cancel	❌
1-07-18	The order has no payments available for reject	❌
1-07-19	Current order status does not match the expected status for update	❌
1-07-20	Order status transition from the current status to the requested status is not allowed	❌
1-07-21	The order is in an invalid state	❌
1-07-22	Entry mode is not set for card payment settings	❌
1-07-23	More than one default payment type is configured for the shop with the requested instrument type	❌
1-07-24	No default payment types are configured for the shop with the requested instrument type	❌
1-07-25	All payment attempts have been exhausted	❌
1-07-26	Payment retries are not allowed due to the status code of the last payment. All remaining retry attempts have been canceled	❌
1-07-27	Missing required parameters for the selected payment method and data collection on payment page is disabled	❌
1-07-28	No bank transfer codes found for the payer's country	❌

Payment Participant Actions (1-08-XX)

statusCode	statusDescription	Retry allowed
1-08-01	Cancelled by merchant	❌
1-08-02	Cancelled by merchant's customer	❌

---

Provider Status Codes (2-XX-XX)

These codes indicate errors or declines that originated on the payment provider side.

General Statuses (2-01-XX)

statusCode	statusDescription	Retry allowed
2-01-01	General decline	✅
2-01-02	The operation was timed out by the provider	✅
2-01-03	The provider returned a validation error because the payment amount does not match the required amount multiple	✅
2-01-04	Authorization failed	✅
2-01-99	Unknown internal error by the provider	✅

Request Validation (2-02-XX)

statusCode	statusDescription	Retry allowed
2-02-01	Bad request by the provider	✅
2-02-02	Unauthorized by the provider	✅
2-02-03	Transaction not found	❌
2-02-04	Invalid amount input	✅
2-02-05	General validation error	✅
2-02-06	Duplicate request	❌
2-02-07	Invalid amount or currency	✅
2-02-08	The payer must be over 18 years old	✅
2-02-09	Wrong request. Invalid parameter format	✅
2-02-11	Merchant not found	✅
2-02-12	Terminal not found	✅
2-02-13	Invalid payment token	✅
2-02-14	Payment routing configuration not found	✅
2-02-15	IP address is not whitelisted	✅
2-02-16	Transaction amount below minimum limit	✅
2-02-17	Transaction amount above maximum limit	✅
2-02-18	Provider service temporary unavailable	✅
2-02-19	One or more fields have invalid data format	✅
2-02-20	One or more required parameters are missing	✅
2-02-21	Request validation failed	✅
2-02-22	Invalid request	✅
2-02-23	Invalid Credentials	—
2-02-24	Authorization header not found	✅
2-02-25	Invalid signature	✅
2-02-26	Expired payment token	✅
2-02-27	Insufficient permissions	✅
2-02-28	Invalid bank account	✅
2-02-29	Transaction amount below minimum limit or above maximum limit	❌
2-02-30	Transaction already exists	❌
2-02-31	The merchant account is disabled	❌
2-02-32	Invalid authorization header	✅
2-02-33	Signature type is not a supported algorithm	✅
2-02-34	Access token not found	✅
2-02-35	Daily transaction count limit exceeded	✅
2-02-36	Daily rejected transaction count limit exceeded	✅
2-02-37	Transaction expired	❌
2-02-38	Invalid currency	❌
2-02-39	Duplicate transaction	❌
2-02-40	Invalid Transaction	❌
2-02-41	Email already used by another beneficiary	❌
2-02-42	Phone already used by another beneficiary	❌

Payment Method Definition (2-03-XX)

statusCode	statusDescription	Retry allowed
2-03-01	Payment setting is disabled	❌
2-03-02	Method not allowed	✅

3DS Checks (2-04-XX)

statusCode	statusDescription	Retry allowed
2-04-01	3DS general timeout	✅
2-04-03	3DS failed	✅
2-04-04	3DS authentication cancelled or abandoned	✅
2-04-05	3DS authentication failed	✅

Antifraud (2-05-XX)

statusCode	statusDescription	Retry allowed
2-05-01	General fraud suspect	✅
2-05-02	Compliance limitation	✅
2-05-03	The amount limit has been exceeded	✅
2-05-04	Email is in the blacklist	✅
2-05-05	IP is in the blacklist	✅
2-05-06	Cardholder is in the blacklist	✅
2-05-07	Billing country is in the blacklist	✅
2-05-08	Billing account is suspended	✅
2-05-09	Security violation	✅
2-05-10	Customer in blacklist	✅
2-05-11	Risk assessment timeout	✅
2-05-12	Card number is in blacklist	❌
2-05-13	No eligible disbursement channel available	❌
2-05-14	Declined by Risk Check	✅
2-05-15	Customer in blacklist by provider	✅
2-05-16	Declined due to blacklisted attributes	✅
2-05-17	Declined by email risk	✅
2-05-18	Customer in greylist	✅
2-05-19	Declined by credit card risk	✅
2-05-20	Rejected due to regulatory reasons	❌
2-05-21	Rejected due to international sanction lists	❌
2-05-22	Rejected due to national sanction list	❌
2-05-23	Rejected after KYC check	✅
2-05-24	Invalid document	❌
2-05-25	Rejected due to Politically Exposed Person (PEP)	❌
2-05-26	High risk detected	❌
2-05-27	Failed biometric check	✅
2-05-28	Failed OTP verification	✅

Limits Control (2-06-XX)

statusCode	statusDescription	Retry allowed
2-06-01	Provider limit on the total amount of transactions has been exceeded	✅
2-06-02	Merchant processing limit reached	✅
2-06-03	Customer operation limit exceeded	✅
2-06-04	Beneficiary limit exceeded	✅

Payment Processing (2-07-XX)

statusCode	statusDescription	Retry allowed
2-07-01	Declined by external provider	✅
2-07-02	Insufficient funds on the payer's account	✅
2-07-03	Cardholder limit exceeded	✅
2-07-04	Received a callback from the provider with a different payment amount and (or) currency	❌
2-07-05	Transaction rejected by provider	✅
2-07-06	Transaction declined by issuer	✅
2-07-07	Transaction blocked by issuer	✅
2-07-08	Issuer unavailable	✅
2-07-09	Currency is not supported	❌
2-07-10	One or more parameters are invalid	❌
2-07-11	The value of one or more parameters is invalid	❌
2-07-12	Unsupported payment method	❌
2-07-13	Bank country restricted	❌
2-07-14	Acquirer Malfunction	✅
2-07-15	Deposit request expired. Create a new deposit request	❌
2-07-16	No eligible payment channel available	✅
2-07-17	External service communication error	✅
2-07-18	Country is not supported	✅
2-07-19	Transaction limit exceeded	✅
2-07-20	Payment instruments limit exceeded	✅
2-07-21	Processing Error	✅

Payment Participant Actions (2-08-XX)

statusCode	statusDescription	Retry allowed
2-08-01	Cancelled by merchant's customer	❌
2-08-02	Timeout occurred while waiting for the merchant's customer to confirm the required data on the provider's page	❌
2-08-03	The user did not complete the payment	❌
2-08-04	Rejected by merchant's request	❌

Card Processing (2-09-XX)

statusCode	statusDescription	Retry allowed
2-09-01	Invalid card number	❌
2-09-02	Invalid expiry date	❌
2-09-03	Invalid card security code	❌
2-09-04	Expired card	❌
2-09-05	Card lost/stolen	❌
2-09-06	Card BIN is blocked	❌
2-09-07	Unsupported BIN	❌
2-09-08	Unsupported card scheme	❌
2-09-09	The provider could not find a card scheme for the provided BIN value	❌
2-09-10	Card country is not supported	❌
2-09-11	Card country restricted	❌
2-09-12	Issuer limits are reached	✅
2-09-13	Transaction not permitted for cardholder	❌
2-09-14	Card is blocked or inactive	❌
2-09-15	Unsupported card	❌
2-09-16	PIN attempt limit exceeded	❌

Wallet Errors (2-10-XX)

statusCode	statusDescription	Retry allowed
2-10-01	Invalid wallet ID	❌

Payout Processing (2-11-XX)

For the codes in this group, the Retry allowed column indicates whether a payout retry is allowed.

statusCode	statusDescription	Retry allowed
2-11-01	Insufficient funds on the external provider's account	✅
2-11-02	Insufficient funds on the merchants's account	✅
2-11-03	Customer account not registered	❌
2-11-04	Beneficiary name doesn't match bank details	❌
2-11-05	Withdrawal expired	❌
2-11-06	Rejected by bank	❌
2-11-07	Bank account blocked	❌