Catalogue endpoints
Retrieve supported countries, operators and products instead of maintaining static lists.
Programmable connectivity
Airtime inside
your product.
Connect wallets, marketplaces, loyalty products and operations platforms to a consistent top-up workflow.
POST /v1/topups
{
"recipient": "+234801…",
"product": "NG-AIR-25",
"idempotency_key": "ord_…"
} 201 Created 84 ms
Webhookdelivered
RESTresource model
Webhooksstatus events
Idempotentorder creation
What matters
A predictable integration surface
The business API is designed around catalogue discovery, validated orders and asynchronous delivery status.
Safe order creation
Idempotency keys help prevent duplicate fulfilment when clients retry requests.
Signed webhooks
Receive delivery events and verify that callbacks originate from the TopUpGuy platform.
Operational tooling
Use references, logs and exports to investigate orders without exposing sensitive credentials.
A clear path
From intent to outcome
1
Build in sandboxModel catalogue and order flows without production traffic.
2
Pass integration reviewConfirm authentication, retries, webhooks and customer disclosures.
3
Move to productionIssue scoped credentials and monitor the first live transactions.
Keep the next connection moving.
Clear information, traceable delivery and support when the normal flow needs a human.
Request API access