API referenceBill payments
List bill payments
Authorization
OAuth2PasswordBearer AuthorizationBearer <token>
In: header
Query Parameters
service_type?|null
Cookie Parameters
Response Body
application/json
application/json
curl -X GET "https://example.com/api/b/v1/bill-payments"{ "bill_payments": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "payout_id": "89e4daf5-d103-4869-b9da-3d54ecc98dfe", "service_type": "string", "provider": "string", "product": "string", "account_number": "string", "customer_name": "string", "amount_minor": 0, "currency": "string", "cashback_minor": 0, "status": "pending", "receipt_number": "string", "token": "string", "failure_reason": "string", "created_at": "2019-08-24T14:15:22Z", "completed_at": "2019-08-24T14:15:22Z" } ]}Check an account POST
Ask the biller who owns this meter, phone or smartcard. A mistyped digit costs a phone call when it is caught here and the money when it is not. A biller that cannot answer returns nothing rather than failing — most of them cannot, and refusing to pay them would be worse.
Pay a bill POST
Pay a utility, airtime or tax bill from the business wallet. This raises a payout, so everything that governs a payout governs this: the funds are reserved, the approval thresholds apply, the per-tier and per-day limits apply, and the destination is screened. A bill above the threshold comes back `awaiting_approval` and pays nobody until it is signed.