Introduction
The Pairgate API lets you integrate bill payment services directly into your application. Purchase airtime, data, cable TV subscriptions, electricity tokens, exam pins, and fund betting wallets — all through a simple REST interface.
What You Can Do
| Service | Action |
|---|---|
| Wallet | Check your balance |
| Data | Browse plans, purchase data bundles |
| Airtime | Send airtime to any Nigerian number |
| Cable TV | Verify smartcards, subscribe to DSTV/GOtv/Startimes |
| Electricity | Verify meters, purchase prepaid/postpaid tokens |
| Education | Purchase WAEC/NECO/NABTEB exam checker pins |
| Betting | Verify accounts, fund betting wallets |
| Transactions | Check the status of any purchase |
Base URL
https://pairgate.com/api/v1
Getting Started
Get an API Key
From your Pairgate dashboard
Include It in Requests
As a Bearer token in every request
Send Requests
To any of the endpoints below
Authentication
Add this header to every request:
Authorization: Bearer YOUR_API_KEY
Test Mode
Add /test before any purchase endpoint to simulate the request.
| Production | Test |
|---|---|
POST /data/purchase |
POST /test/data/purchase |
POST /airtime/purchase |
POST /test/airtime/purchase |
Response Format
Success
{
"code": 200,
"status": "success",
"data": { }
}Error
{
"code": 201,
"status": "error",
"message": "What went wrong."
}Preventing Duplicate Purchases
Send a unique reference with each purchase. We use it to ensure the same request isn't processed twice.
Webhooks
When a purchase completes or fails, we send a POST to your configured webhook URL with the final status. See the Webhooks section for details.