Estados de una Order
El campo status de una Order indica en qué punto del ciclo de vida
está la transacción. Es un string de paso directo desde el procesador de pagos
subyacente, no un enum cerrado — la plataforma no lo restringe a una lista fija de
valores.
Valores observados
Estos son los valores que se observan en la práctica hoy:
| Estado | Significado |
|---|---|
ACCEPTED | La orden fue aceptada y registrada; la ejecución todavía no arrancó. |
PENDING | La orden está en procesamiento; el pago todavía no fue confirmado. |
CONFIRMED | El pago fue confirmado del lado del destino. |
COMPLETED | La orden se completó con éxito de punta a punta. |
FAILED | La orden no pudo completarse. Ver Detalle de falla para failure_code y failure_reason. |
COMPENSATING | El payout falló y los fondos están siendo devueltos. |
COMPENSATION_PENDING | La devolución de fondos está encolada. |
COMPENSATED | Los fondos fueron devueltos. |
REJECTED | La orden fue rechazada antes de ejecutarse. |
IN_PROGRESS | La ejecución está en curso. |
PROVIDER_FAILED | La red de pago falló la operación. |
LEG_1_SENT | Se envió el primer tramo de la transferencia; el payout sigue en vuelo. |
Como status es un string de paso directo, pueden aparecer valores nuevos a medida
que evoluciona el pipeline de procesamiento subyacente. Maneja los valores
desconocidos con tolerancia — por ejemplo, usa un estado neutral de "en progreso" en tu
UI — en vez de asumir que esta lista es exhaustiva.
Cada transición también queda registrada en el array events de la orden
(from_status, to_status, trigger, created_at), que puedes usar para construir una
línea de tiempo en lugar de depender solo del status actual.