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.
Tip: Code 0 always means success. Any non-zero code indicates an error or a specific processing state.
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 |