Códigos de error para dispersiones por transferencia

25 octubre 2024

Aprende sobre errores comunes en dispersiones de dinero por transferencia

Al realizar una petición de dispersión de dinero por transferencia podrás consultar el estatus de la transacción por medio del endpoint de Get Status o a través de un webhook. En caso de haber un problema para completar la dispersión, recibirás un código de error así como un mensaje con la información del error. Los campos que recibirás en la respuesta serán los siguientes:

"responseCode": "560",
"responseText": "Monto ingresado supera límite"

A continuación te presentamos los códigos de error genéricos retornados en el campo code.

code	message	¿Qué hacer?
501	Transacción rechazada	Deberá ponerse en contacto con el emisor de la cuenta para conocer las razones por las cuales se rechazó la transacción.
530	Transacción rechazada error en la información	Al momento de realizar la transacción se presentó un error en el formato de la misma. Comunícate con el equipo de soporte de Kushki para revisar el caso.
514	La cuenta ingresada es inválida	Se deberá verificar que el número de cuenta haya sido ingresado correctamente, que corresponda al banco emisor y reintentar.
594	Operación duplicada	La transacción fue declinada porque existe una coincidencia con otra transacción realizada anteriormente. Comúnmente porque se está enviando el mismo número de referencia.
524	Número de documento inválido	Ingresar nuevamente el tipo y el número de identificación correspondiente a la cuenta y reintentar.
518	El tipo de cuenta es inválido	Verificar que el tipo de cuenta ingresado sea correcto y reintentar.
517	El tipo de operación es inválido	Verificar que el tipo de operación que se desea realizar sea correcto y reintentar.
516	El tipo de pago es inválido	Verificar que el tipo de pago sea correcto y corresponda al tipo de cuenta y reintentar.
513	Monto presenta sintáxis inválida	Es necesario verificar el monto ingresado y reintentar. Por ejemplo, es posible que se hayan ingresado caracteres no permitidos en el monto, como `,` en lugar de `.` para separar decimales.
596	Transacción rechazada por restricciones de terceros	Deberá esperar un par de minutos y reintentar, de lo contrario, use una cuenta alternativa o comuníquese con el emisor de la cuenta para verificar.
515	Transacción rechazada por beneficiario	Deberá ponerse en contacto con el emisor de la cuenta para conocer las razones por las cuales se rechazó la transacción.
560	Monto ingresado supera límite	Deberá validar que el límite de saldo autorizado de la cuenta o el límite de abonos permitidos en el mes en la cuenta no han sido excedidos. Deberá ponerse en contacto con el emisor de la cuenta para conocer las razones o utilizar otra cuenta.