Return Codes

We us conventional HTTP response codes to indicate the success or failure of an API request.

General breakdown:

• Codes in the 2xx range indicate success.
• Codes in the 4xx range indicate an error that failed due to the information provided (e.g., a required parameter is missing, an authorization failed, etc.).
• Codes in the 5xx range indicate an error with our servers

Besides a general HTTP response code, you will also receive a more detailed code that gives more indication on what has exactly happened with your request.

For either a successful, pending or failed request, you will receive a code and its description.

The code answers is based on 6 digits structured as follows:

• The first 4 digits give general information related to the kind of response and its origine

• The last 2 digits give detailed information related to the reason code.

Example:

We are in the authorization phase (1st digit = 4), it's a processing return code (2nd digit = 2), a fallback is possible (3rd digit = 0), the decision comes from the acquirer side (4th digit = 2), and it's a risk related decision (last 2 digits = 30)

Example:

{
 "result": {
    "code": "944444",
    "description": "Authorization successful"
    }
}

You can find the result code for each of your transactions in your merchant account as well. This is to be found in the transactions section. To see the result code, please add the "result code" column into your view. To do so, click on "Display" in the top right corner and select the columns "result code" and "result description" to be added.

ℹ️

To find out more customization options, navigate to the YOUR ACCOUNT - CUSTOMIZATION section in this documentation.