Manejo de errores
Durante el procesamiento de transacciones, pueden surgir distintos errores en la network para una autorización debido a restricciones del emisor, problemas en la red o validaciones de seguridad. A continuación, se detallan algunos de los errores más comunes, sus causas y las posibles soluciones.
Errores comunes y soluciones
| Error | Descripción | Posible solución | Origen |
|---|---|---|---|
| CALL_ISSUER | Se refiere a que hay que contactar al emisor de la tarjeta con la que se realizó el pago. | Contactar al emisor para confirmar la transacción o para resolver un problema de autorización. | Bandera/Banco |
| CAPTURE_CARD | Puede referirse a un error de: capturar la tarjeta/ tarjeta perdida/ tarjeta robada | Verificar los detalles de la tarjeta y, si es necesario, pedirle al usuario que contacte a la entidad emisora para resolver el inconveniente. | Bandera/Banco |
| CRYPTOGRAPHIC_ERROR | Error criptográfico. | Revisar los parámetros de seguridad y asegúrate de que los datos sean correctos y estén debidamente encriptados. | Bandera/Banco |
| DUPLICATE_TRANSMISSION_DETECTED | Detección de transmisión duplicada. | Verificar si la transacción fue enviada previamente y evitar el reenvío. | Bandera/Banco |
| EXPIRED_CARD | Tarjeta expirada. | Solicitar al usuario que utilice una tarjeta vigente. | Bandera/Banco |
| FRAUD_DETECTED | Se ha detectado una posible actividad fraudulenta en la transacción (solo para Mastercard). | Revisar los detalles y asegúrate de que la transacción sea legítima. | Bandera/Banco |
| FORMAT_ERROR | El formato de los datos ingresados es incorrecto. | Revisar y corregir la estructura de la entrada para que cumpla con el formato esperado. | Bandera/Banco |
| INVALID_ACCOUNT | La cuenta (destino/ origen o general) especificada no es válida o es inexistente. | Revisar y asegurarse de que la información de la cuenta sea correcta. | Bandera/Banco |
| INVALID_AMOUNT | El monto es inválido o excede el límite de monto de retiro. | Verificar el monto para asegurarse de que sea válido y que no es mayor al límite permitido. | Bandera/Banco |
| INVALID_CARD_NUMBER | Número de tarjeta inválido. | Verificar que el número de tarjeta sea correcto y que no haya espacios o caracteres adicionales. | Bandera/Banco |
| INVALID_ISSUER | Emisor inválido. | Verifica que la información del emisor (como nombre, código o detalles de la cuenta) sea correcta y esté actualizada. | Bandera/Banco |
| INVALID_TRANSACTION | Transacción inválida. | Revisar los detalles de la transacción (monto, cuentas, fecha, etc.) y asegúrate de que cumpla con los requisitos establecidos. | Bandera/Banco |
| INSUFFICIENT_FUNDS | La tarjeta tiene fondos insuficientes para realizar el pago o superó el límite de crédito. | Pedirle al cliente que utilize otro medio de pago. | Bandera/Banco |
| PIN_ISSUES | PIN inválido. | Solicitar al usuario que ingrese el PIN correcto. | Bandera/Banco |
| PIN_ISSUES | PIN no cambiado. | Pedir al usuario que intente cambiar el PIN o contactar al soporte. (?) | Bandera/Banco |
| PIN_ISSUES | Número permitido de intentos de PIN excedido | Bloquear el acceso y sugerir restablecer el PIN a través del soporte. (?) | Bandera/Banco |
| PIN_ISSUES | Validación de PIN no posible | Reintente más tarde. | Bandera/Banco |
| ROUTING_ISSUES | Sistema de autorización o sistema del emisor inoperativo. | Reintente más tarde. | Bandera/Banco |
| ROUTING_ISSUES | No se puede enrutar la transacción. | Reintente más tarde. | Bandera/Banco |
| SECURITY_VIOLATION | Violación de seguridad. | Revisar los parámetros de seguridad y asegúrate de que todos los datos y accesos sean correctos. | Bandera/Banco |
| UNKNOWN_ERROR | El banco no está dispuesto a aceptar la transacción. | No Aplica | Bandera/Banco |
| UNKNOWN_ERROR | Ciclo de vida (solo para Mastercard). | No Aplica | Bandera/Banco |
| UNKNOWN_ERROR | Error del sistema. | Reintentar más tarde. | Bandera/Banco |
| INVALID_TRANSACTION | Transacción no permitida para el titular/emisor de la tarjeta. | No Aplica | Bandera/Banco |
| INVALID_TRANSACTION | Transacción no permitida para el adquirente/terminal. | No Aplica | Bandera/Banco |
| INVALID_TRANSACTION | Fraude/Seguridad (solo para Mastercard). | No Aplica | Bandera/Banco |
| INVALID_TRANSACTION | Ciclo de vida de autorización inválido. | No Aplica | Bandera/Banco |
| INVALID_TRANSACTION | Transacción de débito doméstico no permitida (solo para uso regional). | No Aplica | Bandera/Banco |
| REJECTED_BY_FRAUD | Se ha detectado una posible actividad fraudulenta en la transacción | Revisar los detalles y asegúrate de que la transacción sea legítima. | Akua |
Updated 18 days ago