API Documentation
Standard Integration Guide (Babspay Legacy Compatible)
RESELLER API v1.0
Welcome to the BabsPay developer documentation. Use this guide to integrate our services.
AUTHENTICATION
Include your API Token in every request header or as a POST parameter.
POST: api_key=YOUR_API_KEY
PURCHASE DATA BUNDLE
Endpoint: https://www.babspay.com.ng/api/v1/data
Request Parameters
| Field | Value |
|---|---|
network | 1=MTN, 2=Airtel, 3=Glo, 4=9mobile |
plan_id | Data Plan ID (e.g. mtn-1gb-sme) |
phone | 11 Digit Mobile Number |
ref | Unique Request Reference |
Success Response
{
"status": "success",
"Status": "successful",
"msg": "Transaction Successful",
"trans_id": "BT12345678",
"balance": "5000.00"
}
PURCHASE AIRTIME
Endpoint: https://www.babspay.com.ng/api/v1/airtime
| Field | Value |
|---|---|
network | 1, 2, 3, or 4 |
amount | Amount to recharge |
phone | Recipient Number |
UTILITY BILLS & TV
Follow the same JSON structure for electricity and cable TV endpoints.
Refer to the full technical documentation for more advanced integrations.
SEND BULK SMS
Endpoint: https://www.babspay.com.ng/api/send_sms
Request Parameters
| Field | Value |
|---|---|
sender | Your registered and approved Sender ID |
recipients | Comma-separated 11-digit phone numbers |
message | Text message content |
route | (Optional) dnd or non-dnd |
PURCHASE DATA CARD (DATA PIN)
Endpoint: https://www.babspay.com.ng/api/purchase_datapin
Request Parameters
| Field | Value |
|---|---|
plan | Data Card Plan ID (obtain from /api/datapin_plans) |
quantity | Number of pins to purchase |
businessname | Business name to print on pins |
PURCHASE RECHARGE PIN (EPIN)
Endpoint: https://www.babspay.com.ng/api/purchase_rechargepin
Request Parameters
| Field | Value |
|---|---|
network | 1=MTN, 2=Airtel, 3=Glo, 4=9mobile |
amount | Denomination amount (e.g. 100, 200, 500) |
quantity | Number of pins to print |
businessname | Business name to print on pins |
PURCHASE EXAM PIN
Endpoint: https://www.babspay.com.ng/api/purchase_exam
Request Parameters
| Field | Value |
|---|---|
provider | Exam type (e.g. waec, neco) |
quantity | Number of exam pins to purchase |
🪪 IDENTITY VERIFICATION
Verify NIN & BVN and generate official government slips. Powered by Aspget API. Service fees are deducted from your wallet balance.
VERIFY NIN (NIN LOOKUP)
Endpoint: https://www.babspay.com.ng/api/verify_nin POST
Returns verified NIN holder details (name, DOB, address, phone). A lookup fee of ₦150.00 is charged per request.
Request Parameters
| Field | Type | Description |
|---|---|---|
nin | string * | 11-digit National Identification Number |
Success Response
{
"status": "success",
"msg": "NIN verified successfully",
"data": {
"ref": "NIN4F2A1B...",
"data": {
"nin": "12345678901",
"firstname": "John",
"middlename": "Doe",
"surname": "Smith",
"gender": "m",
"birthdate": "1990-01-15",
"phone": "08012345678",
"address": "12 Main St, Lagos",
"state": "Lagos",
"lga": "Ikeja"
}
}
}
GENERATE NIN SLIP
Endpoint: https://www.babspay.com.ng/api/nin_slip POST
Generate an official downloadable/printable NIN slip. Each type has a different fee:
| Slip Type | Value | Fee | Description |
|---|---|---|---|
info | Information | ₦150.00 | Basic NIN data only |
regular | Regular Slip | ₦500.00 | Standard printable slip |
standard | Standard Slip | ₦1,500.00 | Enhanced slip with more details |
premium | Premium Slip | ₦3,000.00 | Full official government slip |
Request Parameters
| Field | Type | Description |
|---|---|---|
nin | string * | 11-digit NIN |
slip_type | string * | One of: info, regular, standard, premium |
Success Response
{
"status": "success",
"msg": "NIN Slip generated successfully",
"data": {
"ref": "NSL4F2A1B...",
"slip_type": "regular",
"slip_url": "https://api.aspget.com/slips/xxx.pdf",
"data": { ... }
}
}
VERIFY BVN
Endpoint: https://www.babspay.com.ng/api/verify_bvn POST
Returns verified BVN holder details. A fee of ₦150.00 is charged per request.
Request Parameters
| Field | Type | Description |
|---|---|---|
bvn | string * | 11-digit Bank Verification Number |
Success Response
{
"status": "success",
"msg": "BVN verified successfully",
"data": {
"ref": "BVN9A3D2C...",
"data": {
"bvn": "22345678901",
"firstName": "John",
"lastName": "Smith",
"dateOfBirth": "01-Jan-1990",
"phoneNumber": "08012345678"
}
}
}
🏆 BETTING WALLET FUNDING
Validate player accounts and fund betting wallets programmatically. Powered by MerryBills. A service charge is added to each funding request.
LIST BETTING PLATFORMS
Endpoint: https://www.babspay.com.ng/api/betting_platforms GET
Returns all active betting platforms with their service_id, minimum and maximum funding amounts.
Response Sample
{
"status": "success",
"data": [
{ "id": 1, "name": "SportyBet", "service_id": "sportybet", "min_amount": 100, "max_amount": 500000 },
{ "id": 2, "name": "Bet9ja", "service_id": "bet9ja", "min_amount": 100, "max_amount": 500000 }
]
}
VALIDATE BETTING ACCOUNT
Endpoint: https://www.babspay.com.ng/api/validate_betting_id POST
Verify a player's account ID exists on the selected platform before funding. No fee charged for this lookup.
Request Parameters
| Field | Type | Description |
|---|---|---|
platform | string * | Platform service_id (e.g. sportybet, bet9ja) |
customer_id | string * | Player's account ID / User ID on that platform |
FUND BETTING WALLET
Endpoint: https://www.babspay.com.ng/api/fund_betting POST
Fund a player's betting wallet. The funding amount plus a service charge are deducted from your wallet.
Request Parameters
| Field | Type | Description |
|---|---|---|
platform | string * | Platform service_id |
customer_id | string * | Player's account ID |
amount | number * | Amount to fund in Naira (₦) |
phone | string | Player's phone number (optional, defaults to your account phone) |
reference | string | Unique transaction reference (auto-generated if omitted) |
Success Response
{
"status": "success",
"msg": "Betting wallet funded successfully",
"data": {
"ref": "BETAPI4F2A..."
}
}
⚡ INTERACTIVE API PLAYGROUND
Test the B2B endpoints directly from your browser. Input your parameters below to execute real-time VTU calls.
Technical Support: support@babspay.com.ng