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
- 201
- 401
- 403
- 503
Missing or invalid API key
BUSINESS_NOT_ACTIVE or IP_NOT_ALLOWED
FEATURE_UNAVAILABLE (bill type paused) or BILLS_TEMPORARILY_UNAVAILABLE