Error Codes
When integrating our API, it's essential to be aware of common error codes that may occur during the process. Understanding these error codes will help you troubleshoot and resolve any issues effectively. Here is a brief description of some common error codes you may encounter:
| HTTP Response Code | Error Code | Description |
|---|---|---|
| 400 | CREATE_FAILED | We encountered an error while creating your request from our switching service, please try again!. |
| 401 | UNAUTHORIZED | Authorization failed. Please provide valid credentials. |
| 401 | PRODUCT_ACCESS_ERROR | |
| 402 | INSUFFICIENT_BALANCE | Insufficient balance. Unable to perform the transaction. |
| 403 | UNAUTHORIZED | The API request is not permitted from your current location or IP address. |
| 403 | PAYMENT_INACTIVE_ERROR | |
| 404 | TRANSACTION_NOT_FOUND | The requested transaction could not be found. |
| 429 | PAYMENT_INTERNAL_ERROR | |
| 409 | DUPLICATE_REFERENCE | |
| 422 | REQUEST_INVALID | The request is invalid or contains invalid parameters. |
| 422 | INVALID_SIGNHASH | The provided sign hash is invalid or does not match the expected value. |
| 429 | TOO_MANY_REQUEST | The maximum number of requests has been exceeded. Please try again later. |
| 500 | PRODUCT_INTERNAL_ERROR | The upstream connection has been terminated due to connection timeout from bank aggregator. |
| 501 | PRODUCT_UNSUPPORTED | |
| 503 | RUN_OUT_UPSTREAM_CONNECTION | The upstream connection has been terminated due to connection timeout from bank aggregator. |
| 503 | PRODUCT_UNDER_MAINTENANCE | |
| 504 | UPSTREAM_TIMEOUT_CONNECTION | The connection to the upstream server timed out. |