This section describes possible API errors.
Xpresspay API errors are usually returned in this format with the 4xx, 5xx http status code:
{
"status": "FAILED",
"error": "Error type",
"message": "Error message"
}
Error Type
Below are the list of error types that can occur in error responses
Error Type | Description |
---|---|
INPUT | This kind of error occur when a compulsory field is empty or wrong value was passed |
NOT_FOUND | This kind of error occur when trying to get a particular data and it's not available in the database |
PROCESSING | This kind of error occur during the course of processing request |
Status code | Implication |
---|---|
200, 201 | Request was valid and intended action was carried out. Note that we will always send a 200 http status code. |
400 | A validation or client side error occurred and the request was not fulfilled. |
401 | The request was not authorized. This can be triggered by passing an invalid secret key in the authorization header or the lack of one |
404 | Request could not be fulfilled as the request resource does not exist. |
500, 501, 502, 503, 504 | Request could not be fulfilled due to an error on Xpresspayonline's end. This shouldn't happen so please report as soon as you encounter any instance of this. |