Skip to main content

Overview

The airtime and data endpoints let you recharge any Nigerian phone number directly from your Dancity wallet. Both follow the same pattern:
  1. Fetch the product/plan from the catalog
  2. Call the buy endpoint with the product name or plan ID

Authentication

Both endpoints require your merchant API key and the channel: API header.

Buy airtime

Request body

Sample response

amount is the airtime value you requested. amountPaid is what was debited from the wallet (after any group discount).

Purchase Data

Request body


Full purchase flow

Save data.tranxId from the response — use it with GET /api/v1/transactions/{transactionId} to requery the status if the response is slow or unclear.
The airtime amount is capped at ₦1,000 per transaction. For larger top-ups, split into multiple requests.

Next steps