BILLXPRESS VENDOR API

Integrate Billxpress API into your platform.

Use BillXpress APIs to offer airtime, data, electricity, cable TV and more on your website or app. Fast, secure and reliable infrastructure for your business.

  • Reliable API
  • Real-time Processing
  • Dedicated Support
SIMPLE INTEGRATION

Get started in minutes.

Our well-documented APIs make it easy to integrate bill payment services into your website or mobile app. Make secure requests, get instant responses, and start serving your customers.

  • RESTful API with clear documentation
  • Secure and reliable infrastructure
  • Transaction lookup and wallet history
  • Get up and running in minutes
View Documentation
curl -X POST \
  'https://api.billxpress.co/api/v1/vendor/data/purchase' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "planId": "MTN_1GB_30DAYS",
    "phone": "08012345678",
    "customerReference": "vendor-data-0001"
  }'
<?php
$ch = curl_init(
    'https://api.billxpress.co/api/v1/vendor/data/purchase'
);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'planId' => 'MTN_1GB_30DAYS',
        'phone' => '08012345678',
        'customerReference' => 'vendor-data-0001',
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
import requests

response = requests.post(
    "https://api.billxpress.co/api/v1/vendor/data/purchase",
    headers={"Authorization": "YOUR_API_KEY"},
    json={
        "planId": "MTN_1GB_30DAYS",
        "phone": "08012345678",
        "customerReference": "vendor-data-0001",
    },
    timeout=30,
)
print(response.json())
const response = await fetch(
  'https://api.billxpress.co/api/v1/vendor/data/purchase',
  {
    method: 'POST',
    headers: {
      Authorization: 'YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      planId: 'MTN_1GB_30DAYS',
      phone: '08012345678',
      customerReference: 'vendor-data-0001',
    }),
  }
);
console.log(await response.json());

Example request. Use a plan ID from the live data plans.

Success ResponseDocumentation example
{
  "success": true,
  "message": "Data purchase successful",
  "data": {
    "reference": "DATA_LX9K...", "status": "successful",
    "customerReference": "vendor-data-0001",
    "service": "data", "amount": 1500, "phone": "08012345678"
  }
}
FOR VENDORS & DEVELOPERS

Start building with BillXpress APIs today.

Power digital payments on your own platform with BillXpress APIs. Reliable services, simple integration, and the tools to grow your business.

Get API Access
QUESTIONS PEOPLE ASK

Frequently asked questions

Quick answers about using BillXpress Vendor API.

What can I do with the BillXpress API?

Offer airtime, data bundles, electricity payments, and cable TV subscriptions from your website or app. You can also check your vendor wallet and look up your transactions.

How do I get API access?

Use your existing BillXpress account and request vendor approval. Once approved, an admin issues your vendor API key. Fund your wallet, then follow the documentation to connect your platform.

Is there a sandbox for testing?

A public sandbox is not currently listed in our API documentation. Contact support before testing purchases: the documented purchase endpoints use your funded vendor wallet.

How are API purchases paid for?

Purchases are debited from your BillXpress vendor wallet. Keep enough balance available before sending a purchase request. Your customer checkout and payment collection are handled by your own platform.