Error codes for card-present transactions

March 12, 2025

Here are the common errors in card-present transactions and how to resolve them

HTTP Status codes

Below, we present the most common HTTP status codes, their associated standard messages, and a description of the response.

Here are the codes you might receive.

Codes returned by Kushki in card-present transactions

The response codes received from processors and issuers will appear in thekushki_response object, as shown in the following example.

“kushki_response": {
        "code": "01",
        "message": "Refer to card issuer"
    },

Error 006

This error code appears when Kushki blocks the card, for example if the brand is not supported.

"kushki_response": {
        "code": "006",
        "message": "Card brand not supported"
    },

In case this code comes from the Card franchises (Visa, Mastercard or Prosa (Mexico), it will have two digits. Below you will find the most common response codes, including declinations:

Response codes returned by Kushki for cancellations and reversal attempts

The response codes received from processors and issuers will appear in the kushki_response object, as shown in the following example.

"kushki_response": {
        "code": "01",
        "message": "Refer to card issuer"
    },

Below you will find information on the codes and messages sent by Kushki to describe the response codes for requests made with card-present transactions. In the “What to Do?” column, you will find a detailed explanation of the causes and the procedure you should follow.