Bill payments your customers can just ask for.
One REST API that turns “buy 1GB MTN for 0803…” into a confirmed purchase. Airtime, data, electricity, cable TV and bank transfers, paid from your own UnityBills wallet.
POST /api/v1/chat
Authorization: Bearer chat_••••
{
"message": "Buy 1GB MTN data for 08031234567"
}
{
"success": true,
"data": {
"message": "📶 Data Purchase Summary\n• MTN 1GB SME · 30 days\n• 08031234567 · ₦300\nReply Yes to proceed.",
"intent": "buy_data",
"session_id": "2659ea71-bf12-40e8-9456-11c828ae1c4c",
"transaction_status": "awaiting_confirmation",
"requires_confirmation": true
}
}
POST /api/v1/chat
Authorization: Bearer chat_••••
{
"message": "yes",
"session_id": "2659ea71-bf12-40e8-9456-11c828ae1c4c"
}
{
"success": true,
"data": {
"message": "✅ Data Purchase Successful!\n• MTN 1GB SME sent to 08031234567\n• Reference: DATA-p2L8sQ0vN4cX",
"intent": "buy_data",
"transaction_status": "completed",
"requires_confirmation": false
}
}
POST /api/v1/bill/airtime
Authorization: Bearer 13|••••
{
"network": "1",
"amount": 500,
"mobile_number": "08031234567"
}
{
"success": true,
"message": "Airtime purchase successful",
"data": {
"reference": "AIR-x8Kq2LmP0aZ3",
"status": "successful",
"amount": "500.00",
"metadata": {
"environment": "sandbox"
}
},
"environment": "sandbox"
}
Your customers, your wallet. We do the talking.
BillsGPT understands the request, confirms it and places the order with UnityBills using your key. The money goes from your wallet to the provider. It never passes through us.
Your product
Your app, website or chat assistant. You own the customer and charge them your price.
- Send what the customer said
- Check their PIN or balance
- Send “yes” to confirm
BillsGPT API
Understands the request, fills in the details and asks for confirmation.
- Network, plan, meter and bank detection
- Sessions that remember the conversation
- A transaction record for every order
Your UnityBills wallet
Orders are paid from the UnityBills account whose key you saved, at your UnityBills prices.
- Sandbox key for building
- Live key for real orders
- Failed orders refunded by UnityBills
Conversational when you want it. Direct when you don’t.
Chat API
Send the customer’s words to POST /chat. Get back a reply, the detected intent and the details, and whether it needs confirmation.
Direct bill endpoints
Already have a form? Call /bill/airtime, /bill/data, /bill/utility/purchase, /bill/cable/subscribe and /bill/transfer/send with exact fields.
Bank details from photos
Upload a screenshot or photo to /chat/extract-account and get the account number, bank and name back.
Verification built in
Check smartcards, meters and bank account names before anyone pays.
Your plans, your prices
Choose the data plans you sell and set your price. Your customers see your catalogue.
Transactions and sessions
Every order is recorded with its reference, status and environment. Read them back with /transactions.
From sign-up to first order in an afternoon.
Create an account
Register your business. Your free trial starts straight away.
Connect UnityBills
Add a sandbox key from dev.unitybills.ng under API Keys, or with POST /api-keys.
Get your Chat API key
Generate it on the Developer page and keep it on your server.
Build, then go live
Test against the sandbox, then swap in your live key. Your code does not change.
Designed so money never moves by accident.
The AI never pays on its own. Every order waits for a confirmation from you, and the API tells you plainly when an order is still in flight.
Confirmation first
Responses say requires_confirmation: true until you send “yes” in the same session.
One confirmation at a time
Two “yes” messages sent together run once. The second is told the first is still processing.
Clear about pending orders
If UnityBills has not confirmed an order, you get 202 and "pending": true instead of a guess, so nobody pays twice.
Keys handled carefully
Provider keys are encrypted. Chat API keys are matched by hash and can be revoked any time.
Wherever your customers already talk to you.
Fintech and wallets
A chat tab that pays bills from your customers’ balances.
Chat assistants
Connect your WhatsApp, Telegram or web assistant to the Chat API.
Merchants and agents
Sell airtime, data and power to walk-in or online customers.
Teams and employers
Top up staff airtime and data allowances from one place.
A flat subscription. No per-call fees.
Purchases are paid from your UnityBills wallet at UnityBills prices. BillsGPT charges only the subscription.
Premium
Full access to all BillsGPT services
- Unlimited airtime purchases
- Unlimited data bundles
- Bank transfers to any account
- Electricity bill payments
- Cable TV subscriptions
- AI-powered bill assistant
- Priority support
- Advanced API access
pro
- Unlimited airtime purchases
- Unlimited data bundles
- Bank transfers to any account
- Electricity bill payments
- Cable TV subscriptions
- AI-powered bill assistant
- Priority support
- Advanced API access
Need something bigger? Talk to us.
The questions developers ask first.
Whose money pays for the orders?
Yours, from the UnityBills account whose key you add. BillsGPT never holds or moves your funds; you charge your customers however you like.
Is there a sandbox?
Yes. Save a key from dev.unitybills.ng with environment sandbox. Nothing is delivered and nothing real is charged. Every response tells you which environment ran.
Which AI model answers?
Your own OpenAI or Anthropic key, or the BillsGPT model. You choose in Model Settings, or per request with llm.
What if an order is still processing?
You get 202 (or transaction_status: "pending"). Do not resend it. UnityBills completes or refunds it; check the transaction with GET /transactions/{id}.
Do you send webhooks?
Not yet. Read the outcome from the response and from the transactions endpoints.
Can I skip the chat?
Yes. The direct bill endpoints take exact fields and return the transaction straight away, with the same safety on pending orders.
Start building in the sandbox today.
Free trial, sandbox keys and the full API reference.