Error Codes

Unexpected errors

Unexpected errors are errors that are always returned with the HTTP status code 200 OK. These errors indicate that the request was successfully processed, even if it resulted in an error. The standard JSON response format for unexpected errors is shown below:

{
    "status": true,
    "status_code": 0,
    "message": "Success",
    "result": {
        "error_code": 1042,
        "message": "Duplicate external_id",
        "data": {},
        "additional_data": {}
    }
}

The error details are located in the result parameter under the error_code and message fields.

Code	Text message	Description	HTTP Status
0	Success	The request has been processed successfully	200
8301	Unexpected db error	Unidentified error occurred during processing resource	200
1407	Cache: item not found	The requested resource not found	200
1041	Order not found	Payment with the specified identifier not found	200
1042	Duplicate external_id	Repeated payment with the same identifier	200
1881	provider doesn't exists	The requested provider not found	200
8015	account doesn't exist	The requested account not found	200
999999	Unknown error	Unidentified error	200

Expected Errors

Expected errors are errors returned with an HTTP status code that indicates a failure (such as 400 or 500). These errors signal that the request failed due to issues such as validation errors, authentication problems, or system errors. They follow a standardized JSON response format, as shown below:

{
    "status": false,
    "status_code": 1014,
    "message": "Invalid signature",
    "result": {}
}

The status_code and message provide the main information about the error.

Code	Text message	Description	HTTP Status
500	Internal Server Error	Unidentified server error	500
1014	Invalid signature	The signature has been made incorrectly	400
1021	request validation error	Invalid request body	400
1404	Invalid action request	Field value not passed	400