Deposits

1. What This Page Is For

The Deposits page (/finance/deposit) is used to monitor, verify, and approve inbound deposits from players. It supports manual slip transfers, automated gateways, and Jinlipay P2P transfers. It also handles credit refunds (Return) from rejected withdrawals and allows staff to match unassigned automatic deposits to player accounts. This page is designed for finance officers, risk management staff, and finance supervisors.

[!NOTE] What is a "Return" transaction? When a withdrawal request is rejected with the "Refund credit" option selected, the system creates a new Return deposit entry with a yellow badge. A finance officer must inspect and approve this entry in the Deposits page before the funds are credited back to the player's balance.

---

2. Before You Begin

• Role Permissions:
  • You must be granted the 'Deposits' permission by an administrator to view and access the transaction review screen.
  • Viewing player phone numbers requires the 'View player phone numbers' permission. Without it, phone numbers are masked with ****.
• Things to Prepare:
  • Player bank transfer slip or real bank account statements.
  • Active CMS bank accounts configured in Payment Setup > Bank Accounts with sufficient daily limits.

---

3. Screen Overview

This section covers two key views: the main deposit ledger table and the transaction verification and approval screen.

1. Main Deposit Ledger Screen (/finance/deposit)

1. Page Header: Displays the page title Deposits, a short summary, and an operational status indicator.
2. Search and Quick Status Bar: Includes the quick search input, status filter tabs (All, In Progress, Approved, Pending Payment, Cancel), and the Advanced toggle button.
3. Active Filter Chips: Displays all currently active filters with an ✕ icon to remove individual filters, and a Clear Filters button to reset all.
4. Table Toolbar: Contains the Refresh button (spinning arrow) to fetch the latest transactions, total results counter, and the Export Excel button.
5. Deposit Data Table: Displays all deposit requests, member ranks, amounts, status badges, and action buttons in each row.
6. Pagination: Located at the bottom of the table to switch pages and change the number of entries displayed per page (10, 20, 50, 100).

2. Transaction Review and Approval Screen (/finance/transaction/[id]/edit)

When you click the Proceed button on any table row, the system opens the full transaction verification view, consisting of:

1. Breadcrumbs and Status Summary: Shows transaction ID, status badge, transaction mode, and the Responsible Group button.
2. Player Financial Summary Card: Displays wallet balance, total deposit history, total withdrawal history, accumulated commissions, cashbacks, reward points, and registration date.
3. Three Information Tabs: Player Log tab, Betting History tab, and Banking Information tab.
4. Bottom Sticky Action Bar: Quick controls to set approval or cancellation status, pick rejection reasons, and save the transaction.

---

4. Search and Filters

Field / Filter	Type	How to Use	Result
Search by transaction, player, bank...	Text input	Type transaction ID, username, account number, or notes, then click Search or press Enter	Filters table to matching entries
Quick Status Tabs	Quick buttons	Click on All, In Progress, Approved, Pending Payment, or Cancel	Quickly filters the table by primary status
Advanced	Toggle button	Click Advanced to expand or collapse the 5 advanced filter fields	Displays detailed filter options
Player Bank	Dropdown	Select the player's sending bank (e.g. KBANK, SCB, BBL, PromptPay)	Shows deposits transferred from that bank
CMS Bank	Dropdown	Select the receiving CMS bank account	Shows deposits received by that specific account
Request Amount (From - To)	Number inputs / Slider	Enter minimum amount in From and maximum in To (0 to 1,000,000)	Shows deposits within the specified amount range
Date Range	Calendar date picker	Select Date From and Date To	Shows deposits created within the selected timeframe
Clear Filters	Button	Click Clear Filters or click ✕ on active chips	Resets all filters back to default values
Refresh	Icon button	Click the spinning arrow icon	Immediately reloads the latest deposit records
Export Excel	Button	Click Export Excel	Downloads currently filtered records as an .xlsx spreadsheet

---

5. Table Data

All Table Columns

Column	What You See	Meaning	Badges / Icons
Created Date	Date and time (e.g. Oct 21, 2026 · 14:30:25)	Timestamp when the request was initiated	Click column header to sort ascending/descending
Transaction ID	Alphanumeric string (e.g. TX-DEP-20261021-0012)	Unique tracking reference of the transaction	Monospace font, copyable
Player	Username and VIP rank badge	The player who initiated the deposit	Flashes orange badge if another staff member is currently viewing
Rank	Player tier badge	Current VIP level of the player	Color-coded badge based on VIP ranking
Player Bank	Bank logo, account number, account owner	Source bank account that sent the payment	Bank logo and account name
Mode	Channel badge (Upload Slip, Auto Gateway, Auto Decimal, Jinlipay P2P)	Method used to complete the payment	Badge styled by transfer channel
Promotion	Purple button with promotion title, or -	Bonus promotion attached to this deposit	Click to open promotion terms dialog
Description	Truncated note or -	Internal memo or rejection reason	Clickable text; opens full text dialog
Request Amount	Amount formatted (e.g. ฿ 1,000.00)	Exact cash amount requested by player	Bold green text
Before Balance	Amount formatted (e.g. ฿ 250.00)	Player wallet balance before deposit approval	Standard neutral text
After Balance	Amount formatted (e.g. ฿ 1,250.00)	Projected player wallet balance after credit approval	Standard neutral text
CMS Bank	Bank code and account number, or -	Company bank account receiving the funds	Bank abbreviation and account number
Updated By	Staff username or System	Account that approved or rejected the record	Text or ID
Responsible Group	View button	Staff members involved in this transaction	Blue button; opens participant list
Status	Status badge	Current processing state	See Section 9 for complete color definitions
Actions	Proceed button	Button to open transaction verification and approval page	See button details below

Action Buttons (Actions Column)

Button	Icon / Color	What Happens When Clicked	Notes / Conditions
Proceed	Blue / primary button	Opens the transaction verification screen to review slips, select bank, and approve or reject	- Disabled if transaction is awaiting slip or payment - Requires 'Deposits' permission

---

6. Step-by-Step Guide

1. Verifying and Approving a Standard Slip Deposit

1. In the deposit table, find the transaction with yellow badge In Progress.
2. Click Proceed on that row to open the transaction review screen.
3. Review the player's summary stats on the top bar (current balance, deposit/withdraw history).
4. Select the Banking tab:
   • Click on the uploaded slip image to zoom and verify the transfer date, time, amount, and recipient account.
   • Click the Select CMS Bank card to open the bank selection modal.
   • Select the Upload Slip tab, then click the active CMS bank that received the money (select the orange RECOMMENDED account first).
5. Scroll down to the bottom sticky action bar, set Status to Approve.
   • If the player requested a promotion but does not qualify, check Approve without promotion and enter the reason.
6. Click Save / Submit.
7. If a promotion replacement warning dialog appears, verify the message and click Confirm and Approve.

2. Matching an Unassigned Automatic Deposit to a Player

When an automatic gateway or decimal deposit arrives without an associated player:

1. Click Proceed on the unassigned deposit row.
2. At the top of the review screen, click the Select Player button.
3. In the popup modal, type the username, phone number, or account number of the player who claimed the transfer, then click Search.
4. Click Select on the matching player record. The screen reloads with the player's data attached.
5. In the Banking tab, confirm that the receiving CMS bank and amount are correct.
6. In the bottom action bar, set Status to Approve, then click Save.

3. Approving a Return Deposit (Refund from Rejected Withdrawal)

1. Find the deposit record marked with a yellow Return badge.
2. Click Proceed to open the review screen.
3. Inspect the Return Detail card on the screen. Verify the original withdrawal transaction ID, amount, and reason for rejection.
4. Set Status to Approve.
5. Click Save. The funds will be credited back to the player's wallet balance immediately.

4. Rejecting an Invalid Deposit Request

Use this when the slip is duplicate, edited, fake, or money was not received:

1. Click Proceed on the target transaction.
2. In the bottom action bar, set Status to Cancel.
3. In the Reason dropdown, select the matching rejection reason (e.g. Invalid slip or Duplicate transaction).
4. If choosing Others, type the specific reason in the description input box.
5. Click Submit (red button). The transaction status will update to Cancelled and no credit is added.

5. Approving a Timed-out Jinlipay P2P Deposit Retroactively

When a Jinlipay P2P transfer timed out but the player claims they completed the bank transfer:

1. Click Proceed on the timed-out transaction.
2. Check external company bank statement to ensure the funds truly reached the account.
3. On the orange warning banner, enter the verification note in the Approval reason field.
4. Click Approve timed-out deposit. Funds will be credited directly to the player's balance.

6. Correcting CMS Bank Assignment Retroactively

For approved or cancelled transactions where the receiving CMS bank was incorrectly recorded:

1. Open the completed transaction by clicking Proceed.
2. Go to the Banking tab.
3. Click on the CMS bank card to open the bank modal and choose the correct bank account.
4. Click Save Changes. The ledger in Bank History will update without affecting player balance.

7. Exporting Deposit Data to Excel

1. Set your desired search filters, status tabs, and date ranges.
2. Click the Export Excel button at the top right of the table.
3. An .xlsx spreadsheet containing all filtered records will download to your device immediately.

---

7. Edit or Add Page

There is no form to create new deposits directly from the main table (deposits are initiated by players from the frontend website or received via automated payment webhooks). Clicking Proceed opens the transaction verification and review screen (/finance/transaction/[id]/edit), which includes:

Player Summary Header

• Top Navigation Bar: Displays the back button, transaction ID, transaction mode badge (Upload Slip, Auto Gateway, Auto Decimal, Jinlipay P2P), current status badge, and real-time collaborative indicators showing other staff members viewing or editing the transaction.
• Financial Status Metrics: Displays current player wallet balance, total deposit amount (with frequency count), and total withdrawal amount (with frequency count).
• Bonuses & Rewards: Displays total claimed commissions, cashback rewards, and promotional bonus amounts.
• Perks & Gamification: Displays available Spinner Tickets, Diamonds, and Reward Points.
• Collapse/Expand Toggle: When scrolling down, the summary header compacts automatically; click the chevron button to pin or expand.

Tab 1: Player Log

• Player Profile Panel (PlayerInfoTab): Personal details, registration date, phone number, registered bank account, and assigned member group.
• Deposit History Table: Table of past deposits, timestamps, transaction numbers, amounts, modes, and statuses.
• Withdrawal History Table: Table of past withdrawals, amounts, destination banks, and outcomes.
• Behavior & Risk Reports: Historical notes, risk levels, and operational alerts regarding the player.

Tab 2: Betting History

Displays the player's detailed gameplay records used to evaluate betting behavior before approving deposits:

• Bet timestamp, provider and game title, round ID.
• Stake amount, profit (green) or loss (red), and accumulated turnover.

Tab 3: Banking Information

The central workspace for inspecting payment evidence:

• Player Bank Details: Bank logo, bank name, account number, account holder name, and current wallet balance.
• Balance Summary Cards: Displays Before Balance, Amount Request, promotional credit (if applicable), and After Balance.
• CMS Bank Selection Box: Displays the assigned company receiving bank account. Clicking the card opens the bank selection modal (supporting Upload Slip, Auto Gateway, and Auto Decimal).
• Slip Images Panel: Displays uploaded transfer slips with click-to-zoom support, image deletion buttons, and an upload dropzone accepting up to 5 images (maximum 5 MB per file).

Bottom Sticky Action Bar

Field / Setting	Required?	What to Input	Example	Constraints
Select Player	Required only if unmatched	Search and select player account	somchai_vip	Search by username, name, or phone
Select CMS Bank	Required for approval	Receiving bank account of the company	SCB - 123-4-56789-0	Must be an active bank account
Slip Image	Optional (for extra uploads)	Uploaded bank transfer slip file	.jpg, .png image	Max 5 MB per file, up to 5 images
Status	Required	Decision status: Approve or Cancel	Approve	Based on payment proof inspection
Reason	Required if rejecting	Standard rejection reason	Invalid slip	Selected from system list
Description	Required if reason is "Others"	Additional explanatory text	Duplicate slip from yesterday	Up to 500 characters
Approve without promotion	Optional	Check if approving base cash but denying bonus	Checked	Requires entering note in description
Approval reason (Timed-out P2P)	Required for timed-out P2P	Explanatory note for retroactive approval	Verified external bank slip	Up to 500 characters

---

8. Popups and Modals

1. Responsible Group Modal

• Triggered when: Clicking View in the Responsible Group column of the table, or clicking the Responsible Group button on the action bar.
• What you see: List of all staff accounts who opened, viewed, or updated this transaction.
• What to do: Inspect staff participation history and click the close button.
• Result: Closes the modal with no data changes.

2. Full Text Detail Modal

• Triggered when: Clicking long truncated text in the Description column of the table.
• What you see: Transaction ID, player username, and complete untruncated note or rejection reason.
• What to do: Read the complete note and close the modal.
• Result: Returns to the table.

3. Promotion Detail Modal

• Triggered when: Clicking the purple promotion button in the Promotion column.
• What you see: Promotion banner, title, terms and rules, bonus percentages, and turnover requirements.
• What to do: Review promotion rules and close the modal.
• Result: Returns to the table.

4. CMS Bank Selection Modal

• Triggered when: Clicking the Select CMS Bank card in the Banking tab of the review screen.
• What you see: Mode tabs (Upload Slip, Auto Gateway, Auto Decimal), list of company bank accounts, RECOMMENDED badge, operating hours, and remaining daily limits.
• What to do: Choose the matching mode, then click an active bank account that received the transfer.
• Result: Assigns the selected bank account to the transaction and closes the modal.

5. Player Selection Modal

• Triggered when: Clicking the Select Player button at the top of the review screen for unassigned transactions.
• What you see: Search input box, search button, and a list of matching players with names and phone numbers.
• What to do: Search by username, phone, or bank digits, and click Select on the correct player.
• Result: Links the player account to the transaction and refreshes the review screen.

6. Promotion Replacement Confirmation Modal

• Triggered when: Approving a deposit with a new promotion while the player already has an active promotion in progress.
• What you see: Orange alert icon and warning notice that approving will permanently forfeit the player's previous promotion.
• What to do: Review promotional terms and click Confirm and Approve (or Cancel to return).
• Result: Cancels previous promotion and activates the new promotional bonus for the player.

7. Large Slip Image Lightbox

• Triggered when: Clicking an uploaded slip thumbnail in the Banking tab.
• What you see: Full-screen high-resolution view of the bank slip with zoom controls.
• What to do: Check transfer timestamp, bank account details, and amounts, then click the close button.
• Result: Closes lightbox and returns to the review screen.

---

9. Status and Badge Colors

Status Badge	Color	Meaning	Next Action Required
Success	Green	Balance credited to the player's wallet	Completed; no further action needed
In Progress	Yellow	Inbound deposit waiting for staff review or player assignment	Click Proceed to review proof and approve
Pending Payment	Blue	Player initiated request but transfer is pending	Wait for player payment; Proceed button is locked
Waiting for player slip	Yellow	Transfer initiated but player has not uploaded slip	Wait for player slip upload within 30 minutes
Expired (No slip)	Gray	Player submitted request but failed to upload slip in 30 min	Inform player to initiate a new deposit if funds were sent
Pending Jinlipay P2P	Purple	P2P transfer is matching externally in Jinlipay gateway	Wait for gateway callback
Cancel	Red	Deposit rejected; no credit added	Check rejection reason in description
Cancelled by Player	Orange	Player cancelled request from the lobby	No action needed; request terminated
Cancelled by System	Gray	Auto-cancelled due to system timeout or mismatch	Review system logs if player inquires
Timeout	Orange	Request timed out with no payment confirmation	If player proves payment, approve retroactively
Return	Yellow badge	Refund from a rejected withdrawal	Click Proceed and approve to refund credit

---

10. Frequently Asked Questions & Troubleshooting

• If the "Proceed" button is gray and cannot be clicked:
  • Check whether you have the 'Deposits' role permission.
  • Or the transaction is in Pending Payment or Waiting for player slip status, where the button is locked until the player submits proof.
• If a CMS bank displays a red "Unavailable" badge:
  • The bank account is toggled off, outside operating hours, or has hit its daily transaction limit. Select another account with the orange RECOMMENDED badge, or ask a supervisor to increase limits in Payment Setup > Bank Accounts.
• If a form field is outlined in yellow with a colleague's name:
  • Another staff member is currently focused on and editing that field (Collaborative Field Locking). Coordinate with the person or wait until they save or leave the page.
• If an automatic deposit stays "In Progress" with no player name:
  • Multiple players share identical account digits or no matching order was found. Click Proceed, then click Select Player to match the correct account before approving.
• If search returns no results:
  • Click Clear Filters to reset all filter parameters, then verify that you have not typed extra trailing spaces.