> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dancity.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Build VAS and payment integrations with the Dancity merchant API

![Dancity API](https://mintcdn.com/dancity/vR4i1aqBiOQ3jY_c/images/dancity-hero-light.png?fit=max\&auto=format\&n=vR4i1aqBiOQ3jY_c\&q=85\&s=7cbc79c1e71f79dce9c75c832c9856ca)

## 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.

> [card] [Quickstart](https://docs.dancity.app/guides/quickstart)
>
> Make your first API call in under 5 minutes.

> [card] [Authentication](https://docs.dancity.app/guides/authentication.md)
>
> API key setup, `channel` header, and IP allowlisting.

> [card] [API reference](https://docs.dancity.app/api-reference/introduction.md)
>
> Interactive endpoint docs with Try it.

## Before you start

**1. Dancity account (Tier 3)**

Sign up at [dancity.app](https://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](https://dancity.app/profile/api-key). **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](https://docs.dancity.app/guides/webhook.md).

## Base URL

```
https://api.dancity.app
```

All endpoints are prefixed with `/api/v1/`.

## Help

* [support@dancity.app](mailto:support@dancity.app)
* [Errors](https://docs.dancity.app/guides/errors.md) · [Webhooks](https://docs.dancity.app/guides/webhook.md) · [Rate limits](https://docs.dancity.app/guides/rate-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.