Airtime API

Programmatically send mobile airtime top-ups across various operators globally.

API Version

Overview

The Airtime API allows you to integrate mobile recharge functionality directly into your application. All transactions are securely debited from your partner fleet account with automatic rollback on failure.

Intelligent Operator Detection

To simplify integration, you only need to provide the country and phone number. Our system automatically detects the correct mobile operator.

Transaction Authentication

All top-up requests must include your API Key in the Authorization header to identify your account and verify your balance.

Required Authorization Header

cURL

Authorization: Bearer <YOUR_API_KEY>

Send Airtime Top-up

POST/api/v1/b2b/airtime/send

Sends an airtime top-up to a specified phone number.

JavaScript

const apiKey = 'YOUR_API_KEY';

const body = {
  country: "BJ",
  recipientPhone: "22996112233",
  amount: 5,
  currency: "USD",
  reference: "YOUR_UNIQUE_REF_123"
};

fetch('https://api.cashpay-all.com/api/v1/b2b/airtime/send', {
    method: 'POST',
    headers: {
        'Authorization': `Bearer ${apiKey}`,
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(body)
})
.then(res => res.json())
.then(data => console.log(data));