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
Dancity account (Tier 3)
Sign up at dancity.app. API access requires Tier 3 status and an approved API client.
Generate your API key
After approval, generate a merchant key from your API Key page. Copy it once — it is not shown again.
Allowlist your server IPs
Add the IP addresses of your backend servers to the allowlist. Requests from non-allowlisted IPs return
401.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/.