Resumen
La API de Dodo Payments proporciona razones de fallo de transacción detalladas para ayudarle a entender por qué un intento de pago no fue exitoso. Estas razones de fallo están estandarizadas a través de diferentes métodos de pago y proveedores, lo que facilita la implementación de un manejo de errores consistente en su aplicación. Cada respuesta de fallo de transacción incluye:- Un código de razón de fallo específico
- Un mensaje de error legible por humanos
- Contexto adicional sobre el fallo cuando está disponible
- Si el error puede ser corregido por el usuario o requiere intervención del sistema
- Proporcionar retroalimentación clara a sus clientes
- Implementar una lógica de reintento apropiada
- Manejar diferentes escenarios de fallo de manera elegante
- Mantener un sistema de procesamiento de pagos confiable
Razones de Fallo de Transacción
La siguiente tabla enumera todas las posibles razones de fallo de transacción, sus significados y si son errores corregibles por el usuario.| Código de Fallo | Error del Usuario | Descripción |
|---|---|---|
AUTHENTICATION_FAILURE | Sí | El proceso de autenticación falló durante la transacción |
AUTHENTICATION_REQUIRED | Sí | Se necesita autenticación adicional para completar la transacción |
AUTHENTICATION_TIMEOUT | Sí | El proceso de autenticación se agotó |
CARD_DECLINED | No | La tarjeta fue rechazada por el banco emisor |
CARD_NOT_ACTIVATED | Sí | La tarjeta no ha sido activada por el titular de la tarjeta |
CARD_VELOCITY_EXCEEDED | Sí | Se intentaron demasiadas transacciones en un corto período |
CUSTOMER_CANCELLED | Sí | El cliente canceló la transacción |
DO_NOT_HONOR | No | El banco emisor rechazó la transacción |
EXPIRED_CARD | Sí | La tarjeta ha expirado |
FRAUDULENT | Sí | La transacción fue marcada como potencialmente fraudulenta |
GENERIC_DECLINE | No | La transacción fue rechazada por una razón no especificada |
INCORRECT_CVC | Sí | El código CVC proporcionado era incorrecto |
INCORRECT_NUMBER | Sí | El número de tarjeta fue ingresado incorrectamente |
INSUFFICIENT_FUNDS | Sí | La cuenta tiene fondos insuficientes para completar la transacción |
INVALID_ACCOUNT | Sí | Los detalles de la cuenta proporcionados son inválidos |
INVALID_AMOUNT | Sí | El monto de la transacción es inválido |
INVALID_CARD_NUMBER | Sí | El formato del número de tarjeta es inválido |
INVALID_CARD_OWNER | Sí | La información del propietario de la tarjeta es inválida |
INVALID_CVC | Sí | El formato del CVC es inválido |
INVALID_EXPIRY_YEAR | Sí | El año de expiración de la tarjeta es inválido |
INVALID_PIN | Sí | El PIN proporcionado es incorrecto |
INVALID_REQUEST | Sí | La solicitud de transacción contiene datos inválidos |
INVALID_UPI_ID | Sí | El ID de UPI proporcionado es inválido |
LIMIT_EXCEEDED | Sí | La transacción excede el límite de la tarjeta o cuenta |
LIVE_MODE_TEST_CARD | Sí | Se utilizó una tarjeta de prueba en modo en vivo |
LOST_CARD | Sí | La tarjeta ha sido reportada como perdida |
MANDATE_INVALID | Sí | El mandato de pago es inválido |
MANDATE_REQUIRED | Sí | Se requiere un mandato para esta transacción |
MANDATE_REQUIRED_SYSTEM | No | El sistema requiere un mandato para este tipo de transacción |
NETWORK_ERROR | No | Ocurrió un error de red durante la transacción |
NETWORK_TIMEOUT | No | La solicitud de red se agotó |
ORDER_CREATION_FAILED | No | Falló al crear el pedido para la transacción |
PAYMENT_METHOD_PROVIDER_DECLINED | Sí | El proveedor del método de pago rechazó la transacción |
PAYMENT_METHOD_UNSUPPORTED | Sí | El método de pago no es compatible con esta transacción |
PICKUP_CARD | Sí | La tarjeta ha sido reportada como robada y debe ser recogida |
PROCESSING_ERROR | No | Ocurrió un error al procesar la transacción |
PROVIDER_UNSUPPORTED | No | El proveedor de pagos no admite este tipo de transacción |
REENTER_TRANSACTION | Sí | La transacción necesita ser reingresada |
REVOCATION_OF_AUTHORIZATION | Sí | La autorización para la transacción fue revocada |
STOLEN_CARD | Sí | La tarjeta ha sido reportada como robada |
TRANSACTION_NOT_ALLOWED | Sí | La transacción no está permitida para esta tarjeta o cuenta |
TRANSACTION_NOT_APPROVED | Sí | La transacción no fue aprobada |
TRY_AGAIN_LATER | No | La transacción debe ser reintentada más tarde |
UNKNOWN_ERROR | No | Ocurrió un error desconocido |
Error del Usuario indica si el rechazo del pago puede ser resuelto por el cliente. Cuando
true, el cliente puede tomar medidas para solucionar el problema (por ejemplo, ingresando los detalles correctos de la tarjeta). Cuando false, el rechazo se debe a problemas a nivel de sistema o restricciones bancarias que no pueden ser resueltas por el cliente.