Casino API Documentation

Seamless wallet integration guide for casino game providers

This API allows you to integrate casino games from multiple providers into your platform using a seamless wallet system. Your server holds the player balance — our aggregator calls your endpoints to fetch and update balances on every bet/win.

Architecture

There are 3 parties in every game session:

Integration Flow

Every game session follows this exact sequence:

Credentials

You receive the following credentials when your account is activated:

Game Launch API

Send a GET request to our aggregator to start a game session.

Request Parameters

Example Request:

https://apigamesv2.darkempires.shop/?post
  &gameId=pp-vs20fruitsw
  &mobile=01712345678
  &agentId=rajxavenbo
  &agentKey=rjinqcvuw
  &code=a7be0c27dba17c958e31
  &referrerUrl=https://yoursite.com/

Success Response

{
  "gameurl": "https://apigamesv2.darkempires.shop/premiumgames/gamesUrl?token=..."
}

Redirect the player to the returned gameurl in an iframe or new page.

Error Responses

Callback #1 — GetGameBalance

Our aggregator calls this on your server before every game launch to fetch the player's current balance.

Request Parameter

Required Response

{
  "balance":  250.50,
  "akshinak": "your-player-token"
}

Example PHP Implementation

// /apifolder/api/webapi/GetGameBalance.php
require_once __DIR__ . '/../../conn.php';
header('Content-Type: application/json');

$mobile = trim($_REQUEST['acho'] ?? '');
// Look up player in your DB...
// Return:
echo json_encode([
  'balance'  => 250.50,
  'akshinak' => 'player-token-123',
]);

Callback #2 — GetGameBalanceCall

Called on every bet and settlement. Your server must deduct the bet, add winnings, and return the new balance.

Request Parameters

Required Response

{
  "newmotta": 245.50
}

The balance formula is always:

newBalance = currentBalance - laga (bet) + hara (win)

Insufficient Balance Handling

If the player's balance is less than the bet amount (laga > balance), return HTTP 400:

{
  "error": "insufficient_balance",
  "balance": 1.50
}

Callback System

The aggregator also maintains an internal callback pipeline from the game provider → aggregator → your server.

Callback Payload Fields

GGR System

Gross Gaming Revenue (GGR) is calculated as player losses × your GGR percentage. Your account has a total credit limit per billing cycle.

// GGR deduction per game session
player_loss  = total_bet - total_win   // if positive
ggr_used     = player_loss × (ggr_percentage / 100)

// Blocked when:
SUM(ggr_used in current cycle) >= total_credit

All Error Codes Reference

Demo / Testing Setup

This demo site runs with a pre-configured demo player so you can test games without a real wallet.

Required Database Tables

-- Players
CREATE TABLE users (
  id     INT AUTO_INCREMENT PRIMARY KEY,
  mobile VARCHAR(20) UNIQUE NOT NULL,
  token  VARCHAR(100) NOT NULL
);

-- Wallets
CREATE TABLE wallets (
  id      INT AUTO_INCREMENT PRIMARY KEY,
  user_id INT NOT NULL,
  balance DECIMAL(12,2) DEFAULT 2.00
);

-- Transaction log
CREATE TABLE game_transactions (
  id            INT AUTO_INCREMENT PRIMARY KEY,
  user_id       INT,
  bet           DECIMAL(12,2),
  win           DECIMAL(12,2),
  balance_after DECIMAL(12,2),
  created_at    TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

Downloads

Download the required files below to get started with your integration.

Quick Integration Checklist

Dark Empires Casino API — v2.1 — June 2025  |  Lobby  |  Panel