Error codes

The API uses conventional HTTP response codes, and every failed request also returns a result object with a detailed code.

HTTP response codes

RangeMeaning
2xxThe request was processed. Read result.code for the outcome.
4xxThe request failed because of the information sent: a missing or invalid parameter, an invalid API key, and so on. Fix the request before sending it again.
5xxAn error occurred on the platform side.

Error response

The result object gives a 6-digit code and its description. For an invalid parameter, details tells you which field is wrong and where it was sent.

{
  "result": {
    "code": "111012",
    "description": "invalid parameter"
  },
  "details": [
    {
      "field": "uuid",
      "description": "not used by customer",
      "location": "query",
      "value": "69135e58bac66b1f061515ca",
      "type": "uuid"
    }
  ]
}

Read the result code

The first 4 digits give the context of the response; the last 2 digits give the reason.

DigitMeaningValues
1stOrder phase1 order creation, 2 tokenization, 3 authentication, 4 authorization, 5 capture, 6 refund, 7 cancel, 9 success
2ndOrigin1 technical, 2 processing, 3 risk assessment, 4 account related, 5 routing issue, 6 incomplete
3rdFallback0 possible, 1 not recommended
4thSide0 undetermined, 1 issuer, 2 acquirer, 3 ACS

For example, 420230 (risk rejection) is an authorization response (4), from processing (2), where a fallback is possible (0), decided on the acquirer side (2).

Request errors

These codes concern the request itself, whatever the endpoint.

CodeDescriptionWhat to do
111011Missing required parameterAdd the required field. Required fields are listed on each endpoint page.
111012Invalid parameterCheck the field named in details: type, format and allowed values.
111013An error occurredContact your support team with the request details if it persists.
111022Invalid API keyCheck the key and its type. See Authentication.
111034Max attempts reachedNo more payment attempts are possible on this order (see max_attempts).
111035Order is already being processedRetrieve the order to check its current status before sending another request.

Codes for each phase (tokenization, authentication, authorization, capture, refund, cancel) are listed in Return codes.

Related pages