Create
POST /v1/charges
{
"amount": 10000,
"currency": "USD",
"rail": "auto",
"identifier": "+252611234567",
"description": "Order #1234",
"metadata": { "order_id": "1234" }
}Returns a Charge object with status requires_action, pending, succeeded, failed, or canceled.
Object shape
{
"id": "ch_...",
"object": "charge",
"amount": 10000,
"currency": "USD",
"rail": "waafipay",
"status": "succeeded",
"description": "Order #1234",
"metadata": { "order_id": "1234" },
"rail_charge_id": "wp_...",
"requires_action_payload": null,
"failure_code": null,
"failure_message": null,
"livemode": true,
"created": 1779000000,
"confirmed_at": 1779000005
}Operations
POST /v1/charges— createGET /v1/charges/{id}— retrieveGET /v1/charges— list (cursor pagination viastarting_after)POST /v1/charges/{id}/cancel— cancel pending or requires_action chargePOST /v1/charges/{id}/confirm— re-poll the rail for terminal status
Amounts
Always in the currency's minor unit. 10000 = $100.00 USD, 500 = $5.00 USD. ISO 4217 currency codes only.
Reuse a saved payment method
If you saved a PaymentMethod, pass payment_method: pm_xxx instead of identifier. Bila reuses the stored MSISDN and preferred rail.
Refunds
See Refunds & balance.