GemData Reseller API

Authenticate every request with X-API-KEY and X-API-SECRET. Use headers as the primary integration path. All endpoints return JSON with status, message, and data.

Production recommendation: keep credentials in headers only, rotate secrets regularly, and treat POST-body credential fallback as a local-compatibility path rather than a preferred integration mode.

Endpoints

Method	Endpoint	Purpose
POST	/gemdata/api/buy-airtime.php	Purchase airtime
POST	/gemdata/api/buy-data.php	Purchase data
POST	/gemdata/api/pay-electricity.php	Buy electricity tokens
POST	/gemdata/api/cable-tv.php	Renew cable TV
POST	/gemdata/api/exam-pin.php	Buy exam pins
POST	/gemdata/api/recharge-card.php	Generate recharge cards
POST	/gemdata/api/data-card.php	Generate data cards
POST	/gemdata/api/bulk-sms.php	Send bulk SMS
GET	/gemdata/api/balance.php	Get wallet balance
GET	/gemdata/api/transactions.php	List transactions

Sample cURL

curl -X POST "http://localhost/gemdata/api/buy-airtime.php" \
  -H "X-API-KEY: gmd_live_your_key" \
  -H "X-API-SECRET: your_one_time_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "08030000000",
    "amount": 1000
  }'

Sample JS Fetch

fetch('http://localhost/gemdata/api/buy-data.php', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-KEY': 'gmd_live_your_key',
    'X-API-SECRET': 'your_one_time_secret'
  },
  body: JSON.stringify({
    phone: '08030000000',
    plan: '2GB',
    amount: 1500
  })
}).then((res) => res.json()).then(console.log);

Authentication Notes

Send X-API-KEY and X-API-SECRET on every request.
Expect failed requests to return a descriptive message and a non-success status.
Keep request references on your side for reconciliation and retries.

Status Handling

success: request completed and provider response is available.
error: validation, auth, or wallet checks failed before completion.
Store the returned reference and transaction status for later reconciliation.

Response Shape

{
  "status": "success",
  "message": "Transaction successful",
  "data": {
    "reference": "GDT12345",
    "status": "successful"
  }
}