Error Codes

This page lists all error codes returned by the ApiPro API. Each response includes a numeric code field indicating the result of the operation. Use this reference to handle errors programmatically in your integration.

General Errors

System-level errors related to internal processing, authorization, and request validation.

Code	Reason	Description
0	Ok	Request completed without errors
1	General internal error	Unexpected error occurred
2	Internal transport timeout	Internal timeout occurred. Try again later
5	Access denied	You are not able to perform this action
10	Authorization error	Error occurred while authorization performing
11	Invalid authorization signature	Invalid signature or invalid / inactive API secret
30	Invalid params	We are unable to process the request due to incorrect or missing params. Check API documentation.
31	Missing required params	We are unable to process the request due to incorrect or missing params. Check API documentation.
35	Resource not found	The requested resource is undefined

Transaction Errors

Errors related to transaction processing, routing, and lifecycle management.

Code	Reason	Description
100	Transaction queued	The requested transaction is in queue
101	Transaction not found	The requested transaction is undefined
105	Transaction expired	Transaction timeout expired
108	Duplicated transaction	Transaction request with the same information has already been submitted
115	Refund not possible	Unable to process the refund
120	Blocked routing	No route available for payment lightning
121	Route is invalid	An issue has been detected in the routing settings. For instance, it could be due to a disabled project or bank

Processing Errors

Errors occurring during payment processing, bank communication, and 3D Secure authentication.

Code	Reason	Description
200	Transaction processing error	An unexpected internal processing error occurred
210	Bank connection error	The bank is not available. Connection error occurred
211	Bank connection timeout	Request timeout expired while establishing connection with the bank
212	Processing timeout	Request timeout expired while waiting for the bank response
213	3D Secure failed	The cardholder hasn't entered their details correctly

Risk & Compliance

Declines triggered by anti-fraud and risk management systems.

Code	Reason	Description
451	General risk decline	General risk decline. Project scope
452	General risk decline	General risk decline. System scope

Account Errors

Errors related to insufficient funds on the merchant account or payment intentions.

Code	Reason	Description
500	Insufficient funds on account	Your Project's account doesn't have enough funds for the transaction
620	Payment intention expired	Payment intention timeout expired

Bank-Side Errors

Errors returned by the acquiring bank or card issuer during transaction processing.

General Bank Errors

Code	Reason	Description
1000	Bank internal error	Internal error occurred
1001	General bank decline	General bank decline
1002	Duplicated transaction on bank	Transaction with the specified parameters already exists
1003	Undefined transaction on bank	Transaction was not found on the bank side
1005	Transaction expired on bank	Transaction expired on the bank side

Card & Payment Validation

Code	Reason	Description
1020	Insufficient funds on the card	There are insufficient funds on the user card to make the payment
1021	Invalid amount	The amount passed in the payment request is not supported or invalid. Please check API documentation
1022	Invalid currency	The currency passed in the payment request is not supported or invalid. Please check API documentation
1023	Invalid CVV	The credit card CVV was entered incorrectly
1024	Invalid PAN	The credit card information was entered incorrectly or the credit card is invalid

Customer Data Validation

Code	Reason	Description
1030	Invalid or absent customer email	Invalid or absent customer email
1031	Invalid or absent customer phone	Invalid or absent customer phone
1032	Invalid or absent customer country	Invalid or absent customer country
1033	Invalid or absent customer state code	Invalid or absent customer state code
1034	Invalid or absent customer city	Invalid or absent customer city
1035	Invalid or absent customer address	Invalid or absent customer address
1036	Invalid or absent customer zip code	Invalid or absent customer zip code
1037	Invalid or absent customer first name	Invalid or absent customer first name
1038	Invalid or absent customer last name	Invalid or absent customer last name
1039	Invalid or absent customer middle name	Invalid or absent customer middle name

Bank Feature Support

Code	Reason	Description
1050	Bank does not support transaction	The requested operation is not supported by the bank
1051	Bank not supports currency	The currency is not supported for this type of transaction. Please contact technical support
1052	Bank not supports country	The country code is not supported for this type of transaction. Please contact technical support
1053	Bank not supports card type	The card type that is being used has not been set up to support this type of transaction. Please contact technical support
1054	Bank not supports payment method	The payment method that is being used has not been set up. Please contact technical support

Card Status & Limits

Code	Reason	Description
1110	Card lost or stolen	Transaction declined due to card had been lost or stolen
1111	Card expired	Transaction declined due to card had expired
1112	Card limit exceeded	Contact financial institution to increase online payment limits or try different card
1113	Transaction not permitted for card	Transaction cannot be performed for this card
1114	Decline by issuer	The card issuer stopped the transaction
1120	Insufficient funds on the card	The card does not have enough funds to cover the order
1121	Insufficient funds on the bank account	The card does not have enough funds to cover the order

Refunds & Limits

Code	Reason	Description
1130	Refund not possible	Unable to make a Refund due to a reason on the Bank's side
1131	Refund limit exceeded	Unable to make a Refund due to insufficient funds on the card
1132	Limit exceeded	You have exceeded the maximum transaction limit set by the Bank

3D Secure (Bank-Side)

Code	Reason	Description
1140	3D Secure failed	The client could not pass the 3DS authentication for some reason
1141	3D Secure expired	The client did not pass the 3DS authentication within the deadline

Bank Risk

Code	Reason	Description
1200	Risk decline by bank	Transaction is declined by Bank's Antifraud system