Cashback

1. What is this page for?

The Cashback page is used to manage your site's loss-rebate program, returning a percentage of net losses to players over recurring periods (daily or weekly). You can configure per-rank rates and payout caps, inspect calculation formulas for individual players, approve claims that are waiting for site credit, and view analytical reports. This page is designed for finance officers, campaign managers, and customer support administrators.

---

2. Before you start

• Required permissions:
  • You must have the 'Cashback' permission granted by an administrator to view, configure, adjust rates, or approve/cancel cashback claims.
  • If you only have view permissions, you can browse settings, rank rates, and period records, but save, adjust, and payout approval buttons will be disabled.
• Things to prepare:
  • Member ranks: Ensure ranks are configured in the system beforehand so you can set cashback percentages for each rank.
  • Site credit balance: If claims are awaiting payout due to short site credit, your site's operational credit account must be topped up before approving payouts.
  • Core system rules to understand:
    • Only net losses of deposited cash during the period are eligible (losses of promotion bonus credits do not count).
    • Any free credits or bonuses granted by the site during that period are deducted from losses prior to calculation.
    • Players whose accounts are break-even or in overall profit across their entire account lifetime are ineligible for cashback.

---

3. Screen overview

This page is structured into 3 main tabs:

1. Settings tab: Configures site-wide cashback rules: enable toggle, period cycle (daily/weekly), week start day, claim opening time, claim window days, promotion handling rules, minimum loss threshold, and turnover requirements.
2. Rates by rank tab: Displays all member ranks, their cashback percentage rates across game types, maximum payout caps per period, and edit links.
3. Period report tab: Displays overall statistics cards, trend charts, quick status cards, and the complete table of player period records, with options to view calculation breakdowns and process payouts.

---

4. Search and filters

Filters on the Rates by rank tab

Field / Filter	Type	How to use	Result
Search rank name	Text input	Type a member rank name, e.g. Bronze, VIP	Filters table to matching rank names
Clear	Button	Click the clear button	Resets search filter back to default

Filters on the Period report tab

Field / Filter	Type	How to use	Result
Search player username or phone	Text input	Type a player's username or phone number	Displays records belonging to that player
Status tabs	Quick tab buttons	Select: All, Ready to claim, Awaiting bet settlement, Awaiting payout, Claimed, Cancelled, Expired, Ineligible, or No loss	Filters table immediately by period status
Period end date	Date range picker	Select From date and To date	Displays records for periods that closed within the selected date range
More filters	Toggle button	Click to open or close additional filters	Shows member rank and ineligibility reason selectors
Member rank	Dropdown	Select a member rank	Displays only players belonging to that rank
Reason for no cashback	Dropdown	Select reason, e.g. had promotion in period, below minimum loss, bets pending	Filters records by specific ineligibility reason
Export CSV	Button	Click the export button at top right	Downloads a CSV spreadsheet of the currently displayed records

---

5. Data table

Table 1: Rates by rank (Rates by rank tab)

Column	What you see	Meaning	Badges / Icons
No.	Sequence number	Order of the rank in the progression ladder	Number
Rank	Badge icon and rank name	Member rank name and its active/inactive status	Rank badge and name
Cashback rates	Chips per game type, e.g. Slots 5% · Casino 3%	Cashback percentage paid on net losses in that game category	Rate chips
Max per period	Currency amount or No limit	Maximum cashback cap payable to a player of this rank per period	Currency text or gray label
Last edited	Date, time, and admin name	Timestamp and username of the last person who modified this rank's rates	Date and user badge
Actions	Action buttons in each row	Button to Edit (pencil) or View (eye) rate settings	Action button

Table 2: Cashback per period (Period report tab)

Column	What you see	Meaning	Badges / Icons
Player	Username, phone number, and rank	Player details for this period record	Text and rank chip
Period	Start date to End date of period	Settlement window during which bets were counted	Timestamps
Win/Loss	Net loss amount	Counted net losses eligible for cashback	Currency value
Cashback	Calculated cashback amount	Cashback amount earned by the player	Currency value (bold)
Status	Status badge	Current lifecycle state of this period claim	Color-coded status badge
Claimed at	Timestamp when player claimed	Date and time player pressed claim in the lobby (- if unclaimed)	Timestamp
Last edited	Date, time, and admin name	Timestamp and username of staff who approved or cancelled the claim	Timestamp
Actions	Row action buttons	Buttons to inspect breakdown, approve, or cancel	See row buttons table below

Row buttons (Period report tab)

Button	Icon / Color	What happens when clicked	Notes / Conditions
View calculation	Eye icon / Gray	Opens dialog detailing calculation breakdown by game type and rank	Available on all records
Approve	Wallet icon / Green	Opens credit verification dialog to pay cashback into player's wallet	Only visible on Awaiting payout records
Cancel	Ban icon / Red	Opens dialog requiring a cancellation reason note	Only visible on Awaiting payout records

---

6. Step-by-step guides

1. Configuring site-wide cashback settings

1. Go to Promotions > Cashback and select the Settings tab.
2. Toggle the Cashback on or off switch to On (Green).
3. Under Period, choose the cycle format:
   • Weekly: Choose which weekday the week starts on, e.g. Monday.
   • Daily: Cycles reset daily at 23:59 ICT.
4. Under Claiming:
   • Set Claim opens at: e.g. 00:00 (time when players can begin claiming next day).
   • Set Claim within: e.g. 7 days (between 1 and 21 days).
5. Under Players with promotions:
   • Choose No cashback for that period (disqualifies the period if any promo was taken), or
   • Choose Deduct only promotion money (subtracts bonus amount from net losses).
6. Under Minimum loss for cashback: Toggle switch on to require a minimum loss amount, e.g. 100 THB (toggle off for any loss).
7. Under Turnover on claimed cashback: Toggle switch on to set a wagering multiplier, e.g. 1x (toggle off for immediate withdrawal without turnover).
8. If turnover is enabled, you can optionally configure Feature buy allowed and Max bet per round.
9. Click Save in the bottom action bar and confirm in the popup dialog.

2. Adjusting cashback rates for member ranks

1. Select the Rates by rank tab.
2. Find the rank you wish to adjust and click Edit (pencil icon).
3. In the form, enter the cashback percentage for each game type (between 0.00% and 100.00%).
4. Under Max per period:
   • Toggle No limit off and enter a maximum cap amount, e.g. 5000 THB, or
   • Toggle No limit on to allow uncapped cashback payouts.
5. Review the right summary card, then click Save in the bottom action bar.
6. The updated rates will apply to all subsequent calculation periods.

3. Inspecting player loss calculation details

1. Select the Period report tab.
2. Locate the player record in the table.
3. Click the View calculation button (eye icon) on their row.
4. The popup dialog displays the breakdown: net loss per game category, rank rate percentage applied, site-granted credit deductions, and any pending bet rounds.
5. Click Close when finished.

4. Approving cashback credit payouts (Awaiting payout)

1. In the Period report tab, click the Awaiting payout status filter card.
2. Click the Approve button (wallet icon) on the row waiting for credit.
3. The popup dialog checks your site's operational credit balance:
   • If balance is sufficient, a green checkmark appears.
   • If balance is insufficient, an orange warning appears. Top up site credit before continuing.
4. Click Approve to transfer the cashback credit into the player's wallet.
5. The record updates to Claimed immediately.

5. Cancelling a cashback payout

1. In the Period report tab, find a record with status Awaiting payout and click Cancel (ban icon).
2. In the dialog, enter the reason in the Reason field, e.g. Terms of service violation (up to 300 characters).
3. Click the red Cancel button to confirm.
4. The record updates to Cancelled and the cancellation note is recorded for audit purposes.

---

7. Create or edit page

The rank cashback rate editing page (/promotion/cashback/[id]/edit) consists of:

Rates per game type (Left)

Field	Required?	What to enter	Example	Constraints
Cashback rates per game category (Slots, Live Casino, Sports, Fishing, etc.)	Required for all categories	Percentage of net loss refunded to players of this rank	5.00	Decimal between 0.00 and 100.00% (enter 0 if category earns no cashback)

Maximum cashback limit (Left bottom)

Field	Required?	What to enter	Example	Constraints
Max per period	Required	Toggle No limit or enter a cap amount	10000	If No limit is off, enter an amount > 0

Summary card and audit (Right)

• Displays rank badge icon and title.
• Summarizes configured percentages per game type.
• Summarizes max cashback cap per period.
• Displays last updated timestamp, username, and record version.

---

8. Popups and dialogs

1. Popup window: Calculation breakdown

• Triggered when: Clicking View calculation (eye icon) in the period report table.
• What you see: Period dates, total net loss, total cashback, breakdown table by game type, and unsettled bet details.
• What to do: Inspect calculation accuracy, then click Close.
• Result: Closes the dialog without changing data.

2. Popup window: Approve credit payout

• Triggered when: Clicking Approve on an Awaiting payout record.
• What you see: Player name, cashback amount, site credit balance check, Cancel button, and Approve button.
• What to do: Confirm sufficient site credit and click Approve.
• Result: Credits the player's wallet immediately and updates status to Claimed.

3. Popup window: Cancel cashback claim

• Triggered when: Clicking Cancel on an Awaiting payout record.
• What you see: Warning message, required Reason text area, Cancel button, and red Do not pay button.
• What to do: Enter a clear cancellation explanation and confirm.
• Result: Updates record status to Cancelled with the reason saved.

4. Popup window: Confirm site settings changes

• Triggered when: Clicking Save in the Settings tab.
• What you see: Confirmation alert explaining that changes apply to all unsettled periods including the current active period.
• What to do: Review the impact and click Save.
• Result: Applies new site-wide settings immediately.

5. Popup window: Version conflict (simultaneous edits)

• Triggered when: Saving changes that were updated by another administrator simultaneously.
• What you see: Conflict notice with a reload button.
• What to do: Reload to view latest settings before re-applying changes.
• Result: Prevents unintentional overwrite of concurrent edits.

---

9. Statuses and badges

Badge / Status	Badge Color	Meaning	Next Action Required
Ready to claim	Blue	Period ended, net loss qualifies, and claim window is open	Awaiting player to claim in the lobby
Awaiting bet settlement	Orange	Period is still running or claim opening time has not been reached	Wait for cycle to conclude
Awaiting payout	Orange	Player claimed cashback but site credit was insufficient	Top up site credit and click Approve
Claimed	Green	Cashback was successfully credited to player wallet	Transaction complete. No action needed
Cancelled	Red	Cashback claim was rejected or cancelled by staff	Review reason note if needed
Expired	Gray	Player did not claim cashback within the allowed days	Claim window closed. Forfeited automatically
Ineligible	Gray	Player lost money but did not reach the minimum loss threshold	No cashback earned
No loss	Gray	Player was net-positive or break-even during the period	No cashback earned

---

10. Frequently asked questions / Troubleshooting

• Why is a claim stuck in "Awaiting payout"?
  • This occurs when the site's central credit balance was too low to process the payout at the moment the player claimed it. Top up your site's credit balance, then click the green Approve button on that row.
• Why did a player who lost money receive no cashback?
  • Check whether their net losses met the Minimum loss threshold.
  • Check whether they claimed a deposit promotion during that period (if your settings disqualify promotional periods).
  • Check whether the player's overall lifetime balance is net-positive.
  • Check whether the player has unsettled bets or pending free spins.
• Does modifying site-wide settings affect past periods?
  • No. Closed and settled periods retain their original terms. New settings apply only to active, unsettled periods and future cycles.