Error Codes Guideline

Here you're going to find the error code classification in our system. You will be able to determine the next step of action in case of receiving an error from the request to our API.

Error Code Rules

As a merchant, you can use the Advice Flag to define your next move when getting an error code.

  • 0 - manual check is needed;
  • 1 - do not retry;
  • 2 - retry under the same conditions;
  • 3 - some updates are required.

Invalid Request Error Codes (11xxxx, 21xxxx)

As a merchant, you're going to receive an error code from this category in case of providing us with a wrong parameter when making the request to our API.

Examples:

  • 110001 - Method is not supported.
  • 110010 - One or more parameters didn't pass the validation step.
  • 110027 - Tokenized credit cards are not supported.
  • 110033 - Invalid transaction id was provided.

Connection Error Codes (12xxxx, 22xxxx)

As a merchant, you're going to receive an error code from this category in case of some connection issues between your different servers.

The most common examples are between:

  • Our servers & Your servers
  • Our servers & Acquirers' servers

Examples:

  • 122004 - At least one of the services is unavailable.
  • 120008 - An exception occured when exchanging rates.

Payment Error Codes (13xxxx)

As a merchant, you're going to receive an error code from this category in case of any exception that might occur to a payment or payment request.

Examples:

  • 130005 - Unexpected refund state for the payment.
  • 130011 - Missing payment.
  • 130014 - Missing payment request.

API Error Codes (14xxxx)

As a merchant, you're going to receive an error code from this category in case of any error that might happen on our side.

Examples:

  • 140003 - Unknown acquirer was used.
  • 140008 - The status of the payment is missing.
  • 140022 - An exception occured on the backend part.

Permissions Error Codes (15xxxx)

As a merchant, you're going to receive an error code from this category in case of insufficient permissions of your user when making a request to our API.

Examples:

  • 150002 - The given user is not authorized to perform the operation
  • 150005 - An exception occured because the merchant is blocked.

Configuration Error Codes (16xxxx, 26xxxx)

As a merchant, you're going to receive an error code from this category in case of any misconfiguration.

Examples:

  • 160001 - There is an validation error at the terminal level.
  • 160002 - Terminal is not configured for given currency.
  • 160007 - Acquirer not enabled for given terminal.

Decline Error Codes (23xxxx)

As a merchant, you're going to receive an error code from this category in case of direct decline received from the acquirer.

Examples:

  • 232001 - Insufficient funds.

System Error Codes (24xxxx)

As a merchant, you're going to receive an error code from this category in case of any error that might happen on our side related to the acquirer’s activity.

Examples:

  • 240001 - Timeout when reaching out to acquirer. (not implemented yet)