Saltar al contenido principal

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:

EstadoSignificado
ACCEPTEDLa orden fue aceptada y registrada; la ejecución todavía no arrancó.
PENDINGLa orden está en procesamiento; el pago todavía no fue confirmado.
CONFIRMEDEl pago fue confirmado del lado del destino.
COMPLETEDLa orden se completó con éxito de punta a punta.
FAILEDLa orden no pudo completarse. Ver Detalle de falla para failure_code y failure_reason.
COMPENSATINGEl payout falló y los fondos están siendo devueltos.
COMPENSATION_PENDINGLa devolución de fondos está encolada.
COMPENSATEDLos fondos fueron devueltos.
REJECTEDLa orden fue rechazada antes de ejecutarse.
IN_PROGRESSLa ejecución está en curso.
PROVIDER_FAILEDLa red de pago falló la operación.
LEG_1_SENTSe envió el primer tramo de la transferencia; el payout sigue en vuelo.
El conjunto puede evolucionar

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.