API Documentation

REST-ready endpoints for vendors and agents. Amounts are in kobo for API safety.

Send your key in X-API-Key. Keys are SHA-256 hashed in storage and created from the user dashboard.

X-API-Key: nvtu_live_xxxxx

GET /api/v1/balance

POST /api/v1/airtime
{"network":"MTN","phone":"08030000000","amount":10000,"request_id":"unique-001"}

POST /api/v1/data
{"network":"GLO","phone":"08050000000","plan_code":"GLO-1GB","amount":28000,"request_id":"unique-002"}

POST /api/v1/betting
{"provider":"SportyBet","customer_id":"12345678","amount":100000,"request_id":"unique-003"}

GET /api/v1/transactions

Paystack: /webhooks/paystack
Whogopay: /webhooks/whogopay

All wallet credits are idempotent and reconciled.