Agent System for Online Casino: Multi-Level Hierarchy, Credit Lines, Commissions
Recruit master agents, sub-agents, cashiers under one tree. Assign credit limits, revenue splits, territory rules. Manage the entire network from a mobile app or Telegram bot.
Managing Agents Without a Dedicated Platform is a Risk
Spreadsheets, WhatsApp groups, and manual reconciliation create cash disputes, commission errors, and no audit trail when volumes scale.
Spreadsheet Errors
Manual commission calculations across hundreds of agents result in formula errors, version conflicts, and disputed payouts that erode agent trust and retention.
Cash Disputes
Without real-time credit tracking, over-extended agents accumulate balances operators can’t verify. Disputes surface after settlement when recovery is difficult.
No Audit Trail
Unlogged top-ups and manual payout confirmations leave no forensic record. Regulators and operators cannot reconstruct transaction flows for compliance or dispute resolution.
Unlimited Depth — Every Level Inherits from Its Upline
Define master agents, regional agents, sub-agents, and cashiers. Each level inherits permissions, commission bands, and credit limits from its parent — and cannot exceed them.
Inheritance Rules
Commission rates, credit ceilings, territory locks, and permitted currencies cascade down the tree. Child nodes cannot grant permissions their parent doesn’t hold.
Sibling Isolation
Agents at the same level cannot view each other’s downlines, balances, or player data. Complete isolation enforces competitive separation and data privacy.
Territory Locking
Each node is assigned geo zones, languages, and brands. Players registered through that node inherit the same territory, preventing cross-market license violations.
Per-Level Commission Rules, Configured Without Code
Define GGR, NGR, or turnover-based commission per hierarchy level. Negative carryover, volume minimums, and settlement cadence all configurable per agent contract.
| Level | Base (%) | Metric | Min Volume / Month | Negative Carryover | Settlement |
|---|---|---|---|---|---|
| Master Agent | 30% | GGR | $50,000 | Off | Monthly |
| Regional Agent | 20% | GGR | $20,000 | Configurable | Weekly |
| Sub-Agent | 15% | NGR | $5,000 | On | Weekly |
| Cashier | 5% | Turnover | $1,000 | Off | Daily |
| VIP Master | 35% | GGR | $200,000 | Negotiated | Monthly |
| Enterprise Tier | Custom | Blended | Custom | Custom | Custom |
“level”: “sub_agent”,
“metric”: “ngr”,
“rate_pct”: 15,
“min_volume_usd”: 5000,
“negative_carryover”: true,
“settlement_cadence”: “weekly”,
“payout_rails”: [“usdt_trc20”, “local_bank”]
}
Real-Time Accrual
Commission ticks up in real time as player GGR accumulates. Agents see their accrued balance in the app without waiting for the settlement window.
Downloadable Statements
Full commission statements exportable per agent, per period, in CSV and PDF. Auto-delivered to agent email on settlement day.
Issue, Monitor, and Auto-Freeze Agent Credit in Real Time
Each agent node operates within a credit limit assigned by their upline. Platform enforces limits automatically — no manual intervention needed to freeze over-extended accounts.
Issue Credit
Upline agents assign a credit ceiling to each child node. Credit represents pre-authorized top-up capacity before cash settlement is required.
Top-Up Workflow
Agents request top-ups directly in the app. Upline approves or auto-approves based on rules. Credit restores instantly on confirmation, visible across the downline.
Weekly Settlement
Outstanding balances net against commissions accrued. Settlement statement generated per agent with full line-item breakdown of top-ups, GGR, and commission offsets.
Auto-Freeze on Limit
When an agent reaches 100% of their credit ceiling, all new top-ups are blocked automatically. Account unfreezes the moment the upline extends or replenishes credit.
Native iOS and Android App for Every Agent Level
Biometric login, 2FA, and role-based permissions enforced end to end. Agents top up players, monitor their downline, and track commissions from any device.
Biometric Login
Face ID and fingerprint authentication on iOS and Android. Session tokens expire after inactivity. No passwords stored on device.
Role-Based Permissions
Cashiers see only their players. Sub-agents see only their downline. Masters see the full tree. Permissions enforced server-side — no client-side bypass possible.
Offline-Ready
Core functions cache for low-connectivity regions. Top-up requests queued and processed on reconnect. Critical for African USSD and rural LATAM markets.
24/7 Agent Self-Service via Telegram Bot
Balance checks, player top-ups, commission summaries, and instant alerts — all inside Telegram. Every command requires 2FA and matches the agent’s role. Reduces support load in low-bandwidth regions.
Credit used: $1,750 / $10,000
Commission accrued: $2,140
Confirm with your 2FA code:
GGR: $14,200 · NGR: $11,800
Commission: $1,770
Active players: 87 · Top-ups: 34
/balance Command
Real-time credit balance, usage, and commission accrued. Available 24/7 without opening the web admin. Formatted for readability on mobile screens.
/topup Command
Top up any player by ID and amount directly from Telegram. Requires 2FA confirmation. All actions logged with full audit trail matching the mobile app and web dashboard.
/report Command
Commission and GGR summary by day, week, or month. Filters by sub-agent or player group. Delivered instantly as a formatted Telegram message or exported PDF on request.
Role Gating
Bot detects agent role on every command. Cashiers cannot access reports above their tier. Masters get full downline data. Unauthorized commands return an access-denied response with role explanation.
Per-Agent P&L — GGR, NGR, Commission, Credit Exposure
Operator and master-agent dashboards surface every KPI from the full downline. Drill down to any agent node or player in three clicks.
| Agent | Level | Active Players | GGR | Commission | Credit Used |
|---|---|---|---|---|---|
| MGA-001 (Brazil) | Master | 1,240 | $142k | $22.7k | 62% |
| RGA-007 (Nigeria) | Regional | 580 | $68k | $13.6k | 44% |
| SUB-034 (Manila) | Sub-Agent | 220 | $34k | $5.1k | 31% |
Built for LATAM Retail, African USSD, and SEA Super-Agents
The agent system adapts to how operators distribute in each region — retail cash shops in Brazil, airtime-top-up chains in Nigeria, and super-agent networks in Vietnam.
LATAM Retail Network
Brazil, Mexico, Colombia operators use the agent system to power bricks-and-mortar lottery shops and sports betting kiosks. Agents handle cash-in via PIX and Boleto; the platform manages credit and real-time ledger. 3-level trees (master → shop owner → cashier) common.
African USSD & Mobile Money
Nigeria and Ghana operators run agents who onboard players via USSD menus and M-Pesa or Airtel Money top-ups. The Telegram bot is primary agent interface in low-bandwidth areas. Credit cycles weekly; settlement in USDT or local mobile money rails.
SEA Super-Agent Model
Vietnam and Philippines operators deploy 4-5 level hierarchies with super-agents managing regional networks of hundreds of sub-agents. GCash and local bank rails dominate. Reporting drills down to player-level GGR per sub-agent to identify top performers.
12,000+ Agents Onboarded Across 47 Countries
Operators in LATAM, Africa, and SEA trust the platform to run retail-to-online agent networks with ledger accuracy regulators can audit.
“We migrated 800 retail agents from WhatsApp groups to the platform in three weeks. Cash disputes dropped to zero. The credit auto-freeze alone saved us from two over-extended agents who would have cost us $40k.”
“The Telegram bot is everything for our Nigerian network. Agents in low-connectivity areas can top up players and check commission from a basic Android phone. Settlement is transparent and agents trust the numbers.”
“Our super-agent model in Vietnam runs 6 levels deep. The inheritance rules keep everything clean — no agent can grant permissions above their own. Commission reconciliation that used to take three days now takes three minutes.”
Frequently Asked Questions
Unlimited depth. Most operators run 3-5 levels: master agent, regional agent, sub-agent, cashier, player. Each level inherits configurable permissions, commission rates, credit limits from parent node.
Commissions accrue in real time on GGR, NGR, or turnover per level. Settles weekly or monthly and pushes payouts to agent wallets, crypto addresses, bank rails with full audit trail and downloadable statements.
Yes. Each agent receives a credit line set by their upline. Auto-freezes accounts on limit breach and unlocks after top-up. Negative carryover between settlement periods configurable per contract.
Yes. Native iOS and Android apps let agents top up players, view downline activity, check commission reports, process withdrawals. Biometric login, 2FA, role-based permissions enforced end to end.
Handles balance checks, player top-ups, commission summaries, instant alerts. Every command requires 2FA and matches the agent’s role. Bots reduce support load and give agents 24/7 self-service in low-bandwidth regions.
Yes. Each agent node locks to specific currencies, languages, brands, geo zones. Sub-agents inherit parent restrictions and cannot exceed them. Enforces licensing boundaries and prevents cross-market leakage.
Flags unusual top-up patterns, self-dealing, collusion using device, IP, behavioral fingerprints. Suspicious agents auto-suspended pending review, full transaction history preserved for forensic audit.
Launch Your Agent Network in 14 Days
See the hierarchy builder, credit controls, mobile app, and Telegram bot in a live demo session tailored to your market and distribution model.
Explore the Full Platform
Affiliate System
Revenue share, CPA, and hybrid affiliate programs with real-time postbacks, partner portal, and fraud controls for online acquisition channels.
CRM & Player Management
Segment players by behavior, run multi-channel retention campaigns, manage VIP tiers, and process KYC from one unified console.
Back Office
60+ prebuilt reports, role-based admin access, financial operations, and multi-brand management from a single operator dashboard.
18+ B2B services. We provide software to licensed operators only. We do not offer gambling services to end users.