← Dashboard

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