HTTP Status and Case Code
Successful responses are indicated with a 200-series HTTP code and a JSON-based payload containing the object(s) requested, created, modified, or deleted along with an expression of the server’s interpretation of your request.
Error responses are served with a non-200-series HTTP code. Different error and case codes indicate different reasons for an error.
1. Virtual Account
HTTP Status Code | Case Code | Response Message | Description |
---|---|---|---|
400XX | 00 | Bad Request | General request failed error, including message parsing failed. |
400XX | 01 | Invalid Field Format {field name} | Invalid format |
400XX | 02 | Invalid Mandatory Field {field name} | Missing or invalid format on mandatory field |
401XX | 00 | Unauthorized. [reason] | General unauthorized error (No Interface Def, API is Invalid, Oauth Failed, Verify Client Secret Fail, Client Forbidden Access API, Unknown Client, Key not Found) |
401XX | 01 | Invalid Token ( B2B ) | Token found in request is invalid (Access Token Not Exist, Access Token Expiry) |
401XX | 03 | Token Not Found (B2B | Token not found in the system. This occurs on any API that requires token as input parameter |
2. Credit Card
Refund Error
HTTP Status Code | Error Code | Error Message |
---|---|---|
400 |
| Invalid Client ID |
400 |
| Header Client-Id is required |
400 |
| Invalid Header Signature |
400 |
| No Original Transaction Available |
400 |
| Void Transaction Must Be Full Amount |
400 |
| Total Refund amount is Bigger than Original Transaction |
3. e-Wallet
HTTP Status Code | Case Code | Error Message |
---|---|---|
400XX | 00 | Bad Request |
400XX | 01 | Invalid Field Format {{param}} |
400XX | 02 | Invalid Mandatory Field {{param}} |
401XX | 00 | Unauthorized {param} |
401XX | 01 | Invalid Token B2B |
401XX | 02 | Invalid customer Token |
401XX | 03 | Token not found B2B |
401XX | 04 | Customer token not found |
403XX | 00 | Transacction Expired |
403XX | 01 | Feature Not Allowed |
403XX | 02 | Exceeds Transaction Amount Limit |
403XX | 03 | Suspected Fraud |
403XX | 04 | Activity Count Limit Exceeded |
403XX | 05 | Do Not Honor" |
403XX | 06 | Feature Not Allowed At This Time |
403XX | 07 | Card Blocked |
403XX | 08 | Card Expired |
403XX | 09 | Dormant Account |
403XX | 10 | Need To Set Token Limit |
403XX | 11 | OTP Blocked |
403XX | 12 | OTP Lifetime Expired |
403XX | 13 | OTP Sent To Cardholder |
403XX | 14 | Insufficient Funds |
403XX | 15 | Transaction Not Permitted. |
403XX | 16 | Suspend Transaction |
403XX | 17 | Token Limit Exceeded |
403XX | 18 | Inactive Card/Account/Customer |
403XX | 19 | Merchant Blacklisted |
403XX | 20 | Merchant Limit Exceed |
403XX | 21 | Set Limit Not Allowed |
403XX | 22 | Token Limit Invalid |
403XX | 23 | Account Limit Exceed |
404XX | 00 | Invalid Transaction Status |
404XX | 01 | Transaction Not Found |
404XX | 02 | Invalid Routing |
404XX | 03 | Bank Not Supported By Switch |
404XX | 04 | Transaction Cancelled |
404XX | 05 | Merchant Is Not Registered For Card Registration Services |
404XX | 06 | Need To Request OTP |
404XX | 07 | Journey Not Found |
404XX | 08 | Invalid Merchant |
404XX | 09 | No Issuer |
404XX | 10 | Invalid API Transition |
404XX | 11 | Invalid Card/Account/Customer [info]/Virtual Account |
404XX | 12 | Invalid Bill/Virtual Account |
404XX | 13 | Invalid Amount |
404XX | 14 | Paid Bill |
404XX | 15 | Invalid OTP |
404XX | 16 | Partner Not Found |
404XX | 17 | Invalid Terminal |
404XX | 18 | Inconsistent Request |
404XX | 19 | Invalid Bill/Virtual Account |
405XX | 00 | Requested Function Is Not Supported |
405XX | 01 | Requested Operation Is Not Allowed |
409XX | 00 | Conflict |
409XX | 01 | Duplicate partnerReferenceNo |
429XX | 00 | Too Many Requests |
500XX | 00 | General Error |
500XX | 01 | Internal Server Error |
500XX | 02 | External Server Error |
504XX | 00 | Timeout |
4. Direct Debit
HTTP Status Code | Case Code | Error Message |
---|---|---|
200XX | 00 | Successful |
400XX | 00 |
Bad Request |
400XX | 01 | Invalid Field Format {field name} |
400XX | 02 | Invalid Mandatory Field {field name} |
401XX | 00 | Unauthorized. [reason] |
401XX | 01 | Invalid Token (B2B) |
401XX | 02 | Invalid Customer Token |
401XX | 04 | Customer Token Not Found |
403XX | 02 | Exceeds Transaction Amount Limit |
403XX | 05 | Do Not Honor |
403XX | 14 | Insufficient Funds |
403XX | 15 | Transaction Not Permitted.[reason] |
404XX | 00 | Invalid Transaction Status |
404XX | 01 | Transaction Not Found |
404XX | 08 | Invalid Merchant |
404XX | 12 | Invalid Bill/Virtual Account [Reason] |
404XX | 13 | Invalid Amount |
404XX | 18 | Inconsistent Request |
429XX | 00 | Too Many Requests |
500XX | 00 | General Error |
500XX | 01 | Internal Server Error |
Last updated