AirbillsPay gives your application the ability to pay Nigerian utility bills directly through a simple REST API. Your users get seamless bill payments; you settle transactions in USDT or USDC on the Solana blockchain — no naira banking rails required.Documentation Index
Fetch the complete documentation index at: https://developer.airbills.org/llms.txt
Use this file to discover all available pages before exploring further.
Quick Start
Make your first API call in minutes — from getting your secret key to processing a live transaction.
Authentication
Learn how to obtain and use your vendor secret key to authenticate every API request.
Payment Modes
Choose between wallet-signed transactions or simple token transfers to a deposit address.
API Reference
Full reference for all endpoints — initiate payments, look up products, and retrieve transaction history.
What You Can Pay
AirbillsPay supports six product categories, each with a dedicated product code you send in your API request.Airtime
Top up any MTN, Glo, 9mobile, or Airtel number.
Data
Purchase internet data bundles for any major network.
Electricity
Pay prepaid and postpaid electricity bills across providers.
Cable TV
Subscribe or renew DSTV, GOtv, and other cable packages.
Betting
Fund betting accounts on supported platforms.
Transport
Purchase transport tickets and top up transit cards.
How It Works
Get your secret key
Sign up at business.airbills.org and copy your vendor secret key from the dashboard.
Look up products
Use the lookup endpoints to fetch valid plan IDs, network codes, and provider identifiers before initiating a payment.
Initiate a transaction
Call
POST /api/vendor/gateway/transact with your product code, payment mode, and user details. The API returns a transaction ID.Join the AirbillsPay Telegram group to stay up to date with API changes and announcements.