Sandbox and live, per API key

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.

Confirmation before every payment We never hold your funds
Request
POST /api/v1/chat
Authorization: Bearer chat_••••

{
    "message": "Buy 1GB MTN data for 08031234567"
}
Response 200 OK
{
    "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
    }
}
Airtime Data Electricity Cable TV Bank transfers Bank details from photos
How it works

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
Your key is checked with UnityBills before it is saved and stored encrypted. It is used only for your own orders.
Platform

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.

Getting started

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.

Safe by default

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.

Who builds with it

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.

Pricing

A flat subscription. No per-call fees.

Purchases are paid from your UnityBills wallet at UnityBills prices. BillsGPT charges only the subscription.

3-day free trial

Premium

₦9,999 / month

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
Start free trial

Need something bigger? Talk to us.

FAQ

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.