Códigos de error

17 febrero 2025

Aprende sobre errores comunes y cómo solucionarlos.

Códigos de Estado HTTP

Kushki puede devolver diferentes códigos de estado HTTP dependiendo de las solicitudes realizadas. A continuación, se presentan 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 demasiado grande, parámetros faltantes).
401	Authorization Required	Se deben autenticar las credenciales o la autenticación ha fallado.
403	Forbidden	No tienes los permisos necesarios para realizar esta acción.
404	Not Found	Recurso o página no encontrada.
409	Conflict	La solicitud no puede procesarse debido a un conflicto con el recurso (por ejemplo, múltiples actualizaciones simultáneas).
410	Gone	El recurso solicitado ha sido eliminado del servidor y ya no estará disponible.
412	Precondition failed	Indica que se ha denegado el acceso al recurso objetivo.
429	Too Many Requests	Se han enviado demasiadas solicitudes en un corto período de tiempo.
430	Request Header Fields Too Large	Este código de estado indica que el servidor no procesará la solicitud porque los campos de su encabezado son demasiado grandes.
500	Internal Server Error	Ocurrió un error inesperado en el servidor.
502	Bad Gateway	El servidor (que actúa como proxy o puerta de enlace) recibió una respuesta no válida de otro servidor.
503	Service Temporarily Unavailable	El servidor no está disponible (generalmente debido a mantenimiento o sobrecarga).
504	Gateway Timeout	El servidor (que actúa como proxy o puerta de enlace) no recibió una respuesta a tiempo del otro servidor.

Códigos de error en el servicio de creación de solicitudes de pago

En caso de error al generar una solicitud de pago, se devolverá una respuesta como la siguiente:

{
  "error": true,
  "code": "MR-110",
  "message": "Transaction Amount is less than allowed minimum"
}

La siguiente tabla describe los errores más comunes durante el proceso de generación de una solicitud de pago:

Código	Tipo	Mensaje
MR-100	Dispositivo	Device for API-Key doesn’t exist
MR-110	Campo de entrada	Transaction Amount is less than allowed minimum
MR-120	Campo de entrada	Transaction Amount is more than allowed
MR-130	Campo de entrada	DTE type not recognized
MR-140	Campo de entrada	No exempt amount found for DTE Type 99
MR-141	Campo de entrada	Exempt amount not equal to transaction amount
MR-150	Campo de entrada	Exempt Amount is not less than transaction amount
MR-151	Campo de entrada	Exempt Amount is invalid
MR-000	Autorización	Not Authorized
MR-160	Solicitud de pago	Payment Request doesn’t exist
MR-161	Dispositivo	Device by SN not found
MR-170	Servicio	Error with Database
MR-180	Cola de Solicitudes	Payment Request Queue for the device is full. Nota: el máximo número de transacciones en cola es de 5
I-04	Campos Personalizados	ExtraData String has invalid characters
INT-MIDDLEWARE-429	Límite de Solicitudes	API Quota Exceeded! Quota: {0} per {1}, Try Again in {2} seconds
KEY-002	Autenticación	API Key is missing in the request header
KEY-003	Autenticación	Invalid API Key
RP-000	Idempotencia	Invalid Idempotency Key
RP-001	Campo de entrada	Idempotency Key length must be between 1 and 36 characters
RP-003	Campo de entrada	The characters entered are invalid
RP-004	Campo de entrada	Invalid characters in source version
RP-007	Campos Personalizados	Reserved custom field name
RP-010	Campos Personalizados	Maximum custom fields exceeded
RP-026	Campos Personalizados	Duplicate custom field names
I-02	Campos Personalizados	Custom field length invalid
I-03	Campos Personalizados	Custom field length invalid
MR-191	Idempotencia	The identifier provided is already in use.
MR-203 *	Solicitud de pago	Payment request is in process
RP-005 *	Campo de entrada	No exempt amount for specific DTE types
RP-006 *	Campo de entrada	Exempt amount does not match total