Códigos de error para transacciones con tarjeta presente

14 octubre 2024

Te contamos los errores comunes en las transacciones con tarjeta presente y cómo solucionarlos.

Códigos de estado HTTP

Te mostramos a continuación cuáles son los códigos de estado HTTP más comunes, su mensaje estándar asociado, así como una descripción de la respuesta.

A continuación te mostramos los códigos que podrías recibir.

Código	Mensaje	Detalle
200	OK	El proceso fue exitoso; este funcionó como se esperaba, según el método HTTP.
400	Bad Request (Solicitud incorrecta)	El servidor no puede interpretar la solicitud (sintaxis incorrecta, tamaño demasiado grande, parámetros faltantes).
401	Authorization Required (Autorización requerida)	Las credenciales deben estar autenticadas o la autenticación falló.
403	Forbidden (Prohibido)	No se tienen los permisos necesarios para realizar esta acción.
404	Not Found (No encontrado)	Recurso o página no encontrada.
409	Conflict (Conflicto)	El requerimiento no puede ser procesado debido a un conflicto con el recurso (e.j. múltiples actualizaciones simultáneas.
410	Gone (No disponible)	El recurso solicitado ha sido eliminado del servidor y ya no estará disponible.
412	Precondition failed (Condición previa falló)	Indica que se ha denegado el acceso al recurso de destino.
429	Too Many Requests (Demasiadas solicitudes)	Se han enviado demasiadas solicitudes en un corto período de tiempo.
430	Request Header Fields Too Large (Los campos del encabezado de solicitud son demasiado grandes)	Este código de estado indica que el servidor no está dispuesto a procesar la solicitud porque sus campos de encabezado son demasiado grandes.
500	Internal Server Error (Error interno del servidor)	Se produjo un error inesperado en el servidor.
502	Bad Gateway (Puerta de enlace incorrecta)	El servidor (que actúa como proxy o puerta de enlace) recibió una respuesta no válida de otro servidor
503	Service Temporarily Unavailable (Servicio temporalmente no disponible)	El servidor no está disponible (normalmente porque está en mantenimiento o porque está sobrecargado).
504	Gateway Timeout (Tiempo de espera de puerta de enlace)	El servidor (que actúa como proxy o puerta de enlace) no ha recibido una respuesta del otro servidor a tiempo.

Códigos retornados por Kushki en transacciones con tarjeta presente

Los códigos de respuesta recibidos por los procesadores y emisores aparecerán en el objeto kushki_response, tal como en el siguiente ejemplo.

“kushki_response": {
        "code": "01",
        "message": "Refer to card issuer"
    },

A continuación encuentra la información de los códigos y mensajes enviados por Kushki para describir los códigos de respuesta de la solicitud realizada con transacciones con tarjeta presente. En la columna “¿Qué hacer?” encontrarás una explicación detallada de las causas y el procedimiento que debes realizar.

Código	Mensaje	¿Qué hacer?
000	Approved or completed successfully (Aprobado o completado exitosamente)	Indica que la transacción fue aprobada exitosamente.
01	Refer to card issuer (Comuniquese con la compañía que expidió la tarjeta)	El titular de la tarjeta debe comunicarse con el emisor de su tarjeta para comprender por qué se rechazó la transacción.
04	Capture card (Capturar tarjeta)	El titular de la tarjeta debe utilizar una tarjeta diferente para procesar la transacción y comunicarse con el emisor de su tarjeta para que revise el caso.
05	Do not honor (La transacción no fue aceptada)	El titular de la tarjeta debe volver a intentar la transacción.
06	Error	El titular de la tarjeta debe llamar al banco emisor para aclarar el problema (y aumentar su crédito si el problema es el límite de crédito).
09	Request in process (duplicate) (Solicitud en curso [duplicado])	La transacción no está permitida por el procesador de pagos ni por el emisor de la tarjeta. El titular de la tarjeta debe utilizar una tarjeta alternativa.
10	Approved partial (Parcialmente aprobado)	El titular de la tarjeta debe utilizar una tarjeta alternativa de un emisor diferente.
12	Invalid transaction (Transacción inválida)	El titular de la tarjeta ha solicitado cancelar la transacción.
15	The issuer cannot authorize this transaction (El emisor no puede autorizar esta transacción)	El titular debe usar otra tarjeta.
17	No such issuer (No existe tal emisor)	Al momento de realizar la transacción ocurrió un error de formato.
1A	Additional customer authentication required (Se requiere autenticación adicional del cliente)	El titular de la tarjeta debe usar una tarjeta diferente para procesar la transacción y comunicarse con el emisor de su tarjeta para que revise el caso.
32	Expired card (Tarjeta expirada)	El titular de la tarjeta debe utilizar una tarjeta diferente para procesar la transacción y comunicarse con el emisor de su tarjeta para que revise el caso.
34	Suspected fraud (Sospecha de fraude)	El titular de la tarjeta debe utilizar una tarjeta diferente para procesar la transacción y comunicarse con el emisor de su tarjeta para que revise el caso.
35	Card acceptor contact acquirer (Aceptante de tarjetas debe contactar al adquirente)	El titular de la tarjeta debe utilizar una tarjeta diferente para procesar la transacción y comunicarse con el emisor de su tarjeta para que revise el caso.
37	Card acceptor call acquirer security (Aceptante de tarjeta solicita seguridad del adquirente)	Debe utilizar otra tarjeta
39	No credit account (Sin cuenta de crédito)	El titular de la tarjeta debe utilizar una tarjeta diferente para procesar la transacción y comunicarse con el emisor de su tarjeta para que revise el caso.
41	Lost card (Tarjeta perdida)	El titular de la tarjeta debe comunicarse con el emisor de su tarjeta para comprender por qué se rechazó la transacción.
51	Not sufficient funds (Sin fondos suficientes)	El titular de la tarjeta debe utilizar otra tarjeta.
54	Expired card (Tarjeta expirada)	El titular de la tarjeta debe utilizar otra tarjeta.
57	Transaction not permitted to cardholder (La transacción no es permitida al titular de la tarjeta)	El titular de la tarjeta debe utilizar una tarjeta diferente para procesar la transacción y comunicarse con el emisor de su tarjeta para que revise el caso.
59	Suspected fraud (Sospecha de fraude)	El emisor solicitó cambiar el PIN pero no se completó exitosamente
61	Exceeds withdrawal amount limit (Excede el límite de monto de retiro)	El titular de la tarjeta debe utilizar otra tarjeta.
62	Restricted card (Tarjeta restringida)	El titular de la tarjeta debe volver a intentarlo o utilizar una tarjeta alternativa.
6P	Verification data failed (Los datos de verificación fallaron)	El titular de la tarjeta debe volver a intentarlo o utilizar una tarjeta alternativa de un emisor diferente.
75	Allowable number of PIN tries exceeded (Se superó el número permitido de intentos de PIN)	Póngase en contacto con el emisor para obtener más información.
78	Invalid/nonexistent account specified (general) (Cuenta especificada no válida/inexistente (general)	La transacción fue rechazada porque se encontró una coincidencia con otra transacción anterior.
80	No financial impact (Sin impacto financiero)	El titular de la tarjeta debe volver a intentarlo o utilizar una tarjeta alternativa de un emisor diferente.
81	Cryptographic error found in PIN (used for cryptographic error condition found by security module during PIN decryption) Se encontró un error criptográfico en el PIN (se utiliza para la condición de error criptográfico encontrada por el módulo de seguridad durante el descifrado del PIN)	El titular de la tarjeta debe utilizar una tarjeta alternativa.
86	Cannot verify PIN; for instance, no PVV (No se puede verificar el PIN; por ejemplo, sin PVV)	Un mensaje de Visa solicitando autenticación adicional por parte del titular de la tarjeta.
89	Unacceptable PIN— Transaction Declined— Retry (PIN inaceptable: transacción rechazada: reintentar)	Reintentar la transacción.
91	Authorization System or issuer system inoperative (Sistema de autorización o sistema emisor inoperativo)	Vuelva a intentar la transacción o use una tarjeta diferente.
92	Unable to route transaction (No se puede enrutar la transacción)
93	Transaction cannot be completed- violation of law. (La transacción no se puede completar: violación de la ley).
U1	Security module parameter error. (Error de parámetro del módulo de seguridad)

Códigos retornados por Kushki en cancelaciones e intentos de reversión

Los códigos de respuesta recibidos por los procesadores y emisores aparecerán en el objeto kushki_response, tal como en el siguiente ejemplo.

"kushki_response": {
        "code": "01",
        "message": "Refer to card issuer"
    },

Código	Mensaje	¿Qué hacer?
000	Approved Transaction (Transacción aprobada)	Indica que la transacción fue aprobada exitosamente.
01	Refer to card issuer (Comuníquese con la compañía que expidió la tarjeta)	El titular de la tarjeta debe comunicarse con el emisor de su tarjeta para comprender por qué se rechazó la transacción.
04	Capture card (Capturar tarjeta)	El titular de la tarjeta debe volver a intentar la transacción.
05	Do not honor (La transacción no fue aceptada)	El titular de la tarjeta debe volver a intentar la transacción.
12	Invalid transaction (Transacción inválida)	La transacción no está permitida por el procesador de pagos ni por el emisor de la tarjeta. Póngase en contacto con el emisor de la tarjeta.
32	Expired card (Tarjeta expirada)	El titular de la tarjeta debe utilizar una tarjeta alternativa.
41	Lost card (Tarjeta perdida)	El titular de la tarjeta debe comunicarse con el emisor de su tarjeta para que revise el caso.
57	Transaction not permitted to cardholder (La transacción no está permitida para el titular de la tarjeta)	El titular de la tarjeta debe comunicarse con el emisor de su tarjeta para que revise el caso.
62	Restricted card (Tarjeta restringida)	El titular de la tarjeta debe comunicarse con el emisor de su tarjeta para que revise el caso.
91	Authorization System or issuer system inoperative (Sistema de autorización o sistema emisor inoperativo)	El titular de la tarjeta debe volver a intentar la transacción.
92	Unable to route transaction (No se puede enrutar la transacción)	El titular de la tarjeta debe volver a intentarlo o contactar al emisor.
6P	Verification data failed (Los datos de verificación fallaron)	Reintentar la transacción.
E016	Refund not available (Reembolso no disponible)	Comprueba que el reembolso está dentro del plazo permitido

Datos de prueba

Realiza los ajustes necesarios en tu sistema con los datos de prueba.