get https://example.com/response-codes
The following table lists all possible response codes returned by Direct Debit APIs.
| Category | HTTP Code | Code | Title | Description |
|---|---|---|---|---|
| Success | 200 | 00 | Successful | Successful |
| Success | 202 | 00 | Request In Progress | Transaction still in process |
| System | 400 | 00 | Bad Request | General request failed error, including message parsing failed |
| Message | 400 | 01 | Invalid Field Format {field name} | Invalid format |
| Message | 400 | 02 | Invalid Mandatory Field {field name} | Missing or invalid format on mandatory field |
| System | 401 | 00 | Unauthorized [reason] | General unauthorized error (No Interface Def, API Invalid, OAuth Failed, Verify Client Secret Fail, Client Forbidden Access API, Unknown Client, Key not Found) |
| System | 401 | 01 | Invalid Token (B2B) | Token in request is invalid (Access Token Not Exist or Expired) |
| System | 401 | 02 | Invalid Customer Token | Token in request is invalid (Access Token Not Exist or Expired) |
| System | 401 | 03 | Token Not Found (B2B) | Token not found in system for APIs requiring token input |
| System | 401 | 04 | Customer Token Not Found | Customer token not found in system |
| Business | 403 | 00 | Transaction Expired | Transaction expired |
| System | 403 | 01 | Feature Not Allowed [Reason] | Merchant not allowed to call Direct Debit APIs |
| Business | 403 | 02 | Exceeds Transaction Amount Limit | Exceeds transaction amount limit |
| Business | 403 | 03 | Suspected Fraud | Suspected fraud detected |
| Business | 403 | 04 | Activity Count Limit Exceeded | Too many requests, exceeds transaction frequency limit |
| Business | 403 | 05 | Do Not Honor | Account or user status abnormal |
| System | 403 | 06 | Feature Not Allowed At This Time [reason] | Cut off in progress |
| Business | 403 | 07 | Card Blocked | Payment card is blocked |
| Business | 403 | 08 | Card Expired | Payment card is expired |
| Business | 403 | 09 | Dormant Account | Account is dormant |
| Business | 403 | 10 | Need To Set Token Limit | Need to set token limit |
| System | 403 | 11 | OTP Blocked | OTP has been blocked |
| System | 403 | 12 | OTP Lifetime Expired | OTP has expired |
| System | 403 | 13 | OTP Sent To Cardholder | Initiates OTP request to issuer |
| Business | 403 | 14 | Insufficient Funds | Insufficient funds |
| Business | 403 | 15 | Transaction Not Permitted [reason] | Transaction not permitted |
| Business | 403 | 16 | Suspend Transaction | Transaction suspended |
| Business | 403 | 17 | Token Limit Exceeded | Purchase amount exceeds token limit |
| Business | 403 | 18 | Inactive Card/Account/Customer | Indicates inactive account |
| Business | 403 | 19 | Merchant Blacklisted | Merchant suspended from calling APIs |
| Business | 403 | 20 | Merchant Limit Exceed | Merchant aggregated purchase limit exceeded |
| Business | 403 | 21 | Set Limit Not Allowed | Set limit not allowed on this token |
| Business | 403 | 22 | Token Limit Invalid | Desired token limit not within agreed range |
| Business | 403 | 23 | Account Limit Exceed | Account aggregated limit exceeded |
| Business | 404 | 00 | Invalid Transaction Status | Invalid transaction status |
| Business | 404 | 01 | Transaction Not Found | Transaction not found |
| System | 404 | 02 | Invalid Routing | Invalid routing |
| System | 404 | 03 | Bank Not Supported By Switch | Bank not supported |
| Business | 404 | 04 | Transaction Cancelled | Transaction cancelled by customer |
| Business | 404 | 05 | Merchant Not Registered For Card Registration | Merchant not registered for Card Registration services |
| System | 404 | 06 | Need To Request OTP | Need to request OTP |
| System | 404 | 07 | Journey Not Found | journeyId not found in system |
| Business | 404 | 08 | Invalid Merchant | Merchant does not exist or has abnormal status |
| Business | 404 | 09 | No Issuer | No issuer |
| System | 404 | 10 | Invalid API Transition | Invalid API transition within journey |
| Business | 404 | 11 | Invalid Card/Account/Customer [info]/Virtual Account | Invalid card/account or blacklisted, or invalid Virtual Account number |
| Business | 404 | 12 | Invalid Bill/Virtual Account [Reason] | Bill or Virtual Account blocked/suspended/not found |
| Business | 404 | 13 | Invalid Amount | Amount mismatch |
| Business | 404 | 14 | Paid Bill | Bill already paid |
| System | 404 | 15 | Invalid OTP | OTP incorrect |
| Business | 404 | 16 | Partner Not Found | Partner number not found |
| Business | 404 | 17 | Invalid Terminal | Terminal does not exist |
| Business | 404 | 18 | Inconsistent Request | Inconsistent parameters for same partnerReferenceNo/transactionId |
| Business | 404 | 19 | Invalid Bill/Virtual Account | Bill or Virtual Account expired |
| System | 405 | 00 | Requested Function Not Supported | Function not supported |
| Business | 405 | 01 | Requested Operation Not Allowed | Cancel/refund not allowed at this time |
| System | 409 | 00 | Conflict | Same X-EXTERNAL-ID reused on same day |
| System | 409 | 01 | Duplicate partnerReferenceNo | Transaction already processed successfully |
| System | 429 | 00 | Too Many Requests | Maximum transaction limit exceeded |
| System | 500 | 00 | General Error | General Error |
| System | 500 | 01 | Internal Server Error | Unknown internal failure, retry process |
| System | 500 | 02 | External Server Error | Backend system failure |
| System | 504 | 00 | Timeout | Timeout from issuer |