Payment Statuses
Status Values
| Status | Description |
|---|---|
PENDING | Payment initiated, waiting for customer action |
PROCESSING | Payment being processed by the MNO or bank |
COMPLETED | Payment received successfully |
FAILED | Payment failed: customer did not approve or insufficient funds |
CANCELLED | Payment was cancelled |
EXPIRED | Payment request timed out |
REVERSED | Payment was reversed/refunded |
Status Flow
PENDING → PROCESSING → COMPLETED
↘ FAILED
↘ CANCELLED
↘ EXPIRED
Polling vs Webhooks
We recommend webhooks over polling. If you must poll, use a maximum of 1 request per 10 seconds and stop after 5 minutes.