Agent Portal — Overview
kioskgaming_agent is a web SPA for CDN Agents in the KioskGaming ecosystem. Agents use this portal to manage shops, players, credit top-ups/withdrawals, credit distribution to shops, game mapping configuration, and broadcast/popup delivery.
Repo: kioskgaming_agent/
Role in the system
The agent sits at the third tier in the account hierarchy:
Admin → Super Agent → Agent → Shop → Player
| Portal | Users |
|---|---|
Agent Portal (kioskgaming_agent) | CDN agents — manage shops and players |
Shop Portal (kioskgaming_shop) | Shop owners — manage players at the shop |
| Player Web | End players |
The Agent Portal only calls the backend API over HTTPS. There is no direct communication between frontends.
Two wallet types for Agents
| Wallet | Field name | Purpose |
|---|---|---|
| Credits wallet | credit_balance | Primary balance — buy credits, distribute to shops |
| USD online balance | online_balance_net | Separate USD wallet — buy credits or withdraw crypto |
Conversion formula: credits = USD ÷ cost_rate (cost rate set by super agent/admin).
Main features
| Group | Functions |
|---|---|
| Dashboard | Credits/USD balance, shop/player stats, buy credits, distribute credits |
| Shops | List, create shop, suspend/unsuspend, distribute/withdraw credits |
| Shop detail | Overview, security, credit/USD ledger, game mappings |
| Players | List of players under agent shops, detail + history |
| Transactions | Credits ledger, CSV export |
| Online transactions | USD wallet ledger, crypto withdrawal, CSV export |
| Provider fees | View provider fee table (read-only) |
| Fraud indicators | Player fraud flags, withdrawal analysis, resolve |
| Communication | Send popup/broadcast to shop/player (when delegate permission exists) |
| Settings | Cost rate (read-only), low balance alerts, enable 2FA |
Navigation menu
| Route | Label | Mobile bottom nav |
|---|---|---|
/ | Home | ✅ |
/shops | Shops | ✅ |
/players | Players | ✅ |
/transactions | Transactions | ✅ |
/online-transactions | Online transactions | |
/provider-fees | Provider fees | |
/fraud-indicators | Fraud indicators | |
/popups/send | Send popup | Only when can_delegate_popups === true |
/broadcasts/send | Send broadcast | Only when can_delegate_popups === true |
/settings | Settings |
Documentation in this section
| Page | Content |
|---|---|
| Architecture & Tech stack | Project structure, dependencies, state management, deploy |
| Routes & Pages | All routes, components, auth flow |
| API integration | Backend endpoints called by Agent |
| Business features | Shop, credit, player, withdrawal flow details |
Related documentation
- System Overview — role hierarchy and overall architecture
- Shop Portal — portal below agent
- Forgot Password (Super Agent / Agent / Shop)