Códigos de error para transacciones declinadas en efectivo
¿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 en efectivo
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."
}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
| 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 |
Modificado en 2026-09-23 17:07:23