Response Code & Message
Introduction​
Response Code is used to show the result of an API request. It helps partners understand whether the request was successful, failed, or needs further checking. Each response code has a specific meaning and should be reviewed together with the response message to identify the next action.
The following table is the list response code and message
| HTTP Code | Type | Length | Response Message |
|---|---|---|---|
| responseCode | String | (7) | response code = HTTP status code + service code + case code |
| responseMessage | String | (150) | A descriptive message providing additional details about the response. |
List of Response Code​
Before checking the table, partners are advised to review the responseCode, responseMessage, and related transaction data together. This helps ensure the error is understood correctly and the right follow-up action can be taken.
📌 Needs to Know about Response Code
Response code = HTTP status code + service code + case code
Response code is formed by combining three parts: HTTP status code, service code, and case code. The HTTP status code shows the general result of the request, the service code identifies which service or product returned the response, and the case code explains the specific condition or error case. This structure helps partners understand where the response comes from and what issue or result happened.
| HTTP Code | Service Code | Case Code | Description |
|---|---|---|---|
| 200 | XX | 00 | Successful |
| 400 | XX | 00 | General request failed error, including message parsing failed. |
| 400 | XX | 01 | Invalid format |
| 400 | XX | 02 | Missing or invalid format on mandatory field |
| 401 | XX | 00 | General unauthorized error (No Interface Def, API is Invalid, Oauth Failed, Verify Client Secret Fail, Client Forbidden Access API, Unknown Client, Key not Found) |
| 401 | XX | 01 | Token found in request is invalid (Access Token Not Exist, Access Token Expiry) |
| 403 | XX | 01 | This merchant is not allowed to call direct API |
| 404 | XX | 01 | Transaction Not Found |
| 404 | XX | 08 | Merchant does not exist or status abnormal |
| 404 | XX | 13 | The amount doesn't match with what supposed to |
| 409 | XX | 00 | Cannot use same X-EXTERNAL-ID in same day |
| 409 | XX | 01 | Transaction has previously been processed indicates the same partnerReferenceNo already success |
| 500 | XX | 00 | General Error |
| 500 | XX | 01 | Unknown Internal Server Failure. Please retry the process again |
| 504 | XX | 00 | Timeout from the issuer. |