Error Codes for declined cash transaction

February 07, 2023

Learn how to resolve the different error types messages received during declined cash transactions; Kushki API validation.

What types of response codes does Kushki return?

Kushki will return two different response codes to indicate the success or failure of a transaction: processorError and code. The code field returns generic messages. On the other side, the field processorError indicates that the transaction has passed through the processor and has probably been mapped by Kushki in order to provide a specific explanation of the reason why your transaction could not be completed.

Codes returned by Kushki for cash payments

Kushki’s API will perform validations before sending a transaction to the processors. If this is the case, the processorError field will not appear in the response and you will only see the code field. An example of a message returned by Kushki’s API is shown below:

{
    "code": "C001",
    "message": "Cuerpo de la petición inválido."
}

In the table below, generic error codes returned through the code field are summarized.

HTTP status codes

Kushki will be able to return different HTTP status codes depending on the requests made. There are five categories of standard responses, described in the following image:

Below are the most common HTTP status codes, their associated standard message, as well as a more detailed description of the response.