Status Codes
Possible transaction statuses
| Status | Description | Final status (Y/N) |
|---|---|---|
| SUCCESS | The transaction has been completed successfully | Y |
| ERROR | The transaction has been completed failed | Y |
| EXPIRED | The redirect URL has been expired | Y |
| REDIRECTED_TO_3DS | The user is expected to be redirected to the 3DSV page | N |
| REFUNDED | The refund process has been completed successfully | Y |
| CHARGEBACK | The chargeback process has been completed successfully | Y |
| PENDING_PAYMENT | The transaction has been authorized but not yet processed | N |
Instant Payment Notification possible statuses
| messagetype | Status | Description |
|---|---|---|
| acquirerRes | succeeded | The transaction has been completed successfully |
| acquirerRes | failed | The transaction has been completed failed |
| transactionRefund | refund_pending | The refund process is pending |
| transactionRefund | refunded | The refund process has been completed successfully |
| transactionRefund | error | The refund process has been completed failed |
Payment Error Messages
| Message |
|---|
| Generic Decline |
| This country is not supported |
| Insufficient funds |
| Payment failed |
| Transaction rejected |
| Invalid transaction |
| Trying to refund more amount than captured |
| Timed out |
| Limit violation |
| Card restricted |
| Invalid cvv |
| Invalid card status |
| Invalid phone number |
| Card expired |
| Authorization denied |
| 3DS verification error |
| Invalid card number |
| Suspected fraud |
| Card validation failed |
| 3D authentication failed |
| Transaction expired |
| Declined by issuing bank |
| Customer or card is blacklisted |
| Card doesn't support 3DS |
| Invalid country |
| Timeout |
| Card is not enrolled to 3-D |
| Invalid zip code |
| Invalid firstname |
| Not allowed card brand |
| Customer is banned |
| Currency not allowed |
| High risk transaction |
| Invalid card |
| Invalid lastname |
| Invalid customer data |
| Exceeds withdrawal limit |
| Security violation |
| Bad Request |
| Unauthenticated |
| Customer is suspended |
| Invalid format |
| Stolen card |
| Unsupported card |
Error Codes (synchronous requests)
| Code | Error Message |
|---|---|
0000 | Ip is not whitelisted |
0001 | Forbiden |
0002 | The system is temporarily unavailable. Please try again later |
1000 | Unauthorized |
1001 | Reference no is required |
1002 | Invalid merchant data |
1003 | Invalid card number |
1004 | Card type is blocked |
1005 | Card bin is blocked |
1006 | Card country is blocked |
1007 | ThreeDS error |
1008 | Merchant not found |
1009 | Provision request failure |
1010 | Provision not found |
1011 | Provision date has expired |
1012 | Transaction not found |
1013 | No available mid configuration |
1014 | 3DS data not found |
1015 | Cardholder not enrolled in service |
1017 | Transaction refund error |
1018 | Exchange error |
1019 | Transaction id is required |
1020 | Production environment is not activated |
1021 | This error occurs when trying to purchase. Details of the error will be in the body of the response |
1022 | Same reference number used before |
1023 | Same reference number used before |
1024 | Sent hash is not match with server calculated hash |
1026 | You are currently unable to make a purchase |
1027 | The customer's country and the card's country mismatch |
1028 | Velocity rules violation |
1029 | Refund is not possible for this transaction |
1030 | Please get in touch with us for the refund of this transaction |
1031 | The customer is blocked |
1032 | Invalid request body |
1033 | Suspected fraud |
1034 | Invalid customer data |
Success Codes (synchronous requests)
| Code | Message |
|---|---|
2002 | The purchase request has succeeded |
2003 | The provision request has succeeded |
2004 | The transaction status request has succeeded |
2005 | The transaction redund request has succeeded |
2006 | Password updated successfully |