Transaction Lifecycle
The Pagamio VAS system tracks transactions through a well-defined lifecycle. Each transaction has a TransactionStatus that indicates its current state.
Lifecycle Flow
PENDING → PROCESSING → COMPLETED / FAILED
⚠️ Transactions always start in PENDING. They then move to PROCESSING, and finally end as either COMPLETED or FAILED.
States Explained
| Status | Code | Description | Badge Color |
|---|---|---|---|
| PENDING | 1 | Item is waiting to be processed | gray |
| PROCESSING | 2 | Item is currently being processed | blue |
| COMPLETED | 0 | Item has been processed successfully | green |
| FAILED | 3 | Item processing has failed | red |
Best Practices for Integrators
- Track transactionId for each request for reconciliation and support.
- Monitor status changes to update UI or trigger business logic.
- Handle retries carefully: Retry only
FAILEDtransactions when appropriate. - Validate final status before performing fulfillment or confirming payments.