Sub-estados de Ordenes
A continuación se detallan los sub-estados posibles para órdenes que han sido canceladas o que han fallado durante su procesamiento. Estos códigos son útiles para el manejo de errores y permiten identificar la causa específica que impidió la finalización exitosa de una transacción.
| Sub-estado | Descripción técnica |
|---|---|
| EXCEDED_LIMIT | La transacción fue bloqueada porque supera el límite máximo permitido según la configuración actual del sistema o los parámetros regulatorios definidos para el usuario. |
| INTERNAL_ERROR | Se produjo un error interno en los servicios de Retorna. Puede estar relacionado con fallas del servidor, excepciones no controladas o problemas de infraestructura. |
| EXTERNAL_PROVIDER_ERROR | El intento de completar la transacción falló debido a un error retornado por un proveedor externo (p. ej., servicio bancario o pasarela de pago). Se recomienda revisar los logs del proveedor. |
| ERROR_IN_RECIPIENT_DATA | Los datos ingresados para el destinatario no cumplen con los requisitos mínimos o presentan errores de formato. Validar campos obligatorios y estructura esperada. |
| USER_UNDER_REVIEW | La cuenta del usuario ha sido marcada para revisión manual por razones de seguridad, verificación de identidad o cumplimiento normativo. No se permiten operaciones hasta que finalice el proceso. |
| CANCELED_BY_RECIPIENT | El destinatario canceló activamente la transacción antes de que se completara el procesamiento. No se intentará reenviar. |
| RECIPIENT_LIMIT_EXCEEDED | El destinatario ha alcanzado el límite de recepción de fondos permitido dentro del período vigente. Esta validación puede estar sujeta a políticas regulatorias o internas. |
| SENDER_LIMIT_EXCEEDED | El remitente ha superado su límite diario, semanal o mensual de envíos de dinero. Verificar políticas vigentes y actualizar los umbrales si corresponde. |
| UNDELIVERABLE | No fue posible entregar la transacción al destinatario. Puede deberse a fallos técnicos, cuenta bloqueada o restricciones impuestas por el proveedor de destino. |
| ERROR_DELIVERY_NOTIFICATION_BY_PROVIDER | El proveedor externo notificó un fallo en la entrega o confirmación de la transacción. Este estado suele requerir revisión manual y validación con soporte del proveedor. |
Para más información con respecto al motivo del error referirse a esta documentación Descripción de códigos de error
