Shop Portal — Overview
kioskgaming_shop is a web SPA for CDN Shops (Content Delivery Network) in the KioskGaming ecosystem. Shops use this portal to manage players, credit deposits/withdrawals, approve withdrawals, configure provider fees, manage cashiers, and kiosk marketing URLs.
Repo: kioskgaming_shop/
Role in the system
The shop sits at the fourth tier in the account hierarchy:
Admin → Super Agent → Agent → Shop → Player
The Shop Portal calls the backend API over HTTPS only. There is no direct communication between frontends.
| Portal | Users |
|---|---|
Shop Portal (kioskgaming_shop) | Shop owner / CDN shop manager |
| Cashier App (separate) | Counter cashier staff |
| Player Web | End players |
Cashier login on the Shop Portal is blocked — cashiers are redirected to the Cashier App. The Shop Portal only manages cashier accounts (create, suspend, terminate, view reports).
Two shop wallets
| Wallet | Field name | Purpose |
|---|---|---|
| Credits wallet | credit_balance | Primary balance for granting credits to players |
| USD online balance | online_balance_net | Separate USD wallet — buy credits or withdraw crypto |
Conversion formula: credits = USD ÷ cost_rate (cost rate set by agent).
Key features
| Group | Capabilities |
|---|---|
| Dashboard | Credits/USD balances, player count, quick credit purchase |
| Players | List, create player, deposit/redeem credits, ban/unban |
| Withdrawals | Approve/reject player withdrawal requests |
| Transactions | Credits ledger, CSV export |
| Online transactions | USD wallet ledger, crypto withdrawal, CSV export |
| Provider fees | Enable/disable payment methods, view gateway fees |
| Cashiers | Create/suspend/terminate cashier, view reports & shifts |
| Fraud indicators | Cashier and player fraud metrics |
| Kiosk URL | Manage kiosk subdomain + download promo poster |
| Communication | Send popup/broadcast to players (if delegate permission) |
| Settings | Cost rate, low balance warning, enable 2FA |
Navigation menu
The sidebar shows the following items (mobile: bottom nav for primary items):
| Route | Label | Notes |
|---|---|---|
/ | Dashboard | |
/withdrawals | Withdrawals | |
/transactions | Transactions | |
/online-transactions | Online transactions | |
/provider-fees | Provider fees | |
/players | Players | |
/cashiers | Cashiers | |
/fraud-indicators | Fraud indicators | |
/kiosk-domain | Kiosk URL | |
/popups/send | Send popup | Only when can_delegate_popups === true |
/broadcasts/send | Send broadcast | Only when can_delegate_popups === true |
/settings | Settings |
Popup/broadcast permissions depend on hierarchy: Super Agent delegation + agent flag + shop flag.
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 Shop |
| Business features | Buy credits, player, withdrawal, cashier flows in detail |
Related documentation
- System Overview — role hierarchy and overall architecture
- Cashier Management — cashier management, shifts, cash reconciliation
- Shop USD Wallet — Test Cases — shop USD wallet QC
- Forgot Password (Super Agent / Agent / Shop)