Códigos de error pagos únicos con tarjeta
¿Qué tipo de códigos de respuesta retorna Kushki?
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 retornados por Kushki para pagos únicos con tarjeta
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" }code.| code | message | ¿Qué hacer? |
|---|---|---|
| 006 | Transacción abandonada | - |
| 017 | Tarjeta no válida | Intentar con otra tarjeta |
| 201 | ID de comercio no válido | Revisar las credenciales enviadas y reintentar |
| 228 | Procesador inalcanzable | No fue posible establecer comunicación con el procesador |
| 228 | Procesador inalcanzable | No fue posible establecer comunicación con el procesador |
| 577 | El token de la transacción no es válido | Enviar nuevamente los datos para obtener un nuevo token |
| 621 | Transaccion cancelada por el usuario | - |
| 622 | Tiempo se sesión expirado | Intentar nuevamente la transacción |
| 703 | El monto de la transacción es requerido | Asegurarse de enviar el monto y reuintentar |
| K001 | El cuerpo de la petición es inválido | Revisar el body de la petición |
| K002 | Ha ocurrido un error inesperado | Reintentar la transacción, en caso de que el error persista comunícate con el equipo de soporte de Kushki para revisar el caso. |
| K003 | Procesador no existe | Comunícate con el equipo de soporte de Kushki para revisar el caso |
| K004 | Id de comercio no válido | Verificar el public merchant ID o el private merchant ID y reintentar |
| K005 | Id de procesador no válido | Comunícate con el equipo de soporte de Kushki para revisar el caso |
| K007 | Tarjeta bloqueada por el emisor | Internar con otra tarjeta |
| K008 | Token incorrecto | Completar nuevamente los datos y reintentar |
| K009 | Review SSM variables | Completar nuevamente los datos y reintentar |
| K011 | Bin no válido | Interna con otra tarjeta |
| K012 | Monto de captura inválido | Verificar el monto a capturar y reintentar |
| K013 | Error en integración con un tercero | Este error podría haberse originado porque la transacción excedió el tiempo de espera |
| K015 | CVV2_REJECTED_TRANSACTION | Verificar el CVV y reintentar |
| K016 | Método no implementado | Comunícate con el equipo de soporte de Kushki para revisar el caso |
| K020 | ERROR_REJECTED_TRANSACTION | Reintentar la transacción, en caso de que el error persista comunícate con el equipo de soporte de Kushki para revisar el caso |
| K021 | ERROR_REJECTED_TRANSACTION | Reintentar la transacción, en caso de que el error persista comunícate con el equipo de soporte de Kushki para revisar el caso |
| K023 | Monto del void superior al del sale | Este mensaje se presenta cuando se trata de hacer un void parcial pero el monto es superior al monto de la venta |
| K025 | Tarjeta inválida | Intentar con otra tarjeta |
| K026 | Processor Declined | Comunícate con el equipo de soporte de Kushki para revisar el caso |
| K027 | La operación cayó en timeout, por favor inténtelo de nuevo | Intenta nuevamente la transacción |
| K028 | El comercio no tiene habilitado la opción de diferidos | - |
| K029 | Bin de tarjeta inválido | Interna con otra tarjeta |
| K030 | Procesador inalcanzable | Intenta nuevamente la transacción |
| K038 | No se puede realizar un void parcial sin especificar el valor a sustraer | Especificar el objecto amount |
| K039 | La suma de los valores de la propiedad amount debe ser mayor a 0 | Se debe enviar un monto mayor a 0 en la propiedad amount. |
| K040 | El ID de comercio no corresponde a la credencial enviada | Se debe enviar un monto mayor a 0 en la propiedad amount. |
| K041 | Operación no permitida | Comunícate con el equipo de soporte de Kushki para revisar el caso |
| K042 | El código de moneda es diferente al de la transacción inicial. | Este mensaje se presenta cuando se envía un código de moneda diferente al de la transacción inicial. Envía el código de moneda correcto. |
| K047 | Ha ocurrido un error inesperado | Intenta nuevamente la transacción |
| K048 | Token expirado | Envía los datos e intenta nuevamente la transacción |
| K049 | Token utilizado anteriormente | Envía los datos e intenta nuevamente la transacción |
| K051 | Transacción de captura realizada anteriormente | No es posible realizar la captura nuevamente |
| K220 | Monto de la transacción es diferente al monto de la venta inicial | El monto enviando en el token debe ser igual al de la compra. Será necesario asegurarse que el monto a pagar sea el correcto. |
| K322 | Transacción rechazada | La 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 cuando la transacción viaja al procesador
processorError, de forma que puedas usar estos para mapear los mensajes de tu aplicación.Tip
K006 en el campo processorError, ponte en contacto con nuestro equipo de soporte, para que podamos verificar la causa.| processorError | message | ¿Qué hacer? |
|---|---|---|
| 501 | Transacción rechazada. Póngase en contacto con el emisor de su tarjeta | El tarjetahabiente deberá ponerse en contacto con el emisor de su tarjeta para conocer las razones por las cuales se rechazó la transacción |
| 503 | El número de comercio no está registrado | El 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. |
| 504 | La 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. |
| 505 | La 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. |
| 512 | Transacció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. |
| 513 | El monto que ingresó contiene una sintaxis no vá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. |
| 514 | El número de tarjeta ingresado no es válido | El tarjetahabiente deberá verificar que el número de tarjeta haya sido ingresado correctamente y reintentar. |
| 515 | El emisor no puede autorizar esta transacción | El procesador o franquicia rechazó el BIN enviado. El tarjetahabiente deberá usar otra tarjeta. |
| 518 | Has ingresado una tarjeta vencida | La tarjeta se encuentra caducada o la fecha es incorrecta. El tarjetahabiente deberá revisar que la fecha esté correcta o intentar con otra tarjeta. |
| 519 | Se produjo un error al procesar la operación. Inténtalo de nuevo | El tarjetahabiente deberá reintentar la transacción. |
| 520 | El nombre del titular de la tarjeta ingresado no es correcto | Ingresar nuevamente el nombre del tarjetahabiente y reintentar. |
| 521 | El apellido del titular de la tarjeta ingresado no es correcto | Ingresar nuevamente el apellido del tarjetahabiente y reintentar. |
| 522 | El correo electrónico que ha ingresado no es válido. | Ingresar nuevamente el correo electrónico del tarjetahabiente y reintentar. |
| 523 | El número de la dirección IP es incorrecto. | Verificar que la transacción se esté efectuando desde una dirección IP válida. |
| 524 | El número de identificación que ha ingresado es incorrecto. | Ingresar nuevamente el tipo y número de identificación del tarjetahabiente y reintentar. |
| 525 | La información encriptada no es válida | El 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. |
| 526 | El comercio no tiene permiso para procesar una transacción | Se debe a una restricción del procesador al comercio. Comunícate con el equipo de soporte de Kushki para revisar el caso. |
| 527 | El monto enviado no puede ser cero | El monto de esta transacción no puede ser cero. Se debe ingresar un monto diferente y reintentar. |
| 528 | Monto de la transacción es diferente al monto de la venta inicial | El monto enviando en el token debe ser igual al de la compra. Será necesario asegurarse que el monto a pagar sea el correcto. |
| 529 | No ha sido posible encontrar la transacción | Al 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. |
| 530 | Transacción rechazada por error de formato | 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. |
| 541 | Esta tarjeta ha sido reportada como perdida | 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. |
| 543 | Esta tarjeta ha sido reportada como robada | 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. |
| 551 | No 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. |
| 552 | El tipo de cuenta ingresado no es válido | El tarjetahabiente deberá verificar el tipo de cuenta seleccionada e internar nuevamente. |
| 553 | La tarjeta no es compatible | La 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. |
| 554 | El tipo de moneda no es válido | El procesador o emisor no acepta transacciones en la moneda seleccionada. Comunícate con el equipo de soporte de Kushki para revisar el caso. |
| 555 | La solicitud enviada no es válida | Ha 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. |
| 556 | La transacción se encuentra anulada | La transacción que se está intentando anular o reversar ya fue anulada anteriormente |
| 557 | El emisor no puede autorizar esta transacción | Por 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. |
| 558 | Transacción no permitida al comercio | Por 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. |
| 559 | La transacción ha sido considerada como una sospecha de fraude | La transacción que se ha realizado fue declinada por el procesador o emisor por sospecha de fraude. |
| 560 | El monto ingresado es menor o mayor de lo permitido | El 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. |
| 561 | Se ha excedido el límite diario de transacciones | El tarjetahabiente ha superado el límite de actividad en cantidad o monto de transacciones diarias |
| 562 | Tarjeta restringida por el emisor | El 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. |
| 563 | Operación rechazada por violación de seguridad | El emisor o procesador declinó la transacción porque existe una violación de seguridad. |
| 564 | El token ingresado no es válido o ha expirado | El token que se está usando no posee un formato válido, no existe o ya fue usado en una transacción |
| 565 | La transacción fue declinada por reglas de seguridad | La transacciones está siendo declinada por reglas de seguridad configuradas a la tarjeta o al comercio |
| 566 | El token es inváalido , o ya fue usado en otra transacción | El 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. |
| 567 | El monto de la transacción es requerido | Es obligatorio enviar un valor en el campo “amount”. |
| 568 | El número de ticket de la transacción no es válido | Ingresa nuevamente el número de ticket, si el error persiste, comunícate con el equipo de soporte de Kushki para revisar el caso. |
| 579 | La fecha de vencimiento ingresada es incorrecta | El tarjetahabiente deberá ingresar nuevamente la fecha de vencimiento e intentar otra vez. |
| 580 | El diferido enviado no es correcto | El 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. |
| 581 | Las credenciales no son correctas | Verífica las credenciales enviadas e íntentalo de nuevo |
| 582 | El número de seguridad (cvv2) ingresado no es correcto | El tarjetahabiente deberá ingresar nuevamente el código de seguridad y reintentar la transacción. |
| 583 | La operación ya se canceló o se alcanzó el tiempo máximo para revertir | No 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. |
| 591 | Transacción no autorizada. Emisor inoperativo | Esperar un par de minutos y reintentar, de lo contrario, usar una tarjeta alternativa. |
| 594 | La transacción rechazada parece ser una 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. |
| 596 | El 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. |
Modificado en 2026-09-23 15:13:50