Skip to main content

Welcome

The mySubwallet API lets you purchase services, manage transactions, and access resources in our system directly from your own application — so you can resell airtime and data, pay bills, verify customers, and more, all funded from your wallet balance.

Authentication

Generate your access token and authenticate every request.

Quickstart

Make your first successful purchase in minutes.

API Reference

Interactive endpoints for data, airtime, cable, electricity and more.

Plans & Catalogs

Fetch data plan IDs, DISCOs, cable plans and exam bodies.

Base URL

All production endpoints are relative to:

Sandbox

Build and test your integration against the sandbox — the same endpoints with full request validation, but no wallet is ever charged and nothing is vended:
Authenticate with your sandbox (test) key (sk_test_…), found under Pricing & Plan IDs in your dashboard. See the Sandbox guide for details.

How it works

1

Fund your wallet

Top up your mySubwallet balance from the dashboard. Every API purchase is debited from this balance.
2

Get your API key

Authenticate once to retrieve your AccessToken (API key). See Authentication.
3

Call the API

Send authenticated POST requests to buy services. Always include a unique request-id for idempotency.
Every purchase request must include a unique request-id. Reusing the same request-id returns the original transaction instead of charging you twice — this protects you from accidental duplicate purchases on retries.