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

ErrorDescripciónPosible solución
CALL_ISSUERSe 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.
CAPTURE_CARDPuede referirse a un error de: capturar la tarjeta/ tarjeta perdida/ tarjeta robadaVerificar los detalles de la tarjeta y, si es necesario, pedirle al usuario que contacte a la entidad emisora para resolver el inconveniente.
CRYPTOGRAPHIC_ERRORError criptográfico.Revisar los parámetros de seguridad y asegúrate de que los datos sean correctos y estén debidamente encriptados.
DUPLICATE_TRANSMISSION_DETECTEDDetección de transmisión duplicada.Verificar si la transacción fue enviada previamente y evitar el reenvío.
EXPIRED_CARDTarjeta expirada.Solicitar al usuario que utilice una tarjeta vigente.
FRAUD_DETECTEDSe 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.
FORMAT_ERROREl formato de los datos ingresados es incorrecto.Revisar y corregir la estructura de la entrada para que cumpla con el formato esperado.
INVALID_ACCOUNTLa 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.
INVALID_AMOUNTEl 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.
INVALID_CARD_NUMBERNúmero de tarjeta inválido.Verificar que el número de tarjeta sea correcto y que no haya espacios o caracteres adicionales.
INVALID_ISSUEREmisor inválido.Verifica que la información del emisor (como nombre, código o detalles de la cuenta) sea correcta y esté actualizada.
INVALID_TRANSACTIONTransacción inválida.Revisar los detalles de la transacción (monto, cuentas, fecha, etc.) y asegúrate de que cumpla con los requisitos establecidos.
INSUFFICIENT_FUNDSLa 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.
PIN_ISSUESPIN inválido.Solicitar al usuario que ingrese el PIN correcto.
PIN_ISSUESPIN no cambiado.Pedir al usuario que intente cambiar el PIN o contactar al soporte. (?)
PIN_ISSUESNúmero permitido de intentos de PIN excedidoBloquear el acceso y sugerir restablecer el PIN a través del soporte. (?)
PIN_ISSUESValidación de PIN no posibleReintente más tarde.
ROUTING_ISSUESSistema de autorización o sistema del emisor inoperativo.Reintente más tarde.
ROUTING_ISSUESNo se puede enrutar la transacción.Reintente más tarde.
SECURITY_VIOLATIONViolación de seguridad.Revisar los parámetros de seguridad y asegúrate de que todos los datos y accesos sean correctos.
UNKNOWN_ERROREl banco no está dispuesto a aceptar la transacción.No Aplica
UNKNOWN_ERRORCiclo de vida (solo para Mastercard).No Aplica
UNKNOWN_ERRORError del sistema.Reintentar más tarde.
INVALID_TRANSACTIONTransacción no permitida para el titular/emisor de la tarjeta.No Aplica
INVALID_TRANSACTIONTransacción no permitida para el adquirente/terminal.No Aplica
INVALID_TRANSACTIONFraude/Seguridad (solo para Mastercard).No Aplica
INVALID_TRANSACTIONCiclo de vida de autorización inválido.No Aplica
INVALID_TRANSACTIONTransacción de débito doméstico no permitida (solo para uso regional).No Aplica

logo akua

© Akua 2025 - Todos los derechos reservados