Bank accounts

1. What This Page Does

The Bank accounts screen (/payment-settings/bank-accounts) is used to manage all company bank accounts for the website. It covers Receiving accounts (player deposits), Paying accounts (player cash withdrawals), and aggregate Report cashflow summaries for every account. Administrators and finance managers can register new bank accounts, set daily opening and closing hours, establish maximum transaction count and volume caps per day, select VIP member ranks or player groups permitted to see each account, organize account display priorities, and configure suggested quick-amount buttons on the player lobby.

---

2. Before You Begin

• Required Permissions:
  • You must have the 'Receiving accounts' permission in your assigned system role to view, create, edit, and toggle deposit bank accounts under the Receiving accounts tab.
  • You must have the 'Paying accounts' permission in your assigned system role to view, create, edit, and toggle payout bank accounts under the Paying accounts tab.
• Prerequisites & Preparation:
  • Prepare actual bank account credentials: Bank Name, Account Holder First and Last Name (matching the bank passbook), and Account Number.
  • Ensure the corresponding bank has been enabled in Payment setup > Bank list.
  • For automatic deposit verification, ensure the LINE reader account is connected in Payment services > LINE bank-notice readers.

---

3. Screen Layout

When opening the page, you will see the following key areas from top to bottom:

1. Page Header: Displays the title Bank accounts along with a descriptive subtitle.
2. Main Tabs:
   • Receiving accounts (/payment-settings/bank-accounts/deposit): Manages accounts that receive player deposits.
   • Paying accounts (/payment-settings/bank-accounts/withdraw): Manages accounts used to pay out player withdrawals.
   • Bank report (/payment-settings/bank-accounts/report): Visualizes cashflow trends, deposit/withdrawal distribution, and CSV export.
3. Slip Upload Warning Banner (If Applicable): If slip upload mode is active but EasySlip is not yet configured, an orange warning banner appears.
4. Section Card:
   • Top Right Buttons: The Suggested amounts button (opens preset lobby amount settings) and the Add an account button (opens the account creation page).
   • Mode Tabs: Under Receiving accounts, choose between Slip upload (players upload deposit slip receipts) and Auto (automatic balance detection via LINE notifications).
   • 4 Status Filter Cards: All, On, Off, and Deleted accounts.
   • Search & Filter Bar: Search input with an Advanced filter toggle for specific bank and creation date filters.
   • Toolbar Line: Displays total account count and a Refresh button.
5. Data Table: Displays the bank logo, account holder, operating hours, daily limits, status switches, and row action buttons (rendered as easy-to-use cards on mobile devices).
6. Pagination: Switches between pages and sets 10, 25, 50, or 100 rows per page.

---

4. Search and Filters

Field / Filter	Type	Options / How to Use	Result When Selected
Search bank, holder, or number	Text input	Type the account holder name, bank number, or bank prefix	Filters the table to display only matching accounts
Status Filter Cards	4 clickable cards	Select All, On, Off, or Deleted accounts	Shows only accounts matching the status, with live counters on each card
More filters	Button toggle	Click to expand or collapse additional filter fields	Displays bank dropdown and date range pickers
Bank	Dropdown	Select a specific bank or choose All banks	Filters accounts belonging to the selected financial institution
Date created	Date picker	Select a start and end calendar date	Shows accounts created within the specified timeframe
Clear filters	Button	Click the clear button	Resets search query, bank selection, and date filters to default
Refresh	Icon button	Click the rotating arrow button	Immediately reloads the latest account data from the server

---

5. Data Table

Columns in the Table

Column	What You See	Meaning	Colors / Badges
Order	Order number in circle with Up/Down arrows	Display priority shown to players in the lobby (top account is offered first)	Grey or primary theme circle with arrows
Account	Bank logo, holder name, bank name, and account number	Primary bank account identification details	- If the bank is turned off globally, displays an orange alert badge: Bank is off - Click the account to open the edit page
Conditions	Operating hours, targeted ranks/groups, and limits	Display conditions: operating hours, VIP rank eligibility, per-transaction limits, and minimum total deposit threshold	Grey text summarizing active time slots and targeting rules
Daily limits	Remaining times and volume today (e.g. 450 of 500 left, 1,200,000 of 2,000,000 ฿ left)	Configured daily quota and remaining capacity before resetting at midnight (00:00)	- Standard text: quota available - Bold red text: quota exhausted (<= 0) - RotateCcw icon button: click to reset quota immediately
LINE reader (Auto mode only)	Connected LINE reader account label or alert badge	The LINE notification account assigned to read incoming bank alerts	- Green badge: connected LINE reader account label - Orange badge: no LINE reader connected
Last edited	Date, time, and updater name	Audit tracking of the most recent modification	Formatted date and staff username
Status	Toggle switch or deleted chip	Active operational state of the account	- Green switch: active and accepting transactions - Grey switch: temporarily paused - Grey deleted badge: archived account
Actions	Action buttons at the end of the row	Commands to edit or delete the account	See action buttons table below

Row Action Buttons (Actions Column)

Button	Icon / Color	What Happens When Clicked	Notes / Conditions
Edit / View	Pencil icon (or eye icon)	Opens the account details and activity history page	Displays view-only eye icon if user lacks edit permission or account is deleted
⋮ menu > Delete	Trash icon / Red	Opens the deletion confirmation dialog	Must toggle switch to "Off" first. Delete is disabled while the account is active
Up / Down arrows (in Order column)	Up / Down arrows	Moves the account up or down 1 position in priority immediately	Available when no search filter is applied
Reset limit (in Daily limits column)	RotateCcw icon	Opens the dialog to restore the daily transaction or volume quota immediately	Appears when quota has been partially or fully consumed

---

6. Step-by-Step Instructions

1. Adding a New Receiving or Paying Bank Account

1. Navigate to Payment setup > Bank accounts.
2. Select either the Receiving accounts or Paying accounts tab at the top.
3. For receiving accounts, select the desired mode tab: Slip upload or Auto.
4. Click the Add an account button at the top right.
5. Fill out all form fields according to Section 7 (Bank, Holder First and Last Name, Bank Number, Hours, Daily Limits, and Targeted Ranks/Groups).
6. Click the Save button at the bottom action bar.
7. A Check before adding review dialog will open showing the bank logo, number, and holder name.
8. Verify all details carefully, then click Add account.
9. The account will be saved and immediately activated in the table.

2. Editing an Existing Bank Account

1. Locate the bank account in the table.
2. Click the Edit (pencil) button or click the account name.
3. Modify the desired parameters (Operating hours, daily caps, VIP ranks, player notes). (Note: If transactions have already occurred through this account, the bank name, account number, and holder name are permanently locked to preserve accounting integrity).
4. Click the Save button at the bottom action bar.
5. If daily limits were changed, select when the new limit takes effect in the popup dialog and confirm.

3. Toggling an Account On or Off

1. In the table, locate the toggle switch in the Status column for the account.
2. Click the switch:
   • Toggle to On (Green) to make the account active and visible to players.
   • Toggle to Off (Grey) to temporarily hide and pause the account.
3. A success notification will confirm the status change immediately.

4. Reordering Account Priority

1. Ensure the search box is empty and the status card is set to All.
2. In the Order column, click the Up or Down arrow on the target account.
3. The account switches places immediately. The account in position 1 is always presented as the primary choice to players in the lobby.

5. Resetting Daily Limits Mid-Day

1. If an account has exhausted its transaction count or balance limit before midnight (numbers turn red).
2. Click the Reset (RotateCcw) icon button next to the daily limit figure.
3. In the confirmation dialog, click Reset Now.
4. The account's remaining quota returns to 100% capacity immediately without waiting for midnight.

6. Setting Suggested Lobby Amounts

1. Click the Suggested amounts button above the table.
2. A dialog displays the preview row that players see (the minimum and maximum amounts are pulled automatically from Transaction Rules).
3. Click Add an amount to insert preset quick-pick numbers (e.g., 100, 300, 500, 1,000, 5,000).
4. Click Save to publish the buttons to the player lobby immediately.

7. Deleting a Bank Account

1. Toggle the account switch to Off (Grey) first.
2. Click the three-dots menu (⋮) and select Delete.
3. In the confirmation dialog, verify the account name and number, then click Delete.
4. The account is moved to the Deleted accounts archive tab for audit tracking.

---

7. Add or Edit Form

The create/edit page (/payment-settings/bank-accounts/[type]/[id]/edit) features account configuration sections on the left and a summary card on the right. When editing an existing account, a second tab titled Activity displays transaction volume history.

Form Fields (Account Details Tab)

Field	Required?	What to Enter	Example	Constraints
Bank	Required (creation only)	Select bank from active system banks	Kasikornbank (KBANK)	Cannot be changed after creation
First name	Required	Account holder's first name matching passbook	John	Max 120 characters; locked once transactions exist
Last name	Required	Account holder's last name matching passbook	Doe	Max 120 characters; locked once transactions exist
Bank number	Required	Bank account number (digits and hyphens only)	098-7-65432-1	Digits only, up to 15 characters; locked once transactions exist
Currency	Required	Currency held by this account	THB	Select from THB, USD, CNY, EUR (default: THB)
PromptPay phone number	Required (auto decimal mode only)	Phone number tied to PromptPay	0812345678	Exactly 10 digits starting with 06, 08, or 09
Player note (TH)	Optional	Short guidance note in Thai shown below account in lobby	โอนแล้วรอ 1-3 นาที	Max 200 characters
Player note (EN)	Optional	Short guidance note in English shown below account in lobby	Instant, 1-3 min	Max 200 characters
Internal note	Optional	Memo for internal staff (players cannot see this)	Backup receiving account for daytime	Max 500 characters
Operating hours	Required	Start and end times for daily availability	00:00:00 to 23:59:59	Add multiple non-overlapping slots or set 24 hours
Daily limit: Times	Optional	Maximum number of transactions accepted per day	500	Positive integer; leave blank for unlimited
Daily limit: Balance	Optional	Maximum total transaction volume per day	2000000	Positive number; leave blank for unlimited
Limit per transaction	Optional	Maximum amount accepted in a single transaction	50000	Positive number; leave blank for unlimited
Targeted ranks	Optional	Select VIP member ranks allowed to use this account	VIP 1, VIP 2	If none selected, visible to all VIP ranks
Targeted player groups	Optional	Select specific customer groups	Regular players	Multi-select dropdown
Shown from deposit of (Deposit only)	Optional	Minimum lifetime accumulated deposit required to see this account	100	Positive integer; 0 or empty shows to everyone
Status	Required	Operational active switch	Active	New accounts start active by default

Account Activity Tab

When editing an existing account with transaction history, the Activity tab provides comprehensive reporting:

• Date Range Selector: Choose Today, 7 days, 30 days, or custom calendar range.
• 3 Summary Tiles: Approved count and volume, unapproved (refused/cancelled) count with percentage, and average approval time (auto vs. staff).
• Daily Approved Chart: Bar chart showing daily volume trends.
• Top Players Tile: Players with highest transaction volume through this account.
• Transactions Table: Full transaction ledger with search, outcome filters (All, Approved, Waiting, Refused, Cancelled), and CSV download.

---

8. Popups and Dialogs

1. Suggested Amounts Dialog (Recommended Amounts)

• Triggered By: Clicking the Suggested amounts button above the table.
• What You See: Visual preview of lobby amount buttons (min/max bound by Transaction Rules), editable list of suggested amounts, add/remove buttons.
• What to Do: Enter integer amounts greater than the site minimum and less than the site maximum.
• Result: Saves preset amount buttons shown to players in the deposit/withdrawal popup.

2. Limit Reset Dialog

• Triggered By: Clicking the RotateCcw icon button in the Daily limits column.
• What You See: Confirmation notice stating that the daily transaction count or volume cap will be restored.
• What to Do: Confirm by clicking Reset Now (or click Cancel).
• Result: Restores quota to 100% capacity immediately.

3. Check Before Adding Dialog (Review Dialog)

• Triggered By: Clicking Save when adding a new account.
• What You See: Large bank icon, account number, holder name, and security warning that account identity cannot be changed after transactions occur.
• What to Do: Verify account number and name against the bank passbook, then click Add account.
• Result: Saves and activates the new bank account.

4. Limit Change Effective Dialog

• Triggered By: Changing daily limits on an existing account and clicking Save.
• What You See: 3 choices:
  • Now, counting today's use (counted): Deducts today's usage from the new limit immediately.
  • Now, starting full (fresh): Ignores today's usage and applies the full new limit immediately.
  • From the next round (next): Keeps today's old limit; new limit starts at midnight (00:00).
• What to Do: Select the desired effective option and click Save.
• Result: Updates the daily limit according to the selected policy.

5. Delete Confirmation Dialog

• Triggered By: Clicking Delete from the three-dots menu on a switched-off account.
• What You See: Confirmation message displaying account holder and number.
• What to Do: Click Delete in red to confirm.
• Result: Removes the account from active views and archives it under Deleted accounts.

6. Version Conflict Dialog

• Triggered By: Another administrator saving changes to the same account concurrently.
• What You See: Notice that the current on-screen data is out of date.
• What to Do: Click Load latest to fetch the latest server data before resubmitting.

---

9. Statuses and Color Badges

Badge / Symbol	Color	Meaning	Action Required
Active switch	Green	Account is active and ready to process transactions within operating hours	Normal operation; no action required
Inactive switch	Grey	Account is temporarily paused and hidden from players	Toggle on when ready to use
Quota exhausted (0)	Red	Daily transaction count or volume limit has reached maximum	Click the reset button to restore quota or wait for midnight
Bank is off	Orange	Master bank is disabled under Bank list	Go to Payment setup > Bank list and enable the bank
LINE reader connected	Green	Account is connected to an active LINE reader	Auto-verification active
No LINE reader connected	Orange	Automatic account lacks a connected LINE reader	Click the badge to navigate to LINE bank-notice readers and bind
Deleted account	Grey	Account has been deleted; preserved for historical audit only	Cannot be reactivated; create a new account if needed
Slip upload warning	Orange	EasySlip integration is not yet configured	Go to Payment services > EasySlip to configure

---

10. Frequently Asked Questions and Troubleshooting

• If the Up/Down reorder arrows are disabled:
  • Check whether a search query is typed or an advanced filter is active. The system only permits reordering when viewing the full unfiltered list. Click Clear filters and try again.
• If the Delete button is disabled in the menu:
  • Toggle the account switch to Off (Grey) first. The system prohibits deleting actively running accounts.
• If Account Number or Holder Name fields are greyed out and locked:
  • The account has already processed financial transactions. Core identity fields are permanently locked to preserve accounting integrity. To change account numbers, deactivate this account and click Add an account to create a new one.
• If players cannot see the bank account in the deposit lobby:
  • Verify that the current time falls within the account's configured Operating hours.
  • Check whether the account's daily limit has been exhausted (red numbers in Daily limits column).
  • Verify that the player's VIP rank and player group match the rules under Targeted ranks and Targeted player groups.
  • Check whether the player meets the Shown from deposit of threshold.
• If an automatic deposit account fails to credit players automatically:
  • Check the LINE reader column. If an orange warning badge appears, the account has not been bound to a LINE reader route. Navigate to LINE bank-notice readers and configure the route.