Error handling

If an API call fails, e.g. because the input is invalid, this will be indicated by the HTTP status code of the API response. The body of the response normally contains an error report, which includes a hint on how the problem might be solved.

Status codes Meaning
200-299 The request succeeded.
400-499 The request failed due to invalid input or incorrect usage of the API.
500-599 An error ocurred while processing your request. We will solve the issue ASAP.

Our libraries will throw an exception if an API-call fails, with the full error report as its message.

Errors in the live environment

If an error occurs in the live environment, you will be notified per e-mail automatically. Please ensure your app records sufficient information in a log file to determine the cause and find any affected orders. We may not always be able to log your request.