Códigos de error para transacciones declinadas en efectivo

07 febrero 2023

Conoce cómo resolver los diferentes tipos de mensajes de error recibidos durante las transacciones declinadas en efectivo; validación API de Kushki.

¿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 retornados por Kushki para pagos en efectivo

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:

{
    "code": "C001",
    "message": "Cuerpo de la petición inválido."
}

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

code	message	¿Qué hacer?
C001	El cuerpo de la petición es inválido	Revisar el body de la petición
C002	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.
C003	Token inválido	Completar nuevamente los datos y reintentar
C004	Id de comercio no válido	Verificar el public merchant ID o el private merchant ID y reintentar
C005	Id de transacción no válido	Completar nuevamente los datos y reintentar
C006	Monto de la transacción inválido	Verificar el monto a capturar y reintentar
C007	El pin enviado no existe	Verificar el pin y reintentar
C008	La transacción está en un estado no válido	Verificar que la transacción no haya sido pagada previamente o anulada
C009	El pin ya se encuentra en estado de pagado	Ya se ha realizado el pago previamente
K010	Error de integración con un tercero	Comunícate con el equipo de soporte de Kushki para revisar el caso
C011	Error no hay adjuntos en el correo	Internar con otra tarjeta
C012	Estatus de transacción invalido	Verificar el monto a capturar y reintentar
C017	La fecha de expiración no es válida	Comunícate con el equipo de soporte de Kushki para revisar el caso
C018	La transacción no existe o ha sido eliminada	Comunícate con el equipo de soporte de Kushki para revisar el caso
C019	El comercio no tiene businessId	Comunícate con el equipo de soporte de Kushki para revisar el caso
C021	No se encontraron registros para los criterios de búsqueda.	Reintentar la transacción, en caso de que el error persista comunícate con el equipo de soporte de Kushki para revisar el caso
C022	No se puede eliminar esta transacción	Comunícate con el equipo de soporte de Kushki para revisar el caso
C023	No es posible actualizar la transacción	Este mensaje se presenta cuando se trata de hacer un void parcial pero el monto es superior al monto de la venta
C025	El comercio no dispone de procesadores	Comunícate con el equipo de soporte de Kushki para revisar el caso
C026	La validación de firma de la petición falló	Intentar nuevamente la transacción
C032	No existen redes de pago	Comunícate con el equipo de soporte de Kushki para revisar el caso
C033	Transacción previamente anulada	La transacción ya fue anulada
C034	Error de validación Stone webhook	-
C035	El pin generado por el procesador duplicado	El pin está duplicado, intenta generar un nuevo pin
C036	La transacción ya no puede ser reversada	La transacción se encuentra en un estado en el que no se puede reversar
C037	La operación cayó en timeout, por favor inténtelo de nuevo	Intenta nuevamente
C038	El procesador no existe	Comunícate con el equipo de soporte de Kushki para revisar el caso
C040	El ID de comercio no corresponde a la credencial enviada	Se debe enviar un monto mayor a 0 en la propiedad amount.
C041	El comercio no tiene procesadores disponibles	Comunícate con el equipo de soporte de Kushki para revisar el caso

Códigos de estado HTTP

Kushki podrá retornar diferentes códigos de estado HTTP dependiendo de las solicitudes realizadas. Existen cinco categorías de respuestas estándar, descritas en la siguiente imagen:

Códigos de estado HTTP

A continuación te presentamos los códigos de estado HTTP más comunes, su mensaje estándar asociado, así como una descripción más detallada de la respuesta.

Código	Mensaje	Detalle
200	OK	El proceso fue exitoso. Todo funcionó de la manera que se esperaba, según el método HTTP
400	Bad Request	El servidor no puede interpretar la solicitud (sintaxis incorrecta, tamaño demasiado grande, faltan parámetros)
401	Authorization Required	Se deben autenticar las credenciales, o bien, la autenticación ha fallado
403	Forbidden	No se cuenta con los permisos necesarios para realizar esa acción
404	Not Found	Recurso o página no encontrada
409	Conflict	La solicitud no puede ser procesada por un conflicto con el recurso (por ejemplo, múltiples actualizaciones simultáneas)
410	Gone	El recurso solicitado ha sido borrado del servidor, y ya no está ni estará disponible
429	Too Many Requests	Se han enviado demasiadas solicitudes en un tiempo determinado
430	Request Header Fields Too Large	Código no oficial, aplica solo para Shopify. Similar al código 429
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 (comúnmente es porque se encuentra en mantenimiento, o porque está sobrecargado)
504	Gateway Timeout	El servidor (actuando como proxy o gateway) no ha recibido una respuesta del otro servidor a tiempo