Standard Integration Guide (Babspay Legacy Compatible)
Welcome to the BabsPay developer documentation. Use this guide to integrate our services.
Include your API Token in every request header or as a POST parameter.
Endpoint: https://babspay.com.ng/api/v1/data
| 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 |
{
"status": "success",
"Status": "successful",
"msg": "Transaction Successful",
"trans_id": "BT12345678",
"balance": "5000.00"
}
Endpoint: https://babspay.com.ng/api/v1/airtime
| Field | Value |
|---|---|
network | 1, 2, 3, or 4 |
amount | Amount to recharge |
phone | Recipient Number |
Follow the same JSON structure for electricity and cable TV endpoints.
Refer to the full technical documentation for more advanced integrations.
Endpoint: https://babspay.com.ng/api/send_sms
| 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 |
Endpoint: https://babspay.com.ng/api/purchase_datapin
| 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 |
Endpoint: https://babspay.com.ng/api/purchase_rechargepin
| 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 |
Endpoint: https://babspay.com.ng/api/purchase_exam
| Field | Value |
|---|---|
provider | Exam type (e.g. waec, neco) |
quantity | Number of exam pins to purchase |
Verify NIN & BVN and generate official government slips. Powered by Aspget API. Service fees are deducted from your wallet balance.
Endpoint: https://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.
| Field | Type | Description |
|---|---|---|
nin | string * | 11-digit National Identification Number |
{
"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"
}
}
}
Endpoint: https://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 |
| Field | Type | Description |
|---|---|---|
nin | string * | 11-digit NIN |
slip_type | string * | One of: info, regular, standard, premium |
{
"status": "success",
"msg": "NIN Slip generated successfully",
"data": {
"ref": "NSL4F2A1B...",
"slip_type": "regular",
"slip_url": "https://api.aspget.com/slips/xxx.pdf",
"data": { ... }
}
}
Endpoint: https://babspay.com.ng/api/verify_bvn POST
Returns verified BVN holder details. A fee of ₦150.00 is charged per request.
| Field | Type | Description |
|---|---|---|
bvn | string * | 11-digit Bank Verification Number |
{
"status": "success",
"msg": "BVN verified successfully",
"data": {
"ref": "BVN9A3D2C...",
"data": {
"bvn": "22345678901",
"firstName": "John",
"lastName": "Smith",
"dateOfBirth": "01-Jan-1990",
"phoneNumber": "08012345678"
}
}
}
Validate player accounts and fund betting wallets programmatically. Powered by MerryBills. A service charge is added to each funding request.
Endpoint: https://babspay.com.ng/api/betting_platforms GET
Returns all active betting platforms with their service_id, minimum and maximum funding amounts.
{
"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 }
]
}
Endpoint: https://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.
| Field | Type | Description |
|---|---|---|
platform | string * | Platform service_id (e.g. sportybet, bet9ja) |
customer_id | string * | Player's account ID / User ID on that platform |
Endpoint: https://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.
| 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) |
{
"status": "success",
"msg": "Betting wallet funded successfully",
"data": {
"ref": "BETAPI4F2A..."
}
}
Test the B2B endpoints directly from your browser. Input your parameters below to execute real-time VTU calls.
Technical Support: support@babspay.com.ng