HTTP Status Codes

API responds with the following HTTP status codes in case of errors:

Client Errors

• 400 – Bad request, invalid body or parameters; business logic errors
• 401 – Authentication failed or not sufficient (ie. when level 1 provided, but level 2 required)
• 404 – Resource does not exist or is not available for this shop (belongs to another shop)
• 409 – Resource conflict
• 415 – Request content type is not application/json.

Server Errors

• 500 – all server internal errors

Response Body

Client Errors

In case of client errors, API responds with a code and message parameter. An optional errors collection may be returned with more information about the error occurred.

POST /transactions

{
    "code": 1001,
    "message": "Invalid input",
    "errors": [
        {
            "resource": "transaction",
            "field": "currency",
            "type": "invalid"
        },
        {
            "resource": "customer",
            "field": "ip",
            "type": "missing"
        }
    ]

}

Server Errors

Server errors return no response body.

Business Logic Errors

All business logic errors are returned with a 400 HTTP Status.