Códigos de error

Aprende sobre errores comunes y cómo resolverlos

Aprende cómo manejar los diferentes tipos de mensajes de error recibidos durante las transacciones para cada medio de pago.

¿Qué tipo de códigos de respuesta retorna Kushki?

Kushki retornará dos códigos diferentes de respuesta para indicar el éxito o fallo de las transacciones: processorError y code. El campo code retorna mensajes genéricos. Por su parte, el campo processorError indica que la transacción ha pasado a través del procesador y probablemente ha sido mapeado por Kushki para darte una idea específica de porqué tu transacción no se pudo completar.

Códigos de error genéricos

La API de Kushki realizará validaciones antes de enviar la transacción hacia los procesadores. Si este es el caso, el campo processorError no aparecerá en la respuesta y solo verás el campo code . El siguiente es un ejemplo de un mensaje retornado por el API de Kushki:

{"message": "ID de comercio o credencial no válido",
"code": "K004" }

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

codemessage¿Qué hacer?
K001El cuerpo de la petición es inválidoRevisar el body de la petición
K002Ha ocurrido un error inesperadoReintentar la transacción, en caso de que el error persista comunícate con el equipo de soporte de Kushki para revisar el caso.
K003Tarjeta no habilitada por el emisorIngresar un número de tarjeta diferente y reintentar
K004ID de comercio o credencial no válidoVerificar el public merchant ID o el private merchant ID y reintentar
K005Token expiradoEl token ha sido usado previamente o ha expirado
K006Monto no es igual el esperadoRevisar el valor enviado en el campo amount y reintentar
K007Este recibo ya fue pagadoRevisar la referencia de pago y reintentar
K008Este recibo ya fue canceladoRevisar la referencia de pago
K009Recibo expiradoRevisar la referencia de pago y reintentar
K010Ticket number inválidoRevisar el número de ticket number ingresado y reintentar
K011Credenciales inválidasVerificar el public merchant ID o el private merchant ID y reintentar
K012Acceso no autorizadoEl token ha sido usado previamente o ha expirado
K013Transación tokenizada como diferidoVerificar que la información de cuotas haya sido enviada en la solicitud de cobro
K014Token inválidoVerificar el token enviado y reintentar
K020Transacción rechazadaReintentar la transacción, en caso de que el error persista comunícate con el equipo de soporte de Kushki para revisar el caso
K021Transacción rechazadaEste mensaje se presenta cuando hay un rechazo por parte del motor de validación antifraude
K023Monto del void superior al del saleEste mensaje se presenta cuando se trata de hacer un void parcial pero el monto es superior al monto de la venta
K322Transacción rechazadaLa transacción fue rechazada por una regla de seguridad de Kushki. Comunícate con el equipo de soporte de Kushki para revisar el caso

Códigos de error en pagos con tarjeta de crédito

A continuación te presentamos los códigos de error retornados en el campo processorError, de forma que puedas usar estos para mapear los mensajes de tu aplicación.

Las columnas processorError y message te mostrarán el código de error y mensaje enviado desde Kushki. En la columna ¿Qué hacer? te damos una explicación más detallada de las causas y el posible procedimiento a seguir.

processorErrormessage¿Qué hacer?
501Transacción rechazada. Póngase en contacto con el emisor de su tarjetaEl tarjetahabiente deberá ponerse en contacto con el emisor de su tarjeta para conocer las razones por las cuales se rechazó la transacción
503El número de comercio no está registradoEl número de terminal o código del comercio no está registrado o habilitado en el procesador. Comunícate con el equipo de soporte de Kushki para revisar el caso.
504La tarjeta ingresada ha sido reportada.El tarjetahabiente deberá usar una tarjeta diferente para procesar la transacción y ponerse en contacto con el emisor de su tarjeta para revisar el caso.
505La transacción fue declinada por el procesador o emisor.El tarjetahabiente deberá esperar un par de minutos y reintentar, de lo contrario, usar una tarjeta alternativa.
512Transacción no permitida por el emisor.La Transacción no está permitida por el procesador o el emisor. El tarjetahabiente deberá usar una tarjeta alternativa.
513El monto que ingresó contiene una sintaxis no válidaEs 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.
514El número de tarjeta ingresado no es válidoEl tarjetahabiente deberá verificar que el número de tarjeta haya sido ingresado correctamente y reintentar.
515El emisor no puede autorizar esta transacciónEl procesador o franquicia rechazó el BIN enviado. El tarjetahabiente deberá usar otra tarjeta.
518Has ingresado una tarjeta vencidaLa tarjeta se encuentra caducada o la fecha es incorrecta. El tarjetahabiente deberá revisar que la fecha esté correcta o intentar con otra tarjeta.
519Se produjo un error al procesar la operación. Inténtalo de nuevoEl tarjetahabiente deberá reintentar la transacción.
520El nombre del titular de la tarjeta ingresado no es correctoIngresar nuevamente el nombre del tarjetahabiente y reintentar.
521El apellido del titular de la tarjeta ingresado no es correctoIngresar nuevamente el apellido del tarjetahabiente y reintentar.
522El correo electrónico que ha ingresado no es válido.Ingresar nuevamente el correo electrónico del tarjetahabiente y reintentar.
523El número de la dirección IP es incorrecto.Verificar que la transacción se esté efectuando desde una dirección IP válida.
524El número de identificación que ha ingresado es incorrecto.Ingresar nuevamente el tipo y número de identificación del tarjetahabiente y reintentar.
525La información encriptada no es válidaEl proceso de encriptación de la información no pudo completarse correctamente. Comunícate con el equipo de soporte de Kushki para revisar el caso.
526El comercio no tiene permiso para procesar una transacciónSe debe a una restricción del procesador al comercio. Comunícate con el equipo de soporte de Kushki para revisar el caso.
527El monto enviado no puede ser ceroEl monto de esta transacción no puede ser cero. Se debe ingresar un monto diferente y reintentar.
528Monto de la transacción es diferente al monto de la venta inicialEl monto enviando en el token debe ser igual al de la compra. Será necesario asegurarse que el monto a pagar sea el correcto.
529No ha sido posible encontrar la transacciónAl realizar el reverso o anulación no fue posible encontrar el mensaje original. Comunícate con el equipo de soporte de Kushki para revisar el caso.
530Transacción rechazada por error de formatoAl 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.
541Esta tarjeta ha sido reportada como perdidaEl tarjetahabiente deberá usar una tarjeta diferente para procesar la transacción y ponerse en contacto con el emisor de su tarjeta para revisar el caso.
543Esta tarjeta ha sido reportada como robadaEl tarjetahabiente deberá usar una tarjeta diferente para procesar la transacción y ponerse en contacto con el emisor de su tarjeta para revisar el caso.
551No hay fondos suficientes para completar la operación.El tarjetahabiente deberá usar una tarjeta diferente para procesar la transacción ya que la tarjeta ingresada no cuenta con los fondos suficientes para procesar la transacción.
552El tipo de cuenta ingresado no es válidoEl tarjetahabiente deberá verificar el tipo de cuenta seleccionada e internar nuevamente.
553La tarjeta no es compatibleLa marca de la tarjeta ingresada no es compatible para poder efectuar la autorización. El tarjetahabiente deberá usar una tarjeta diferente para procesar la transacción.
554El tipo de moneda no es válidoEl procesador o emisor no acepta transacciones en la moneda seleccionada. Comunícate con el equipo de soporte de Kushki para revisar el caso.
555La solicitud enviada no es válidaHa existido una novedad en la solicitud de la transacción que se ha realizado. Comunícate con el equipo de soporte de Kushki para revisar el caso.
556La transacción se encuentra anuladaLa transacción que se está intentando anular o reversar ya fue anulada anteriormente
557El emisor no puede autorizar esta transacciónPor restricciones del emisor no es posible autorizar la Transacción. El tarjetahabiente deberá cambiar de tarjeta o medio de pago y ponerse en contacto con el emisor de su tarjeta para revisar el caso.
558Transacción no permitida al comercioPor restricciones del procesador no es posible autorizar la Transacción al comercio. Comunícate con el equipo de soporte de Kushki para revisar el caso.
559La transacción ha sido considerada como una sospecha de fraudeLa transacción que se ha realizado fue declinada por el procesador o emisor por sospecha de fraude.
560El monto ingresado es menor o mayor de lo permitidoEl monto enviado en la transacción es menor o mayor a los límites que han sido establecidos. El tarjetahabiente deberá verificar el monto de la transacción y reintentar.
561Se ha excedido el límite diario de transaccionesEl tarjetahabiente ha superado el límite de actividad en cantidad o monto de transacciones diarias
562Tarjeta restringida por el emisorEl emisor ha declinado la transacción porque aplicó restricciones al tarjetahabiente. El tarjetahabiente deberá ponerse en contacto con el emisor de su tarjeta para revisar el caso.
563Operación rechazada por violación de seguridadEl emisor o procesador declinó la transacción porque existe una violación de seguridad.
564El token ingresado no es válido o ha expiradoEl token que se está usando no posee un formato válido, no existe o ya fue usado en una transacción
565La transacción fue declinada por reglas de seguridadLa transacciones está siendo declinada por reglas de seguridad configuradas a la tarjeta o al comercio
566El token es inváalido , o ya fue usado en otra transacciónEl token que se está usando no posee un formato válido, no existe o ya fue usado en una transacción. Comunícate con el equipo de soporte de Kushki para revisar el caso.
567El monto de la transacción es requeridoEs obligatorio enviar un valor en el campo “amount”.
568El número de ticket de la transacción no es válidoIngresa nuevamente el número de ticket, si el error persiste, comunícate con el equipo de soporte de Kushki para revisar el caso.
579La fecha de vencimiento ingresada es incorrectaEl tarjetahabiente deberá ingresar nuevamente la fecha de vencimiento e intentar otra vez.
580El diferido enviado no es correctoEl tipo de diferido o formato del diferido que se está empleando no es el correcto. Comunícate con el equipo de soporte de Kushki para revisar el caso.
581Las credenciales no son correctasVerífica las credenciales enviadas e íntentalo de nuevo
582El número de seguridad (cvv2) ingresado no es correctoEl tarjetahabiente deberá ingresar nuevamente el código de seguridad y reintentar la transacción.
583La operación ya se canceló o se alcanzó el tiempo máximo para revertirNo es posible cancelar o revertir la transacción porque ya fue cancelada, no se encontró la transacción original , o se ha cumplido el tiempo máximo permitido para poder reversarla. Comunícate con el equipo de soporte de Kushki para revisar el caso.
591Transacción no autorizada. Emisor inoperativoEsperar un par de minutos y reintentar, de lo contrario, usar una tarjeta alternativa.
594La transacción rechazada parece ser una operación duplicadaLa 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.
596El emisor ha tenido un problema al autorizar la transacción.El tarjetahabiente deberá esperar un par de minutos y reintentar, de lo contrario, usar una tarjeta alternativa o comunicarse con el emisor de la tarjeta para verificar.