Error codes

Return object

Each request made to the API may return an error object of the following shape:

Field Type Description
code Number A 3-digit identifier
timestamp Number The time when the error occurred
message String A description of the error
[details] Object Optional, may contain information specific to the error. Used for debugging

The complete list of codes is given right below.

The code field is something on which one can rely: it will remain the same in future implementations and it is easy to parse. The message and details properties however are not intended to be manipulated by a program. They would rather serve for debugging and are only expected to be read by human beings: they are likely to be adjusted in the future (to make them clearer or more precise).

Error code overview

Code Http status Message
100500 Internal Server ErrorUnexpected error: if the error persists, please contact an administrator.'
101400 Bad RequestThe submitted username or password is invalid.
102403 ForbiddenThis user has been temporarily blocked. Please try again later.
103401 UnauthorizedInvalid API key.
104403 ForbiddenInsufficient permissions. Your current user roles don't allow you to perform this query.
105403 ForbiddenThe requested endpoint is unreachable due to IP whitelist restrictions.
106404 Not FoundThe requested resource, or one of its sub-resources, can't be found.
107404 Not FoundThe requested file can't be found. Make sure the requested file hasn't been deleted.
108400 Bad RequestAt least one parameter is invalid. Examine the details property for more information.
109400 Bad RequestThe submitted or requested resource is invalid. Examine the details property for more information.
110501 Not ImplementedThe transaction relates to an unknown processor. Please verify the processor configuration used by this payment profile.
111500 Internal Server ErrorSomething went wrong with the processor. The processor replied with something unexpected, which makes it difficult to handle. This error shouldn't occur.
112403 ForbiddenThe submitted transaction has been blocked by a ruleset specified by the organisation owning the payment profile, or by a superior organisation.
113400 Bad RequestThis transaction is not voidable. Either because this payment product doesn't support voiding or because the transaction is already voided or captured.
114400 Bad RequestThis transaction cannot be captured. Either because this payment product doesn't support capture or because the transaction is already captured.
115400 Bad RequestThis transaction is not refundable. Either because this payment product doesn't support refunds or because the transaction is already refunded.
116400 Bad RequestIt is not possible to disable or restrict your own user permissions.
117400 Bad RequestIt is not possible to disable your own user's organisation.
118400 Bad RequestCannot remove [item] because it's still in use by [object].
119400 Bad RequestCannot delete an object that has one or more associated [object] objects.
120429 Too Many RequestsAPI rate limit reached
121403 ForbiddenOne-off has already been applied to a settlement. Therefore, it cannot be updated or deleted.
122422 Unprocessable ContentCannot update [item], because it's in use by [object].
123400 Bad RequestCannot add a subscription discount, because a subscription already has an active discount.