Skip to main content

Estados del ciclo de vida

Toda transacción QR transita por los siguientes estados canónicos:
                    ┌─────────┐
                    │ PENDING │  ◄── estado inicial al crear
                    └────┬────┘
           ┌─────────────┼─────────────┐
           ▼             ▼             ▼
        ┌──────┐   ┌──────────┐   ┌─────────┐
        │ PAID │   │ REJECTED │   │ EXPIRED │
        └──────┘   └──────────┘   └─────────┘

   CANCELLED  ──  El comercio canceló antes de que se pague
   ERROR      ──  Fallo irrecuperable en el procesamiento
EstadoDescripción
PENDINGGenerado correctamente, esperando pago del pagador.
PAIDAl menos una orden de pago fue procesada exitosamente.
REJECTEDTodas las órdenes fueron rechazadas por la red de pagos.
EXPIREDVenció el expiresAt sin que se procese ningún pago.
CANCELLEDCancelado por el comercio antes del pago (funcionalidad próxima).
ERRORFallo irrecuperable durante la generación — el QR no existe en la red.
Lógica de agregación de estado cuando existen múltiples órdenes asociadas al mismo QR:
  • Si al menos una orden está PAID → estado del QR = PAID.
  • Si todas las órdenes están REJECTED → estado del QR = REJECTED.
  • En cualquier otro caso → PENDING.