Bila← Docs

Charges

The Charge is Bila's central money object. One endpoint accepts payments on every rail.

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

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.