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 occured
message String A meaningful 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, quoting the code and timestamp of this error
101404 Not FoundThe requested page can't be found. It's likely that the page's URL is incorrect, or was accessed using an incorrect protocol. For some pages, a strict URL routing is enabled: you may need to add or remove a trailing slash, to or from the URL.
102400 Bad RequestThe submitted username or password is invalid. After a defined number of failed login attempts, the requested user will be temporarily blocked.
103403 ForbiddenThe submitted token hasn't been recognized. It's likely that the current session has expired, or holds an expired token. Should you receive this error repeatedly, or from a server-side call, please report it to an administrator.
104404 Not FoundThe requested file can't be found. Make sure the requested file hasn't been deleted.
105400 Bad RequestThe submitted password is invalid. A password must be at least 8 characters in length, and contain at least one uppercase letter, one lowercase letter, one digit, and one symbol.
106400 Bad RequestAn invalid or expired password reset token has been submitted. A given token is only valid for a short amount of time; ask for a new one if needed.
107400 Bad RequestAt least one parameter is invalid. Examine the details property for more information. Invalid parameters are listed and prefixed accordingly: body for parameters submitted in the request's body, query for parameters appended to the request's URL, and params for templated parameters of the request's URL.
108500 Internal Server ErrorUnexpected error: if the error persists, please contact an administrator, quoting the code and timestamp of this error
109404 Not FoundThe requested resource, or one of its sub-resources, can't be found. If the submitted query is valid, this error is likely to be caused by a problem with a nested resource that has been deleted or modified. Check the details property for additional insights.
110400 Bad RequestThe submitted or requested resource is invalid. If you submitted a resource, please check for invalid fields, which will be listed in the details property. If you requested a resource, ensure the latter is valid, as well as its sub-resources.
111403 ForbiddenThe submitted transaction has been blocked by a ruleset specified by the organization owning the payment profile, or by a superior organization. Further information is available by querying the relevant transaction, or by examining the blocked transaction in the user interface.
112500 Internal Server ErrorFailed to perform database query. Please try again. If the error persists, contact an administrator.
113403 ForbiddenInsufficient permissions. Your current user roles don't allow you to perform this query. Should you believe this error to be incorrect, please contact an administrator.
114403 ForbiddenYour user is disabled. The intervention of an administrator is required.
115403 ForbiddenYour password has expired, and must be changed.
116401 UnauthorizedAccess is restricted to authenticated users only. The query can't be made without a valid API key (check the APIKEY header of your request), or a valid session (in which case session cookies are automatically set by the browser).
117400 Bad RequestIt is not possible to disable or restrict your own user permissions. Verify your request target, and / or parameters. If you're trying to update your user profile, ensure your user roles are set to something valid (avoid json null, or empty list [])
118500 Internal Server ErrorUnexpected error: if the error persists, please contact an administrator, quoting the code and timestamp of this error
119501 Not ImplementedThe transaction relates to an unknown processor. This could happen if the processor configuration that was initially used has changed. Please verify the processor configuration used by this payment profile.
120500 Internal Server ErrorUnexpected error: if the error persists, please contact an administrator, quoting the code and timestamp of this error
121403 ForbiddenThe transaction has been declined by the processor. The request reached the processor, but it was not accepted. A decline reason code is available in the details property.
122500 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. Should you experience it, please contact an administrator with the corresponding error code and timestamp.
123400 Bad RequestThe transaction has been rejected by the processor. The request reached the processor, but it failed the validation checks required by the processor. Please examine your request. If the error persists, contact an administrator.
124500 Internal Server ErrorUnexpected error: if the error persists, please contact an administrator, quoting the code and timestamp of this error
125400 Bad RequestThe submission contains an invalid character. Some characters are forbidden for some inputs. The details property identifies the character causing the error, and, possibly, its source.
126400 Bad RequestAt least one parameter is missing from the request body. Ensure you have provided all required parameters, as specified in the documentation.
127400 Bad RequestAt least one parameter is unexpected, or unwanted. If you're trying to update a resource, be sure to include only parameters that you want to, and may, update. Some parameters are read-only or create-only.
128400 Bad RequestThe submitted or computed amount is too large. This happens when trying to capture or refund a transaction for more than the available amount. In some cases, for some payment methods, it is possible to re-authorize or capture slightly more than the initial amount; please refer to the documentation to learn when and where this is possible.
129400 Bad RequestThe submitted HTML or CSS snippets have failed the validation checks, and are considered unsafe. Remember, it is forbidden to include JavaScript, or external URLs that aren't images, in your snippets.
130400 Bad RequestAt least one field of the submitted entity that is supposed to be unique already exists in another resource. The details property identifies which field is conflicting with which resource.
131503 Service UnavailableThe processor is currently unavailable. Try again later.
132501 Not ImplementedThe requested operation is not supported by the payment method or processor. Refer to the documentation for a list of supported operations.
133501 Not ImplementedThe requested card scheme isn't supported by the processor.
134400 Bad RequestFailed to parse the request. Ensure the request contains a valid JSON object, avoiding single quotes and trailing commas, and that the Content-Type header is set to application/json.
135501 Not ImplementedInvalid combination (key, operator) for matching ruleset.
136400 Bad RequestSetting the password to a recently-used password is prohibited. Please set a different password.
137400 Bad RequestParameters in the request body are conflicting with one another. It's likely that they are valid individually, yet they can't be submitted together, as that would lead to invalid combinations.
138401 UnauthorizedYour session has expired, or can't be renewed. Re-authentication is needed. Please be aware that all sessions will eventually expire.
139400 Bad RequestThe submitted session token is invalid. It's likely that your client application has corrupted the session cookie.
140500 Internal Server ErrorAn error occurred during 3D Secure processing. For more information, please refer to the details property.
141403 ForbiddenNo more than 2 API-keys can be created for the same user.
142403 ForbiddenCannot remove processor, there are still payment profiles using it.
143400 Bad RequestYou have attempted to use an payment profile that uses a currency that is not supported when using this processor.
144400 Bad RequestPlease fill in the captcha input.
145400 Bad RequestThe input captcha doesn't match with the provided one. Please retry.
146403 ForbiddenUnable to delete the payment profile. The payment profile still has transactions stored in it.
147403 ForbiddenUnable to make a transaction, because the payment profile has been disabled.
148400 Bad RequestThe processor configuration you're trying to use contains invalid fields.
149400 Bad RequestThe recurring transaction could not be initiated
150403 ForbiddenThe transaction was declined by a third party fraud engine
151400 Bad RequestThe amount does not match the expected value
152403 ForbiddenUnable to create inspector as there's an existing type attached to the Organisation
153501 Not ImplementedThe (payment profile) transaction relates to an unknown inspector. This could happen if the inspector configuration that was initially used has changed. Please verify the inspector configuration used by this payment profile.
154403 ForbiddenCannot remove inspector, there are still payment profiles using it.
158501 Not ImplementedThe requested operation is not supported by the importer. Refer to the documentation for a list of supported operations.
159501 Not ImplementedThe selected importer is unknown. Please check the list of available importers in the documentation or make sure that the importer is enabled in the config
160400 Bad RequestThere's no mapping found for the given merchant id. Please make sure to define the mapping first
161400 Bad Requestyou have provided a page containing invalid or prohibited CSS content
162400 Bad Requestyou have provided a page containing invalid or prohibited HTML content
163400 Bad Requestone or more values are duplicated, but should be unique
164400 Bad Requestfailed to retrieve content from external URL
165403 ForbiddenThis user has been temporarily blocked. Please try again later.
301400 Bad RequestThe transaction has been declined by the processor. The request reached the processor, but it was not accepted. A decline reason code is available in the details property.
302403 Bad RequestCannot remove item because it's still in use
303400 Bad RequestCheckout not successful
304400 Bad RequestThe requested transaction cannot be found or is expired.
305400 Bad RequestThe requested endpoint cannot is unreachable due to IP whitelist restrictions.
306400 Bad RequestCannot delete an object that has transactions associated.
307400 Bad RequestCannot delete an object that has a processor settlement provider associated.
309400 Bad RequestAmount exceeds remaining maximum refund amount for this transaction.
310400 Bad RequestAmount exceeds remaining maximum refund amount for this payment profiles.
311400 Bad RequestRefund amount should be a positive integer.
312400 Bad RequestCannot add scheme without valid rules.
313400 Bad RequestThe informed scheme is not shareable and is already attached to a processor..
314400 Bad RequestThis transaction is not voidable. Either because this payment product doesn't support voiding or because the transaction is already voided or captured.
315400 Bad RequestThis transaction cannot be captured. Either because this payment product doesn't support capture or because the transaction is already captured.
316400 Bad RequestThis transaction is not refundable. Either because this payment product doesn't support refunds or because the transaction is already refunded.