API Documentation

Integrate DataReseller services into your own application. Available to API Client tier members.

Authentication

Include your API keys as headers on every request:

X-Public-Key: pk_your_public_key
X-Secret-Key: sk_your_secret_key

Get your keys from the API Keys page after upgrading to API Client tier.

Base URL

https://drp.paylux.com.ng/api/v1

Endpoints

GET /api/v1/balance

Check your wallet balance.

// Response 200
{
  "status": "success",
  "balance": 15000.00,
  "bonus_balance": 50.00
}

GET /api/v1/plans

List all available data plans with your tier pricing.

// Response 200
{
  "status": "success",
  "data": [
    {"id": 1, "network": "mtn", "type": "sme", "name": "1GB 30 Days", "price": 245.00},
    ...
  ]
}

POST /api/v1/airtime

Purchase airtime.

Field	Type	Description
`network`	string	mtn, glo, airtel, 9mobile
`phone`	string	11-digit number
`amount`	number	Face value (min 50)

// Response 200
{
  "status": "success",
  "reference": "AIR8F2C...",
  "charged": 490.00,
  "balance": 14510.00
}

POST /api/v1/data

Purchase data bundle.

Field	Type	Description
`plan_id`	integer	Plan ID from /api/v1/plans
`phone`	string	11-digit number

// Response 200
{
  "status": "success",
  "reference": "DAT3B71...",
  "plan": "1GB 30 Days",
  "charged": 245.00,
  "balance": 14265.00
}

Errors

Code	Meaning
401	Invalid API keys
402	Insufficient balance
422	Invalid parameters
429	Rate limit (60/min)
500	Server error