Errors

Most common API error responses are described below. Error response must be identified by HTTP status and reason attribute in your application.

Please note that specific API methods (for example Create Payment Session) have their own errors (e.g. 422 Unprocessable Entity - when order is not valid).

HTTP Status	Reason	Description
401 (Unauthorized)	BadCredentials	API credentials are not valid
404 (Not Found)	PageNotFound	Page, action or record not found
404 (Not Found)	RecordNotFound	Record not found
500 (Internal Server Error)	InternalServerError	Something wrong in our side
429 (Too Many Requests)	RateLimitException	API request limit is exceeded

Error Response Format

Example response format

{
    "status": "error",
    "code": "010207",
    "data": null,
    "error": "Invalid invoice state for refund"
}

Name	Type
statusWill always be “error” for an error response	string
code6 digit error code	string
dataWill be null for an error response	string
errorThe error message	string

HTTP Method - First two digits

Name	Type
00xxxxGeneric, unmapped error	string
01xxxxPOST error	string
02xxxxGET error	string
03xxxxPUT error	string
04xxxxDELETE error	string

Resource and Error - Last four digits

Unmapped Errors: xx00xx

These errors are not mapped to a specific resource

Name	Type
xx0000Generic server error	string
xx0001Resource not found	string
xx0002Invalid parameters	string
xx0003Missing parameters	string

Invoice Errors: xx01xx

These errors are mapped to the invoice resource

Name	Type
xx0100Generic invoice error	string
xx0101Invoice not found	string
xx0102Invalid parameters	string
xx0103Missing parameters	string
xx0108Invoice is missing email or SMS	string
xx0109SMS not verified	string
xx0110Invoice price is below minimum threshold	string
xx0111Invoice price is above maximum threshold	string
xx0112Invalid SMS number	string
xx0113Error verifying SMS	string
xx0114Unable to update contact information on high value transaction	string
xx0115Email already set on invoice	string
xx0116Unable to perform action outside of demo environment	string
xx0117Invalid invoice state	string
xx0118Misconfigured account	string

Refund Errors: xx02xx

These errors are mapped to the refund resource

Name	Type
xx0200Generic refund error	string
xx0201Refund not found	string
xx0202Invalid parameters	string
xx0203Missing parameters	string
xx0204Active refund request already exists	string
xx0207Invalid invoice state for refund	string
xx0208Fees are greater than refund amount	string