Catálogo de errores de Kushki para transacciones POS

Este catálogo describe las posibles respuestas de la API para distintos escenarios de transacción, incluidos los códigos de estado, los mensajes y las descripciones. Cubre los rechazos de emisores y marcas cuando las transacciones se evalúan de forma externa, para ayudarte a entender mejor las aprobaciones y los rechazos.

Códigos de estado HTTP

Kushki puede devolver distintos códigos de estado HTTP según las solicitudes que realices. A continuación están los códigos de estado HTTP más comunes, su mensaje estándar asociado y una descripción más detallada de la respuesta.

Código	Mensaje	Detalle
200	OK	El proceso fue exitoso. Todo funcionó como se esperaba, según el método HTTP
400	Bad Request	El servidor no puede interpretar la solicitud (sintaxis incorrecta, tamaño excesivo, parámetros faltantes)
401	Authorization Required	Las credenciales deben autenticarse, o la autenticación falló
403	Forbidden	No cuentas con los permisos necesarios para realizar esta acción
404	Not Found	Recurso o página no encontrada
409	Conflict	La solicitud no se puede procesar por un conflicto con el recurso (por ejemplo, múltiples actualizaciones simultáneas)
410	Gone	El recurso solicitado fue eliminado del servidor y ya no estará disponible
412	Precondition failed	Indica que se denegó el acceso al recurso de destino
429	Too Many Requests	Se enviaron demasiadas solicitudes en un periodo corto de tiempo
430	Request Header Fields Too Large	Este código de estado indica que el servidor no está dispuesto a procesar la solicitud porque sus campos de cabecera son demasiado grandes.
500	Internal Server Error	Ocurrió un error inesperado del lado del servidor
502	Bad Gateway	El servidor (actuando como proxy o gateway) recibió una respuesta inválida de otro servidor
503	Service Temporarily Unavailable	El servidor no está disponible (normalmente porque está en mantenimiento o porque está sobrecargado)
504	Gateway Timeout	El servidor (actuando como proxy o gateway) no recibió a tiempo una respuesta del otro servidor

Códigos devueltos por Kushki en cargos POS

Los códigos de respuesta recibidos de procesadores y emisores aparecen en el objeto kushki_response, como en el siguiente ejemplo

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

Error 006

Este código de error aparece cuando Kushki bloquea la tarjeta, por ejemplo si la marca no está soportada.

"kushki_response": {
        "code": "006",
        "message": "Card brand not supported"
    },

Si el código viene de las marcas de tarjeta (Visa o Mastercard), tendrá dos dígitos. A continuación encontrarás los códigos de respuesta más comunes, incluidas las declinaciones:

Mastercard

Visa

Código de error ISO	Descripción
00	Approved or completed successfully
01	Refer to card issuer
03	Invalid merchant
04	Capture card
05	Do not honor
08	Honor with ID
10	Partial Approval
12	Invalid transaction
13	Invalid amount
14	Invalid card number
15	Invalid issuer
30	Format error
41	Lost card
43	Stolen card
51	Insufficient funds/over credit limit
54	Expired card
55	Invalid PIN
57	Transaction not permitted to issuer/cardholder
58	Transaction not permitted to acquirer/terminal
61	Exceeds withdrawal amount limit
62	Restricted card
63	Security violation
65	Exceeds withdrawal count limit OR Identity Check Soft-Decline of EMV 3DS Authentication (merchant should resubmit authentication with 3DSv1)
70	Contact Card
71	Issuer PIN Not Changed
75	Allowable number of PIN tries exceeded
76	Invalid/nonexistent "To Account" specified
77	Invalid/nonexistent "From Account" specified
78	Invalid/nonexistent account specified (general)
79	Life cycle (Mastercard use only for 0110 messages)
81	Domestic Debit Transaction Not Allowed (Regional use only)
82	Policy (Mastercard use only for 0110 messages)
83	Fraud/Security (Mastercard use only for 0110 messages)
84	Invalid Authorization Life Cycle
85	Not declined Valid for all zero amount transactions.
86	PIN Validation not possible
87	Purchase Amount Only, No Cash Back Allowed
88	Cryptographic failure
89	Unacceptable PIN— Transaction Declined— Retry
91	Authorization System or issuer system inoperative
92	Unable to route transaction
94	Duplicate transmission detected
96	System error

CÓDIGO	MENSAJE	¿QUÉ HACER?
000	Approved or completed successfully	Indica que la transacción se aprobó correctamente.
01	Refer to card issuer	El tarjetahabiente debe contactar a su emisor para entender por qué se rechazó la transacción
04	Capture card	El tarjetahabiente debe usar otra tarjeta para procesar la transacción y contactar a su emisor para que revise el caso
05	Do not honor	El tarjetahabiente debe reintentar la transacción
06	Error	El tarjetahabiente debe llamar al banco emisor para aclarar el problema (y aumentar su cupo si el problema es el límite de crédito)
09	Request in progress (duplicate)	La transacción no está permitida por el procesador de pagos o por el emisor de la tarjeta. El tarjetahabiente debe usar una tarjeta alternativa
10	Approved partial	El tarjetahabiente debe usar una tarjeta alternativa de otro emisor
12	Invalid transaction	El tarjetahabiente solicitó cancelar la transacción
15	El emisor no puede autorizar esta transacción	El tarjetahabiente debe usar una tarjeta alternativa
17	No such issuer	Al momento de realizar la transacción ocurrió un error de formato.
1A	Additional customer authentication required	El tarjetahabiente debe usar otra tarjeta para procesar la transacción y contactar a su emisor para que revise el caso
32	Expired card	El tarjetahabiente debe usar otra tarjeta para procesar la transacción y contactar a su emisor para que revise el caso
34	Suspected fraud	El tarjetahabiente debe usar otra tarjeta para procesar la transacción y contactar a su emisor para que revise el caso
35	Card acceptor contact acquirer	El tarjetahabiente debe usar otra tarjeta para procesar la transacción y contactar a su emisor para que revise el caso
37	Card acceptor call acquirer security	Usa una tarjeta alternativa
39	No credit account	El tarjetahabiente debe usar otra tarjeta para procesar la transacción y contactar a su emisor para que revise el caso
41	Lost card	El tarjetahabiente debe contactar a su emisor para entender por qué se rechazó la transacción
51	Not sufficient funds	El tarjetahabiente debe usar una tarjeta alternativa
54	Expired card	El tarjetahabiente debe usar una tarjeta alternativa
57	Transaction not permitted to cardholder	El tarjetahabiente debe usar otra tarjeta para procesar la transacción y contactar a su emisor para que revise el caso
59	Suspected fraud	El emisor solicitó cambiar el PIN pero no se completó correctamente
61	Exceeds withdrawal amount limit	El tarjetahabiente debe usar una tarjeta alternativa
62	Restricted card	El tarjetahabiente debe reintentar o usar una tarjeta alternativa
6P	Verification data failed	El tarjetahabiente debe reintentar o usar una tarjeta alternativa de otro emisor
75	Allowable number of PIN tries exceeded *	Contacta al emisor para más información
78	Invalid/nonexistent account specified (general)	La transacción se rechazó porque se encontró una coincidencia con otra transacción previa
80	No financial impact	El tarjetahabiente debe reintentar o usar una tarjeta alternativa de otro emisor
81	Cryptographic error found in PIN (used for cryptographic error condition found by security module during PIN decryption)	El tarjetahabiente debe usar una tarjeta alternativa
86	Cannot verify PIN; for instance, no PVV	Un mensaje de Visa que solicita autenticación adicional del tarjetahabiente
89	Unacceptable PIN— Transaction Declined— Retry	Reintenta la transacción
91	Authorization System or issuer system inoperative	Reintenta la transacción o usa una tarjeta diferente
92	Unable to route transaction
93	Transaction cannot be completed- violation of law.
U1	Security module parameter error

Códigos devueltos por Kushki en intentos de anulación y reverso

Los códigos de respuesta recibidos de procesadores y emisores aparecen en el objeto kushki_response, como en el siguiente ejemplo.

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

En las columnas código y mensaje de la tabla siguiente se muestran el código y el mensaje enviados por Kushki. En la columna ¿Qué hacer? te damos una explicación más detallada de las causas y del posible procedimiento a seguir.

A continuación se muestra un ejemplo de un mensaje devuelto por la API de Kushki:

código	mensaje	¿Qué hacer?
000	Transacción Aprobada.	Indica que la transacción se aprobó correctamente.
01	Refer to card issuer	El tarjetahabiente debe contactar a su emisor para entender por qué se rechazó la transacción
04	Capture card	El tarjetahabiente debe reintentar la transacción
05	Do not honor	El tarjetahabiente debe reintentar la transacción
12	Invalid transaction	La transacción no está permitida por el procesador de pagos o por el emisor de la tarjeta. Contacta al emisor de la tarjeta
32	Expired card	El tarjetahabiente debe usar una tarjeta alternativa
41	Lost card	El tarjetahabiente debe contactar a su emisor para que revise el caso
57	Transaction not permitted to cardholder	El tarjetahabiente debe contactar a su emisor para que revise el caso
62	Restricted card	El tarjetahabiente debe contactar a su emisor para que revise el caso
91	Authorization System or issuer system inoperative	El tarjetahabiente debe reintentar la transacción
92	Unable to route transaction	El tarjetahabiente debe reintentar o contactar al emisor
6P	Verification data failed	Reintenta la transacción
E016	Refund not available	Verifica que el reembolso esté dentro del periodo permitido

Catálogo de errores de Kushki para transacciones POS

Códigos de estado HTTP#

Códigos devueltos por Kushki en cargos POS#

Error 006#

Códigos devueltos por Kushki en intentos de anulación y reverso#

Códigos de estado HTTP

Códigos devueltos por Kushki en cargos POS

Error 006

Códigos devueltos por Kushki en intentos de anulación y reverso