Skip to main content

Pay a bill

POST 

/api/v1/business/v1/bills

Charges your wallet and sends the payment. The response is the bill: SUCCESSFUL, FAILED, or PENDING while the biller confirms (follow it by webhook or GET /bills/{reference}). Resending the same Idempotency-Key returns the original payment instead of paying twice; a different payment under a used key is 409 IDEMPOTENCY_KEY_REUSED. 422 INSUFFICIENT_FUNDS when the wallet cannot cover the total; nothing is charged.

Request​

Responses​