Skip to main content

Payment Statuses

Status Values

StatusDescription
PENDINGPayment initiated, waiting for customer action
PROCESSINGPayment being processed by the MNO or bank
COMPLETEDPayment received successfully
FAILEDPayment failed: customer did not approve or insufficient funds
CANCELLEDPayment was cancelled
EXPIREDPayment request timed out
REVERSEDPayment 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.