

Welcome
The Dancity merchant API (/api/v1) lets you buy airtime, data, cable TV subscriptions, electricity tokens, internet bundles, education PINs, and eSIMs — and fund betting accounts — all from your Dancity wallet balance. Every request is authenticated with your merchant API key and the channel: API header.
Quickstart
Make your first API call in under 5 minutes.
Authentication
API key setup,
channel header, and IP allowlisting.API reference
Interactive endpoint docs with Try it.
Before you start
1
Dancity account (Tier 3)
Sign up at dancity.app. API access requires Tier 3 status and an approved API client.
2
Generate your API key
After approval, generate a merchant key from your API Key page. Copy it once — it is not shown again.
3
Allowlist your server IPs
Add the IP addresses of your backend servers to the allowlist. Requests from non-allowlisted IPs return
401.4
Set a webhook URL (optional)
Add an HTTPS webhook URL to receive real-time transaction status events. See the Webhooks guide.
Base URL
/api/v1/.
