Reseller API

Sell data from your own platform

Build your own website or app with our API. Sell data bundles and AFA registrations at reseller cost, set your own prices, and keep the difference.

Become a reseller Go to dashboard

How it works

STEP 1

Become an agent

STEP 2

Top up your wallet

Load funds via Paystack — orders are billed from this balance.

STEP 3

Generate an API key

Create your key from your agent dashboard.

STEP 4

Start selling

Call the API from your own site and set your own prices.

Authentication

Every request must include your API key in the Authorization header. Generate your key from your agent dashboard → API Access.

Authorization: Bearer YOUR_API_KEY

Keep your key secret — anyone with it can place orders billed to your wallet.

Endpoints

Base URL: https://www.ranceldatahub.shop

GET/api/v1/bundles

List all available data bundles at your reseller price. Call this any time to sync current pricing.

Example

curl "https://www.ranceldatahub.shop/api/v1/bundles" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET/api/v1/balance

Check your wallet balance (in GHS).

Example

curl "https://www.ranceldatahub.shop/api/v1/balance" \
  -H "Authorization: Bearer YOUR_API_KEY"

POST/api/v1/order

Place a data bundle order. The reseller cost is deducted from your wallet. Returns the order id and status.

Body

{
  "bundleId": "the bundle id from /api/v1/bundles",
  "recipient": "0241234567"
}

Example

curl -X POST "https://www.ranceldatahub.shop/api/v1/order" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bundleId":"BUNDLE_ID","recipient":"0241234567"}'

GET/api/v1/order/{id}

Check the status of an order you placed (processing, delivered, or failed).

Example

curl "https://www.ranceldatahub.shop/api/v1/order/ORDER_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

POST/api/v1/afa

Submit an AFA registration. The AFA price is deducted from your wallet.

Body

{
  "fullName": "Ama Boateng",
  "phoneNumber": "0241234567",
  "idNumber": "GHA-XXXXXXXXX-X",
  "dateOfBirth": "1995-06-12",
  "town": "Kumasi",
  "occupation": "Trader",
  "region": "Ashanti",
  "cropProduce": "Maize (optional)"
}

Example

curl -X POST "https://www.ranceldatahub.shop/api/v1/afa" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fullName":"Ama Boateng","phoneNumber":"0241234567","idNumber":"GHA-XXX","dateOfBirth":"1995-06-12","town":"Kumasi","occupation":"Trader","region":"Ashanti"}'

Good to know

• Orders are billed at reseller cost from your top-up wallet. You set your own selling price to your customers.
• If an order can’t be placed, your wallet is automatically refunded — you’re never charged for a failed order.
• Keep your wallet funded, or orders will return a 402 Insufficient balance error.
• Prices update automatically — re-fetch /api/v1/bundles to stay in sync.

Become a reseller — get your API key