Turnover

1. What this page does

The Turnover page allows administrators to configure recurring daily turnover challenges categorized by game type (such as Slot, Casino, Sport, or Fishing). Each game category features its own ladder of reward tiers (up to 50 tiers). As players reach cumulative pure-cash turnover milestones each day, they can manually claim rewards (including Credit, Points, Wheel Tickets, or Diamonds) in the lobby. Turnover progress resets daily at 00:00 Bangkok time.

Related views in the system include:

• Main dashboard — Shows summary statistics, analytics reports, game category tables, claim rules, and claim history.
• Activity settings page — Title, Description, Banner, Credit Turnover Multiplier, Feature Buy allowances, Max Bet rules, and Delete Activity setup.
• Game category and tier editor — Add or edit a game category and configure its tier ladder.

---

2. Before you start

• Required Permissions:
  • You must have the 'Turnover' permission in Roles to view, configure activity settings, add or edit game categories and tiers, and settle pending credit rewards.
• Supported Game Categories:
  • Supports all platform game types (e.g. Slot, Casino, Sport, Fishing, Table, Arcade, Lotto, PvP, Crash, Crypto). Each game category can be added once to the activity.
• The 7 Core Claim Rules:
  1. Turnover outside promotions only: Turnover wagered while a player is enrolled in an active promotion or credit turnover does not count toward progress.
  2. Sequential claim requirement: Players must reach targets and claim tiers in ascending sequence.
  3. Manual claim required: Rewards are not disbursed automatically; players must log into the lobby and click claim before midnight Bangkok time.
  4. Non-credit rewards (Points, Tickets, Diamonds): Disbursed immediately into the player's wallet without promotional balance checks.
  5. Credit reward balance threshold: To claim credit rewards, a player's wallet balance must be at or below the maximum cancel allowance set in Payment Settings > Transaction Rules.
  6. Daily limit: Each tier can be claimed at most once per day.
  7. Withdrawal conditions for credit: If a credit turnover multiplier is configured, players must fulfill the wagering requirement before withdrawing. If set to no turnover, credit can be withdrawn as cash immediately.

---

3. Screen layout

The main dashboard contains the following sections:

1. Activity Hero Card: Displays the activity banner image, bilingual titles, active status badge, audit timestamp, and the Activity settings button.
2. Activity Stats Cards (4 cards):
   • Activity status: Active or Inactive.
   • Active categories: Ratio of active game categories to total configured categories.
   • Reward tiers: Total number of reward tiers across all active categories.
   • Max credit per player: Maximum cumulative credit one player can earn if they clear every tier in a single day.
3. Activity Report Section: Shows participant counts, total claims, credit paid, non-credit rewards, daily/hourly trend charts, breakdown by category and tier, and top claimant players.
4. Game Categories & Tiers Table: Lists game categories, tab order, tier counts, turnover ranges, total daily rewards, status switches, and action menus, with an Add category button.
5. Claim Rules Card: Explains the 7 claim rules and features a direct link box showing the current maximum balance limit for promotion cancellations.
6. Claim History Table: Real-time log of player claims, filterable by payout status, with actions to approve pending payouts or view error details.

---

4. Search and filters

Filters on Categories Table

• Category Status Tabs: Filter categories by All, Active, or Inactive.

Filters on Report Section

• Period / Dates: Choose: Today, 7 days, 30 days, or Custom (up to 92 days).

Filters on Claim History Table

Field / Filter	Type	Options / How to use	Result
Search player...	Text input	Type a player username	Displays claims made by that specific user.
Game Category	Dropdown	Select All categories or a specific game type	Filters rows to the chosen game category.
Reward Tier	Dropdown	Select All tiers or a specific tier number	Filters rows to the chosen ladder step.
Credit Payout Tabs	Filter tabs	Select: All, Paid, Awaiting payout, or Not paid	Filters claims by credit delivery status.
Claimed Date	Date range picker	Select start and end claim dates	Shows claims submitted within that date range.

---

5. Data tables

1. Game Categories Table (Main Dashboard)

Column	What you see	Meaning	Badge or Symbol
Order	Tab order number with up/down arrows	Tab sequence shown in the player lobby	Circular number button; click to reposition directly
Category	Category icon and title (e.g. Slot)	Game category configured	Category icon
Tiers	Number of tiers (e.g. 5 tiers)	Total ladder steps in this category	Text number
Turnover Range	Lowest – highest target (e.g. ฿1,000 – ฿50,000)	Minimum and maximum turnover goals	Currency amount
Total Rewards / Day	Summary badges of rewards available per day	Aggregate rewards awarded if all tiers are cleared	• Green: Credit • Orange: Points • Blue: Tickets • Purple: Diamonds
Status	Toggle switch	Category activation switch	• Green switch: Active • Gray switch: Inactive
Actions	3-dots action menu	Action triggers	Options: Edit or Delete

2. Claim History Table (Main Dashboard)

Column	What you see	Meaning	Badge or Symbol
Claimed At	Timestamp (e.g. 21/10/2026, 19:30)	Time when the player clicked claim in the lobby	Standard date/time format
Player	Player username (e.g. slot_king)	Player account that submitted the claim	Bold username text
Category & Tier	Category icon, name, and tier step	Milestone cleared by the player	Category icon and tier step
Reward	Reward badges (e.g. +50 ฿, +100 Points)	Value credited to the player	Green, orange, blue, or purple badges
Payout Status	Delivery status badge	Status of credit delivery to wallet	• Green (Paid): Credit successfully delivered • Yellow (Awaiting payout): Pending approval • Red (Not paid): Cancelled or failed
Actions	Pay or Do not pay buttons	Actions for claims awaiting payout	Pinned action buttons on pending rows

---

6. Step-by-step

1. Setting up turnover activity for the first time

1. Navigate to Activities > Turnover from the left navigation menu.
2. If no activity exists, click Create activity (or click Activity settings at the top right if already configured).
3. In the settings page:
   • Enter Title (Thai) (required, e.g. ภารกิจพิชิตยอดเทิร์น รายวัน).
   • Enter Title (English) (optional, e.g. Daily Turnover Challenge).
   • Enter Description and rules (Thai/English) using the rich-text editor.
   • Upload Banner image (recommended size 800 × 800 px).
4. Under Credit turnover requirements:
   • Toggle No turnover on if credit rewards should be withdrawable immediately as cash.
   • Or toggle off and enter the multiplier (e.g. 5x, between 1 and 100).
   • If turnover is set, configure:
     • Buy feature rule: Toggle whether feature buys are allowed during turnover.
     • Max bet per round: Specify max bet per round or choose unlimited.
5. Under Status, verify the switch is set to Active.
6. Click Save in the bottom action bar.

2. Adding a game category and configuring tier ladders

1. In the main dashboard, click Add category.
2. Select the desired Game category (e.g. Slot or Casino). Each category can be created once.
3. Under Reward tiers (Tier Editor):
   • Click Add tier to create ladder steps (up to 50 tiers).
   • For each tier:
     • Turnover target (฿): Enter cumulative turnover required (must be greater than 0 and strictly higher than the preceding tier).
     • Rewards: Enter at least one reward value: Credit (฿), Points, Tickets, or Diamonds.
4. Under Status on the right card, set to Active and optionally choose tab order.
5. Click Save category.

3. Reordering category tabs

1. In the Game categories & tiers table, locate the Order column.
2. Adjust tab order by:
   • Clicking Move up or Move down arrow buttons.
   • Or clicking the circular order number badge to open the direct reposition dialog.
3. Tab order updates immediately in the player lobby.

4. Modifying tiers on a live category

1. In the categories table, click the 3-dots menu on the desired category and select Edit.
2. Modify turnover targets or reward amounts.
3. Click Save category.
4. If the category is currently Active, the Edit a live category? confirmation dialog appears, warning that new targets take effect immediately. Confirm to proceed.

5. Reviewing and paying pending credit rewards

1. In the Claim history section, switch to the Awaiting payout filter tab.
2. Inspect the failure reason (e.g. site credit was temporarily insufficient or deposits were paused).
3. Once the underlying issue is resolved, click Pay in that row to re-trigger credit delivery to the player's wallet.

6. Deleting a category or the entire turnover activity

1. Deleting a Category: Switch the category status toggle to Inactive (Gray), click the 3-dots menu, select Delete, and confirm.
2. Deleting Activity: Click Activity settings at the top right, switch status to Inactive, scroll to the bottom Delete setup card, click Delete activity, and confirm.

---

7. Edit / Add forms

1. Activity Settings Fields

Section	Field	Required?	What to enter	Rules & Constraints
General Info	Title (Thai)	Required	Activity title in Thai	Max 255 characters
	Title (English)	Optional	Activity title in English	Max 255 characters
	Description & Rules	Optional	Rules and details	Rich-text up to 20,000 characters
	Banner image	Required	Activity banner graphic	PNG, JPG, or WEBP up to 5 MB (800 × 800 px)
Credit Turnover	No turnover	Required	Toggle switch	On (cash withdrawable) or Off (turnover required)
	Turnover multiplier	Required (if off)	Multiplier required before withdrawal	Number from 1 to 100
	Buy feature allowed	Required	Toggle allowing slot feature buy	Applicable when turnover > 0
	Max bet per round	Required	Maximum wager cap per bet	Applicable when turnover > 0
Status Card	Status	Required	Lobby visibility toggle	Active (Green) or Inactive (Gray)

2. Category & Tier Editor Fields

Section	Field	Required?	What to enter	Rules & Constraints
Category	Game category	Required	Select platform game type	Unique per category; immutable after creation
Tier Ladder	Turnover target (฿)	Required	Milestone turnover amount	Whole number > 0; strictly higher than previous tier
	Credit (฿)	Optional	Credit awarded	Max 2 decimal digits (at least 1 reward required per tier)
	Points	Optional	Points awarded	Whole number >= 1
	Tickets	Optional	Wheel tickets awarded	Whole number >= 1
	Diamonds	Optional	Diamonds awarded	Whole number >= 1
Status Card	Tab order	Required	Lobby tab sequence number	Integer from 1 to total categories
	Status	Required	Category activation toggle	Active (Green) or Inactive (Gray)

---

8. Popups and dialogs (Popup / Modal)

1. Live Category Changes Confirmation Dialog

• When it opens: When clicking Save category after editing targets or rewards on an Active category.
• What you see: Warning prompt stating that new tier targets take effect immediately for players currently wagering.
• What to do: Verify numbers carefully, then confirm.
• Result: Saves tier updates immediately.

2. Delete Category Confirmation Dialog

• When it opens: When selecting Delete on an inactive category.
• What you see: Confirmation prompt stating the category and all its tiers will be removed.
• What to do: Click the red Delete button.
• Result: Moves category to the deleted archive.

3. Delete Activity Setup Confirmation Dialog

• When it opens: When clicking Delete activity at the bottom of the settings page.
• What you see: Warning prompt stating the entire turnover activity will be permanently cleared.
• What to do: Confirm deletion.
• Result: Clears activity configuration and returns to the initial setup screen.

4. Version Conflict Dialog

• When it opens: When saving settings or categories that were updated by another administrator simultaneously.
• What you see: Outdated version alert.
• What to do: Click Load latest to pull latest changes, then re-apply edits.
• Result: Prevents concurrent edit overwrites.

---

9. Statuses and badges

1. Activity and Category Statuses

Status Badge	Color	Meaning	Next Action
Active	Green	Activity or category is open in the lobby; players can wager and claim.	Normal operational state.
Inactive	Gray	Hidden from players; wagers do not accumulate towards claims.	Toggle switch to active when ready.
Deleted	Gray	Category or activity was archived.	Read-only audit log.

2. Credit Payout Delivery Statuses

Status Badge	Color	Meaning	Next Action
Paid	Green	Credit successfully deposited into player wallet.	Completed state.
Awaiting payout	Yellow	Credit delivery failed (e.g. insufficient site credit).	Admin resolves cause and clicks Pay.
Not paid	Red	Payout was manually rejected or failed permanently.	Terminal cancelled state.

3. Reward Type Colors & Badges

Reward Type	Tone Color	Meaning
Credit	Green	Wallet cash credit (subject to configured turnover multiplier).
Points	Orange	Points credited immediately to player point wallet.
Tickets	Blue	Wheel tickets credited immediately for lucky wheel spins.
Diamonds	Purple	Diamonds credited immediately to player diamond balance.

---

10. Frequently asked questions / Troubleshooting

• How is turnover counted toward this activity?
  • Only pure-cash bets wagered outside active promotions or pending exchange turnover requirements count toward milestones. Bets placed using promotional bonus funds are excluded.
• Why can't a player claim a credit reward tier?
  • According to Rule 5, credit tiers can only be claimed if the player's wallet balance is at or below the maximum cancellation threshold configured under Payment Settings > Transaction Rules. Advise the player to play down their balance or withdraw before claiming.
• Why does adding a tier fail validation?
  • Two strict validation rules apply:
    1. Each tier's turnover target must be strictly greater than the preceding tier's target.
    2. Each tier must specify at least one valid reward (Credit, Points, Tickets, or Diamonds) greater than 0.
• Why can't I delete a category or the activity?
  • Active categories or activities cannot be deleted while live. Switch the status toggle to Inactive (Gray) first, save, and then proceed with deletion.