Vmonie Business API
Sell airtime, data, cable TV subscriptions and electricity to your own customers, paid from a wallet you fund with Vmonie.
How it works
- Vmonie sets up your business account and invites your first owner to the Vmonie Business dashboard. There you create API keys, set your webhook and IP allowlist, and invite your team.
- You fund your wallet by bank transfer. Vmonie credits it once the transfer is confirmed. See Funding your wallet.
- You pay bills through the API. Each payment is charged to your wallet the moment you make it. If the biller cannot complete it, the full amount goes back to your wallet.
- You learn the outcome in the response, or later by webhook or by fetching the bill.
| Bill type | type | You send |
|---|---|---|
| Airtime | AIRTIME | Network, phone number, amount |
| Data | DATA | Network, phone number, bundle (productCode) |
| Cable TV | CABLE_TV | Operator, smartcard/IUC number, plan (productCode) |
| Electricity | ELECTRICITY | Distribution company, meter number, amount |
Conventions
- Base URL. Vmonie gives you the base URL when your account is set up.
The examples use
$VMONIE_API_URLfor it. Every path starts with/api/v1/business/v1. - JSON in and out.
- Money is in kobo, as a decimal string.
"150000"is ₦1,500.00. Keep it as a string or a big integer. Never parse it into a floating-point number. - Errors are
{ "code": "...", "message": "...", "details"?: {...} }. Switch oncode;messageis safe to show to a person. See Errors. - Timestamps are ISO 8601 in UTC.
Next
- Getting started: your first payment, step by step.
- API Reference: every endpoint, request and response.