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.
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 |
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
}'
Sample response
{
"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"
}
}
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.
Use customerRef to pass your own transaction or order ID. This makes it easy to reconcile records with your system.
Use the products catalog to get the list of supported betting platforms:
curl -sS "https://api.dancity.app/api/v1/products?service=Betting" \
-H "Authorization: Bearer $DANCITY_API_KEY"
Next steps
