API Documentation

How It Works

HMAC Signature

Generate a signature for every launch request. The signature is valid for 120 seconds.

// Data to sign (pipe-separated)
data = api_key + "|" + user_id + "|" + game_uid + "|" + balance + "|" + ts

// HMAC-SHA256 hex digest
sig = hash_hmac('sha256', data, client_secret)

Send ts (unix timestamp in seconds) and sig as query parameters.

Security Layers

IP Whitelist (Optional)

If enabled, only requests from whitelisted IPs are accepted. HMAC signature is still recommended even with IP whitelist enabled.

Parameters

Success Response

// HTTP 302 redirect to game URL (default)
Location: https://jsgame.live/game/gamesUrl?id=...

// OR with ?format=json:
{
  "ok": true,
  "game_url": "https://jsgame.live/game/gamesUrl?id=...",
  "request_id": "huidu_req_abc123"
}

cURL Example

curl "https://casino.dhansolution.in/v1/launch?api_key=YOUR_KEY&user_id=player1&game_uid=YOUR_GAME_UID&balance=100&ts=$(date +%s)&sig=YOUR_SIG&format=json"

Balance After Callback

When a round completes, our system:

1. Receives the result from the provider via encrypted callback
2. Looks up the player's current balance in the database
3. Calculates new balance: new_balance = max(0, old_balance - bet + win)
4. Updates the player record with the new balance
5. Forwards the result (including balance snapshot) to your webhook URL

Your system should use the forwarded callback as the source of truth for player balances.

Forwarded Payload (Corrected)

{
  // Original provider data
  "serial_number": "245876c4-f717-76d2-b143-3453dac191c7",
  "game_uid": "e794bf5717aca371152df192341fe68b",
  "game_round": "RND123456789",
  "member_account": "player1",        // Prefix stripped
  "bet_amount": 100.00,
  "win_amount": 0.00,
  "currency_code": "INR",                // Always INR
  "timestamp": "1712345678000",

  // System fields (inf_ prefix)
  "inf_request_id": "huidu_req_abc123",
  "inf_balance": 900.00,                   // Player balance AFTER processing
  "inf_net_amount": -100.00,              // win - bet (negative = loss)

  // GGR fields (only present if player lost)
  "ggr_commission": 10.00,               // Actual GGR deducted from your wallet
  "ggr_percentage": 10,                   // Your configured GGR %

  // Derived fields
  "credit_amount": 900.00,                 // Same as inf_balance (next balance)
}

ggr_commission is the actual amount deducted from your platform wallet. ggr_percentage is your configured GGR rate. Both appear only when the player lost (bet > win).

Expected Response

Your server must respond with HTTP 200. The response body is ignored.

HTTP 200 OK

How to Set It

1. Log in to the Master Panel
2. Navigate to Client Settings ??? Select your client
3. Find the Provider Config section
4. Set forward_callback_url to your webhook endpoint (e.g., https://your-platform.com/api/game/callback)
5. Save the settings

What Gets Forwarded

Every game round result is forwarded as a POST request with Content-Type: application/json.

The payload includes all fields shown in the Callbacks section above.

How GGR Works

Calculation

Wallet Balances

You can view your current wallet balance and GGR percentage in your dashboard.

Available Providers

PHP

<?php
// Your credentials (keep secret!)
$apiKey = 'YOUR_API_KEY';
$clientSecret = 'YOUR_CLIENT_SECRET';
$userId = 'player123';
$gameUid = 'YOUR_GAME_UID';
$balance = '100.00';
$ts = time();

// Build HMAC payload
$payload = "$apiKey|$userId|$gameUid|$balance|$ts";
$sig = hash_hmac('sha256', $payload, $clientSecret);

// Build launch URL
$url = "https://casino.dhansolution.in/v1/launch?api_key=" . urlencode($apiKey)
     . "&user_id=" . urlencode($userId)
     . "&game_uid=" . urlencode($gameUid)
     . "&balance=" . urlencode($balance)
     . "&ts=" . $ts
     . "&sig=" . $sig
     . "&format=json";

// Send request
$response = json_decode(file_get_contents($url), true);
if ($response['ok'] ?? false) {
    header("Location: " . $response['game_url']);
} else {
    echo "Error: " . ($response['error'] ?? 'Unknown');
}

cURL

#!/bin/bash
API_KEY="YOUR_API_KEY"
SECRET="YOUR_CLIENT_SECRET"
USER_ID="player123"
GAME_UID="YOUR_GAME_UID"
BALANCE="100"
TS=$(date +%s)

SIG=$(echo -n "${API_KEY}|${USER_ID}|${GAME_UID}|${BALANCE}|${TS}" | \
  openssl dgst -sha256 -hmac "$SECRET" | awk '{print $2}')

curl -s "https://casino.dhansolution.in/v1/launch?api_key=${API_KEY}&user_id=${USER_ID}&game_uid=${GAME_UID}&balance=${BALANCE}&ts=${TS}&sig=${SIG}&format=json"