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

# Betting wallet funding

> Top up a customer's betting account from your Dancity wallet

## Overview

The betting funding endpoint lets you deposit funds directly into a customer's account on supported betting platforms (SportyBet, BetKing, 1xBet, etc.). Use `account_id` for the customer's betting account id on the platform.

## Authentication

Requires your merchant API key.

```http theme={null}
Authorization: Bearer dcy_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

***

## Fund a betting account

```
POST /api/v1/betting/funding
```

### Request body

| Field | Type | Required | Description |
| - | - | - | - |
| `product` | string | ✓ | Betting platform name (e.g., `"SportyBet"`) |
| `account_id` | string | ✓ | Their betting account id |
| `amount` | number | ✓ | Amount in NGN (minimum ₦100) |
| `customerRef` | string | | Your internal reference ID |
| `saveAsBeneficiary` | boolean | | Save account as beneficiary |
| `beneficiaryName` | string | | Label for saved beneficiary |

```bash cURL theme={null}
curl -sS -X POST "https://api.dancity.app/api/v1/betting/funding" \
  -H "Authorization: Bearer $DANCITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "SportyBet",
    "account_id": "12345678",
    "amount": 1000
  }'
```

```javascript Node.js theme={null}
const res = await fetch("https://api.dancity.app/api/v1/betting/funding", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.DANCITY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    product: "SportyBet",
    account_id: "12345678",
    amount: 1000,
  }),
});
const data = await res.json();
```

```python Python theme={null}
import requests, os

res = requests.post(
    "https://api.dancity.app/api/v1/betting/funding",
    headers={
        "Authorization": f"Bearer {os.environ['DANCITY_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "product": "SportyBet",
        "account_id": "12345678",
        "amount": 1000,
    },
)
print(res.json())
```

### Sample response

```json theme={null}
{
  "success": true,
  "message": "Betting wallet funded successfully",
  "data": {
    "transactionId": "TXN-2025-XXXXX",
    "tranxId": "dcy_ref_xxxxxxxx",
    "status": "SUCCESS",
    "amount": 1000,
    "product": "SportyBet",
    "account_id": "12345678"
  }
}
```

> [!WARNING]
>
> The minimum funding amount is **₦100**. Always verify the `account_id` with your customer before sending — funds credited to a wrong betting account cannot be reversed automatically.

> [!TIP]
>
> Use `customerRef` to pass your own transaction or order ID. This makes it easy to reconcile records with your system.

***

## Checking available betting platforms

Use the products catalog to get the list of supported betting platforms:

```bash cURL theme={null}
curl -sS "https://api.dancity.app/api/v1/products?service=Betting" \
  -H "Authorization: Bearer $DANCITY_API_KEY"
```

```javascript Node.js theme={null}
const res = await fetch(
  "https://api.dancity.app/api/v1/products?service=Betting",
  { headers: { Authorization: `Bearer ${process.env.DANCITY_API_KEY}` } }
);
const { data } = await res.json();
```

## Next steps

* [Transactions: requery a purchase](https://docs.dancity.app/guides/transactions.md)
* [Catalog: browse available products](https://docs.dancity.app/guides/catalog.md)


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