tranx_id, and an optional verify step.list plans / providers ──> resolve customer ──> buy (tranx_id) ──┬──> 200 successful ├──> 200 queued ──> verify └──> 417 failed, refunded
| Response | Meaning | Your action |
200 ... Was Successful... Thank You | Delivered | Give value |
200 ... Queued... | Provider still processing | Poll Verify bill |
417 ... Failed And Reversed | Failed, wallet refunded | Show the error |
401 / 400 ... Please Contact Support | No final answer yet | Verify the same tranx_id |
data record in a buy response is captured before the purchase. Use the message and HTTP status for the outcome, or Verify bill for the final state.1 MTN, 2 GLO, 3 9mobile, 4 Airtel. Minimum ₦100.123456{ "network_id": 1, "phone": "08031234567", "amount": 1000, "tranx_id": "ACME-20261121-000185" }
GET /bills/get_data_plan?network_id=1, then buy with the plan's variation_id.123456789{ "discription": "(₦1500) - 30 Days - 30DAYS", "amount": "1500", "bundle_code": "MTN-2GB-30D", "network_id": 1, "plan_bundle": "30 Days", "expiration": "30DAYS", "variation_id": "2" }
123456{ "network_id": 1, "phone": "08031234567", "variation_id": "2", "tranx_id": "ACME-20261121-000184" }
variation_id is the plan's position in the list, not a permanent ID. Refresh the plan list shortly before buying and never hard-code it.GET /bills/get_electricity_provider returns each DisCo's id, name and m_id (for example IKEDC).POST /bills/resolve_electricity with disco_name and meter_no returns the customer name, address and meter type. Show them to your customer.POST /bills/buy_electricity. Minimum ₦200. Prepaid tokens come back in data.token.123456789{ "disco_name": "IKEDC", "meter_no": "45031234567", "amount": 5000, "phone": "08031234567", "name": "ADEBAYO OLUWASEUN", "address": "12 Allen Avenue, Ikeja", "tranx_id": "ACME-20261121-000186" }
12345678910{ "status": "success", "message": "Your Electricity Purchase To 45031234567 Was Successful... Thank You", "data": { "order_id": "ACME-20261121-000186", "amount": "5000.00", "phone": "45031234567", "token": "1234-5678-9012-3456-7890" } }
1 GOtv, 2 DStv, 3 StarTimes. Plans have fixed prices, so you only send the plan code.1234567{ "id": "1472", "code": "1472", "name": "GOtv Smallie", "amount": "1900", "type": "gotv" }
1{ "tv_id": 1, "smart_card_no": "7023456789" }
123456{ "tv_id": 1, "code": "1472", "smart_card_no": "7023456789", "tranx_id": "ACME-20261121-000187" }
1{ "betting_provider": "BET9JA", "user": "1234567" }
1234567{ "provider": "BET9JA", "customer_id": "1234567", "name": "ADEBAYO OLUWASEUN", "amount": 5000, "tranx_id": "ACME-20261121-000188" }
GET /bills/verify_transaction?tranx_id=... returns 200 successful, 400 pending, 417 failed and refunded, or 404 unknown.GET /bills/get_all_transaction lists recent activity across bills, collections and transfers.