Skip to main content

Quickstart

Make your first data purchase in three calls. Replace pk_live_xxx with your key.

1. Check your wallet balance​

curl https://api.plustiveimpact.com/api/v1/balance \
  -H "Authorization: Bearer pk_live_xxx"
{ "balance": 5000000, "currency": "NGN" }

Balance is in kobo — 5000000 is ₦50,000.00. Low? Top up with /v1/funding/initialize.

2. List the plans you can buy​

curl https://api.plustiveimpact.com/api/v1/plans \
  -H "Authorization: Bearer pk_live_xxx"
[
  { "planId": "169ae891-…", "network": "MTN", "name": "1.0GB", "validity": "30 days", "price": 27000 }
]

price is your price in kobo (it reflects any custom pricing on your account). Grab a planId.

3. Buy data​

curl -X POST https://api.plustiveimpact.com/api/v1/data \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "planId": "169ae891-…",
    "phone": "08030000000",
    "clientReference": "order-1001"
  }'
{
  "reference": "PLS-9KQ2M7P…",
  "status": "Success",
  "providerReference": "118682181",
  "priceCharged": 27000,
  "balance": 4973000
}

That's it — the plan is delivered and your wallet is debited.

Idempotency​

clientReference is your idempotency key (unique per purchase). If a request times out, retry with the same clientReference — you'll get the original transaction back, never a double charge.

Checking a transaction later​

curl https://api.plustiveimpact.com/api/v1/transactions/PLS-9KQ2M7P… \
  -H "Authorization: Bearer pk_live_xxx"

A Processing status means we're still confirming with the network — it'll settle, and we'll webhook you the terminal result.

Prefer to click than to copy-paste? Every endpoint in the API Reference has a live console — paste your key and send a real request.