LINE bank-notice readers

1. What is this page for?

The LINE bank-notice readers page is used to manage website LINE accounts that read incoming transfer notification messages from bank official accounts, bind LINE accounts to automated website receiving bank accounts, confirm official bank notification senders when receiving the first payment, and inspect all incoming bank notification messages in real time with quick links to matched deposits. It is designed for finance staff and administrators.

---

2. Before you start

• Required permissions: You must be granted the 'LINE bank-notice readers' permission in system roles to view, create, connect, and manage LINE accounts.
• Things to prepare:
  • A smartphone logged into the LINE account that has added the bank's official notification account (e.g., bank alert LINE Official Account) as a friend.
  • An automated receiving bank account created beforehand under Payment setup > Bank accounts (Receiving accounts > Auto tab) so it is ready to be bound to a LINE account.

---

3. Screen layout

When opening Payment services > LINE bank-notice readers, you will see the following components from top to bottom:

1. Page Header: Displays the title LINE accounts, a description, the Bank notifications button (to view the full incoming message log), and the New LINE account button.
2. Filter Tabs: Five summary cards at the top: All accounts, Reading (green), Need attention (yellow), Switched off (gray), and Deleted (red).
3. Search Filter Bar: Search input for finding accounts by LINE account label, bank prefix, or the receiving account's last 4 digits.
4. Row Count Summary and Refresh Button: Shows total record count and a manual refresh button (the page automatically refreshes every 20 seconds).
5. LINE Accounts Data Table: Main table showing account labels, status badges, bound banks, reading toggle switches, and row actions.
6. Table Pagination: Controls to choose rows per page (10, 20, 50) and navigate across pages.
7. Bank Notifications Log Sub-page: Accessed via the top-right button, used to monitor and audit every bank notification message read by the system in real time.

---

4. Search and filters

Filters on the LINE accounts view (Main View)

1. Status filter tabs: Click to filter accounts by operational group:
   • All accounts: View all active LINE accounts.
   • Reading: View accounts currently connected and actively reading incoming transfer notices.
   • Need attention: View accounts where reading has paused (not connected, session expired, or quiet).
   • Switched off: View accounts manually paused by staff.
   • Deleted: View previously removed LINE accounts.
2. Search bar: Type an account label, bank prefix, or 4 closing digits to filter table rows immediately.

Filters on the Bank notifications view (Sub-page)

1. Outcome tabs: Click to filter messages by parsing outcome (7 categories):
   • All: Every notification message received.
   • Waiting for staff: Amount parsed but held for manual review in the deposits screen.
   • Could not be read: Messages where amounts could not be extracted or non-standard format.
   • Credited: Successfully matched and credited to a player's wallet.
   • Rejected: Non-deposit messages or notices received while integration was paused.
   • Kept only: Informational bank messages preserved for audit records.
   • Being read: Messages currently undergoing system processing.
2. Search bar: Search message content, sender name, or payer account digits and click Search.
3. Advanced filters: Filter messages by specific Receiving account or Received on date range.

---

5. Data table

1. The site's LINE accounts table (Main View)

Column	What is shown	What it means	Badges or styling
LINE account	Account label	The label assigned to this LINE account	Bold text
Status	Status badge and sub-label	Connection and reader state of the LINE account	• Reading: Green badge (pulsing dot) • Connecting: Blue badge • Retrying: Yellow badge • Quiet: Yellow badge • Switched off: Gray badge • Not connected: Red badge
Banks read	Bank prefix & last 4 digits	Bound receiving bank accounts (click to open bank management dialog)	Gray badges (yellow dot if sender confirmation is pending)
Last edited	Date, time, and staff name	Timestamp and administrator who last updated this account	Plain text
Reading on	Toggle switch	Controls whether message reading is currently enabled	• On (green) = Actively reading and auto-crediting • Off (gray) = Temporarily paused
Actions	Action buttons	Available operations for that row	See button table below

Buttons in the Actions column (LINE Accounts Table)

Button / Menu	Icon / Styling	Action	Notes / Conditions
Banks read	Landmark icon / Gray	Open the dialog to bind banks or confirm senders	Always clickable
Rename (in ⋮ menu)	Pencil icon	Open dialog to update the account label	Always clickable
Connect LINE / Connect again (in ⋮ menu)	QR code icon	Open 3-step QR code handshake modal	Used when setting up a new account or reconnecting
Disconnect (in ⋮ menu)	Unplug icon	Sever the LINE session on the server	Stops reading immediately; bound bank routes remain intact
Delete (in ⋮ menu)	Trash icon / Red	Delete the LINE account from the system	Must switch "Reading on" to OFF first before delete unlocks

---

2. Bank notifications table (Sub-page)

Column	What is shown	What it means	Badges or styling
Received	Date and time	When the notification reached the system	Monospace timestamp
Receiving account	Logo, name, and last 4 digits	The website bank account that received the transfer	Bank icon with ···XXXX
Message	2-line message preview	Notification message text and parsed sender details	Clickable to inspect full message
Amount read	Formatted number	Deposit amount parsed from the message	Bold number (or — if unread)
State	Outcome badge and reason	Processing result and reason code	• Credited: Green badge • Waiting for staff: Yellow badge • Could not be read: Red badge • Rejected: Dark gray badge • Kept only: Gray badge • Being read: Blue badge
Deposit	Transaction ID & player username	Linked deposit transaction in CMS	Blue link (opens deposit details)
Actions	Eye icon button	Opens the full message detail dialog	Available on all rows

---

6. Step-by-step instructions

1. Creating and connecting a new LINE account via QR code

1. Go to Payment services > LINE bank-notice readers.
2. Click New LINE account in the top-right corner.
3. In the popup dialog, enter a label in Account name (e.g., LINE GSB Reader 1) and click Create.
4. The system opens the 3-step QR connection dialog automatically:
   • Step 1 — Scan the QR: Open the LINE app on your smartphone, open the QR scanner, and scan the QR code displayed on screen.
   • Step 2 — Enter the PIN: Enter the 4-6 digit verification PIN shown on screen into the LINE app on your smartphone before the countdown expires.
   • Step 3 — Done: When verification finishes, a green checkmark appears. Click Close.
5. The account status updates to the green Reading badge.

2. Binding a website receiving bank account to the LINE reader

1. On the row of the LINE account, click the landmark icon in the Actions column (or click the Banks read column).
2. In the dialog, scroll down to the Tie another bank section.
3. In the Receiving account dropdown, choose an automated receiving bank account (only unbound auto accounts appear).
4. Verify account name and number, then click Tie the bank.
5. Confirm in the prompt dialog. The bank route will be bound and issued a fresh notification token.

3. Confirming the official bank sender on first payment arrival

For security, when the first notification arrives for a newly tied bank, the system learns the sender and flags the bank with a yellow indicator stating 1 bank waits for sender confirmation:

1. Click the bank badge with the yellow indicator in the Banks read column.
2. In the yellow alert box, click See the messages to inspect the captured notification sample.
3. If confirmed to be the bank's genuine official account, click Confirm the sender.
4. The sender is verified; future incoming payments from this sender will now auto-credit player accounts.
5. If the sender is not the bank's official account, click Not the bank, learn again.

4. Toggling message reading on or off

1. Locate the switch in the Reading on column on the desired LINE account row.
2. Click the switch:
   • To switch off: Turn the switch off. In the confirmation dialog, click Switch off reading (incoming payments to bound banks will not auto-credit while off).
   • To switch on: Turn the switch on. The system resumes reading from where it paused.

5. Disconnecting or deleting a LINE account

1. Disconnecting (terminating session):
   • Click the ⋮ menu on the row and select Disconnect.
   • Confirm in the prompt. Reading stops immediately, but bound bank configurations are preserved and can be reconnected anytime.
2. Deleting a LINE account:
   • First toggle the switch in the Reading on column to Off.
   • Click the ⋮ menu and select Delete.
   • Confirm in the prompt. The account and its bank routes will be removed.

6. Inspecting bank notifications and opening linked deposits

1. Click Bank notifications in the top-right corner of the main screen.
2. Select a filter tab, such as Waiting for staff or Could not be read.
3. Click the eye icon in the Actions column to open the full message detail dialog.
4. If the message is tied to a player deposit, click Open the deposit to jump directly to the deposit transaction and review/approve it.

---

7. Form fields and edit screens

Fields in "New LINE account" or "Rename LINE account" dialog

Field	Required?	What to enter	Example	Constraints
Account name	Required	Descriptive label to identify the LINE account	LINE GSB Reader 1	1–120 characters, cannot be empty

Fields in "Tie another bank" section

Field	Required?	What to enter	Example	Constraints
Receiving account	Required	Website automated deposit bank account	Select from dropdown	Only unbound auto-mode receiving accounts can be selected

---

8. Popups and modal dialogs

1. LINE Account Name Dialog (LineAccountNameDialog)

• When it opens: When clicking New LINE account or choosing ⋮ > Rename.
• What is shown: Account name input, helper text, Cancel button, and Create (or Save) button.
• What to do: Enter the account label and click the submit button.
• Result: Saves the label and closes the dialog.

2. QR Connect Dialog (LineQrConnectDialog)

• When it opens: Automatically after creating a new account, or when clicking ⋮ > Connect LINE / Connect again.
• What is shown: 3-step progress bar (Scan QR, Enter PIN, Done), QR code image, numeric PIN code, and security caution note.
• What to do: Scan the QR with your phone LINE app and enter the PIN code into the phone.
• Result: Establishes the LINE session and updates the account status to Reading.

3. Bank Routes & Sender Confirmation Dialog (LineAccountBanksDialog)

• When it opens: When clicking the landmark icon in the row actions or clicking the bank badges.
• What is shown: List of currently bound banks, sender confirmation box (with view messages, confirm sender, and learn again buttons), unbind buttons, and the tie new bank section.
• What to do: Bind new receiving accounts or confirm learned senders.
• Result: Binds banks or validates senders for automatic deposit crediting.

4. Confirmation Prompt Modal (ConfirmModal)

• When it opens: When toggling reading off, disconnecting, deleting an account, binding a bank, or confirming/resetting senders.
• What is shown: Action title, description explaining the consequences, Cancel button, and action confirm button.
• What to do: Review the impact and click the confirmation button.
• Result: Executes the operation immediately.

5. Full Notification Message Detail Dialog (CmsDialog)

• When it opens: When clicking the eye icon in the bank notifications log.
• What is shown: Status chip, full raw message box, receiving account, received timestamp, parsed amount, parsed payer details, deposit link, and Open the deposit button.
• What to do: Review the transfer details and click Open the deposit if manual approval is required.
• Result: Opens the deposit transaction modal for staff review.

6. Version Conflict Dialog (VersionConflictDialog)

• When it opens: When another administrator modifies the account concurrently.
• What is shown: Message indicating data has changed, with a Load latest button.
• What to do: Click Load latest to fetch the latest server state.
• Result: Refreshes page data with current server values.

---

9. Status badges and indicators

LINE Account Statuses

Badge	Color	Meaning	What to do next
Reading	Green (pulsing dot)	Connected and actively reading incoming bank notices	Normal operation; no action required
Connecting	Blue	System is initializing the LINE connection handshake	Wait a moment for connection to finish
Retrying	Yellow	Connection interrupted; system is retrying automatically	Allow retry or reconnect if paused long
Quiet	Yellow	Account is connected but has not received signals for a while	Check phone connection or reconnect
Switched off	Gray	Message reading has been paused manually	Turn switch back on when ready
Not connected	Red	Account not connected or logged out on phone	Open ⋮ menu and select Connect again

Bank Sender Confirmation Statuses

Sender Status	Color	Meaning	What to do next
Sender confirmed	Green	Verified as the genuine bank official account	Incoming payments will auto-credit
Pending confirmation	Yellow	First payment received; waiting for staff to verify sender	Inspect message and confirm sender
No notices yet	Gray	No messages have been received for this bank yet	Awaiting initial payment notice

Bank Notification Message States

Badge	Color	Meaning	What to do next
Credited	Green	Matched with a player deposit and credited to wallet	Completed; no action required
Waiting for staff	Yellow	Amount was read, but held for manual staff verification	Open deposit to verify and approve
Could not be read	Red	Message format did not match bank deposit notice	Verify bank records and credit manually if valid
Rejected	Dark gray	Message was ignored or received while paused	Kept for audit records
Kept only	Gray	Informational message preserved for reference	Kept for audit records
Being read	Blue	Message is currently being processed by the system	Wait briefly for processing to complete

---

10. Frequently asked questions / troubleshooting

• If money was transferred into the bank account but the player was not credited automatically:
  1. Check if the bank badge in Banks read has a yellow dot indicating Pending confirmation. If so, click it, review the message sample, and click Confirm the sender.
  2. Verify that the LINE account status shows green Reading and the Reading on switch is enabled. If the session expired, click ⋮ > Connect again.
  3. Check the Bank notifications view to see if the message is in Waiting for staff. If so, click through to view the hold reason and approve it manually in the deposits screen.
• If the "Delete" button in the row menu is disabled (grayed out):
  • You must switch the toggle in the Reading on column to Off before the delete option unlocks, preventing accidental deletion of active accounts.
• If the QR code expires or scanning fails:
  • Click New QR at the bottom of the QR connect dialog to refresh the code and scan again.
• If a notification shows the red "Could not be read" badge:
  • This typically occurs if the bank sends a promotional notice, maintenance notice, or modified message format. Check your actual bank mobile app, and if a deposit was genuinely received, credit the player manually via the Players screen.