Error codes for transfer disbursements

March 20, 2024

Know about common mistakes in money transfer disbursements

In case there is a problem with a transfer disbursement, the Kushki API will return an error code and message. The following is an example of a message returned by the Kushki API:

     {"responseCode": "002",
      "responseText": "Format error in amount"}

Codes returned by Kushki for transfer disbursement

In case there is a problem with a transfer disbursement, the Kushki API will return an error code and message.

Code	Message (Spanish)	Description
PT001	Cuerpo de la petición inválido.	Check that the information sent is in accordance with the documentation.
PT007	El comercio no existe	Merchant doesn’t exist. Please enter a valid merchant id.
PT008	El comercio no existe	Merchant doesn’t exist. Please enter a valid merchant id.
PT0013	Número de documento no válido	Invalid document number
PT0015	Número de cuenta inválido	Invalid account number
PT057	La moneda enviada es diferente a la definida por el procesador.	Check sent currency.

For Peru, there is the approved code 006. Below, we show the possible error messages returned in the responseText field.

responseCode	responseText
002	IDC DIFIERE CON EL DE LA CNTA
006	Cuenta destinatario inhabilitada para recibir abonos
006	Cuenta de beneficiario incorrecta
006	Cuenta de beneficiario cerrada
006	Monto excede máximo permitido
006	Servicio no disponible
006	Saldo insuficiente
006	Banco de beneficiario incorrecto
006	Error de procesamiento
006	Mensaje de BCP en el archivo
006	Identificación de beneficiario incorrecta
006	Cuenta e identificación de beneficiario no coinciden
006	Declinado por el procesador