API Documentation
Sell Best Point Online data bundles from your own website or application. Access is available to approved reseller accounts.
Your API Key
Please
sign in
as a reseller to generate your API key.
Base URL:
https://tiktok.bestpointonline.com/wp-json/bestpointonline/v1
Overview
Authenticate with your API key, list products, check your reseller wallet balance, and purchase data bundles.
API purchases use your reseller prices and deduct the corresponding amount from your website wallet.
Authentication
Send your API key with every request:
X-API-Key: YOUR_API_KEY
Get Balance
GET
/balance
curl -H "X-API-Key: YOUR_API_KEY" https://tiktok.bestpointonline.com/wp-json/bestpointonline/v1/balance
{
"status": "success",
"balance": 500.00,
"currency": "GHS"
}
List Products
GET
/products
curl -H "X-API-Key: YOUR_API_KEY" https://tiktok.bestpointonline.com/wp-json/bestpointonline/v1/products
{
"status": "success",
"data": [
{
"id": 123,
"name": "MTN 5GB",
"network": "YELLO",
"capacity": "5GB",
"price": 18.00
}
]
}
Purchase
POST
/purchase
| Field | Type | Required | Description |
|---|---|---|---|
productId |
number | Yes | ID from /products |
phoneNumber |
string | Yes | Example: 0241234567 |
ref |
string | No | Your unique reference |
curl -X POST https://tiktok.bestpointonline.com/wp-json/bestpointonline/v1/purchase \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '
{
"productId": 123,
"phoneNumber": "0241234567",
"ref": "my-shop-1001"
}
Order Status
GET
/order-status/{ref}
curl -H "X-API-Key: YOUR_API_KEY" https://tiktok.bestpointonline.com/wp-json/bestpointonline/v1/order-status/my-shop-1001
Errors
| HTTP | Meaning |
|---|---|
| 400 | Bad request / insufficient balance / purchase failed |
| 401 | Invalid API key or reseller access |
| 404 | Product or reference not found |
| 502 | Upstream API error |
Network Codes
| Product name contains | Network |
|---|---|
| MTN | YELLO |
| Telecel | TELECEL |
| AirtelTigo / Airtel | AT_PREMIUM |