Appearance
代付資料審核
路徑：/admin/finance/payment-review | 快捷鍵：8 → Z
審核商戶提交的代付（提款）申請，管理員可核准或駁回申請，並上傳付款憑證。頁面透過 WebSocket 即時接收新申請通知。
篩選條件
| 篩選項目 | 說明 |
|---|---|
| 日期範圍 | 申請日期範圍，預設為今日 |
| 商戶 | 下拉選取全部或特定商戶 |
| 狀態 | 全部 / PENDING / SUCCESS / REJECTED |
| 申請提領金額 | 運算子（≥ 大於等於、≤ 小於等於、= 等於）搭配金額數值 |
| 銀行代碼 | 可搜尋的銀行下拉選單 |
| 分行代碼 | 可搜尋的分行下拉選單（依銀行連動） |
| 銀行帳號 | 依銀行帳號搜尋 |
| 提領編號 / 商戶訂單號 | 依提領編號或商戶端訂單號搜尋 |
篩選列右側常駐統計摘要：總筆數、總金額、總服務費、總手續費。
測試商戶的代付單
商戶選「全部」時，商戶代碼為 OTTEST 的測試商戶的代付單不會列出，也不計入上方統計。 要查測試商戶的代付單，請在「商戶」下拉明確選取該商戶 —— 選了就一定查得到。
統計列另有一格 合計費用＝總手續費＋總服務費，用不同底色標示，方便直接看出這批代付總共收了多少費用，不必自己把兩個數字加起來。
篩選條件記憶（站點限定）
部分站點的這一頁會記住你調過的篩選條件：按瀏覽器重新整理（或 F5）條件原樣還在，不必每次都把日期、商戶、狀態、銀行重設一遍。
記住的範圍是上面那張表的所有欄位，外加日期選擇器裡的起訖時間（例如 09:00:00 ~ 18:00:00）。
「提領編號 / 商戶訂單號」不記：那是一次性的單筆查詢，記住它會讓下次重新整理永遠只看到那一筆。
重新整理會留，開新分頁回預設
條件只屬於當前這個分頁。同一分頁重新整理條件還在；把網址複製到新分頁、或另外開一個代付審核頁，都是從預設條件開始，關掉分頁後也不再保留。
這是刻意的：你可能同時開兩個分頁分別盯不同商戶或不同金額區間，設定若跟著整個瀏覽器走，開新分頁就會被上一個分頁的條件汙染。與訂單頁的篩選條件記憶是同一套設計。
日期記的是絕對日期，不會跟著換日
記住的是「9 月 18 日」而不是「今天」。分頁開著跨過午夜再重新整理，還原的仍是前一天的區間 —— 日期就顯示在篩選列上，換日後按一下「本日」即可。
從連結帶提領編號進來的不受影響
用帶提領編號的網址跳進這一頁時一律不套用記住的條件。那種連結帶的是明確的單一意圖，疊上舊的商戶或日期條件會變成「點進來卻查無資料」。
未啟用的站點不受任何影響：篩選條件照樣每次重新整理歸零，瀏覽器裡也不會留下任何紀錄。
工具列按鈕
| 按鈕 | 說明 |
|---|---|
| 查詢 | 依目前條件搜尋 |
| 匯出 | 將篩選結果匯出為 CSV（需 payout.export 權限） |
| 歷史待審核單 | 快速調出所有尚未處理的待審核代付單 |
| 複製版型設定 | 設定「複製代付資訊」時輸出的文字版型（見下方） |
| 註記 | 開啟「代付帳號註記管理」彈窗 |
代付帳號註記管理
點擊工具列的 「註記」 按鈕開啟彈窗，可管理特定銀行帳號的註記標記。
- 新增註記時指定銀行帳號與備註說明
- 已註記的帳號在代付列表中會以 琥珀色背景 醒目標示，方便管理員辨識需關注的帳戶
- 可新增、編輯或刪除註記
彈窗操作按鈕
| 按鈕 | 條件 | 說明 |
|---|---|---|
| 匯出 | - | 將目前的註記清單匯出為 CSV |
| 匯入 | - | 從 CSV 批次匯入註記（要把註記複製到另一個站點時，就用這一組） |
| 新增 | - | 展開新增表單，填寫銀行帳號與備註 |
表單改為按需展開
新增／編輯表單改為點擊「新增」或編輯按鈕後才展開，未使用時不佔用彈窗空間，註記清單可顯示更多筆。點擊「取消」可隨時收合表單。
表格欄位
| 欄位 | 說明 |
|---|---|
| 序號 | 列表序號 |
| 建立時間 | 申請提交的日期時間 |
| 提領編號 | 代付識別碼（等寬字型） |
| 商戶 | 申請商戶名稱 |
| 金額 | 代付金額（粗體，$ 前綴） |
| 手續費 | 代付手續費 |
| 銀行代碼 | 收款銀行代碼（上方顯示代碼，下方顯示銀行名稱） |
| 分行代碼 | 收款分行代碼 |
| 銀行帳號 | 收款帳號（等寬字型） |
| 戶名 | 收款帳戶名稱 |
| 狀態 | 審核狀態標籤 |
| 代付通道 | （站點限定） 這筆錢是用哪張卡出的（見下方指定代付通道）；其他站點沒有這一欄 |
| 來源 | 後台（後台申請）或 串接（API 提交） |
| 操作者 | 提交申請的人員 |
| IP | 提交者 IP |
| 操作 | 功能按鈕 |
代付金額的小數顯示
代付的金額、服務費、手續費整數就不顯示小數點（$10,000 而不是 $10,000.00），只有真的有小數時才顯示（例如服務費算出 $1,000.5）。列表、明細、審核與補傳憑證彈窗、複製範本、匯出檔案、Telegram 代付通知與站內信都是同一套規則。
代收訂單、結算與餘額的金額不套用這條規則 —— 有啟用金額小數的站點在那些地方仍固定顯示到小數第二位。
狀態說明
| 狀態 | 說明 |
|---|---|
| PENDING | 待審核 |
| SUCCESS | 已核准 |
| REJECTED | 已駁回 |
歷史待審核單
篩選區域提供 「歷史待審核單」 按鈕（黃色，帶歷史圖示）。點擊開啟彈窗，一次顯示全部 PENDING 狀態的代付申請（不受日期篩選限制），方便管理員快速瀏覽所有尚未處理的申請。
彈窗中每筆紀錄提供：
- 複製：依範本格式複製代付資訊
- 核准 / 駁回：直接在彈窗中操作，確認後會關閉歷史彈窗並開啟審核確認彈窗
TIP
當無待審核申請時，會顯示「無待審核代付單」提示。
待審核數量提醒（紅點）
側邊欄「代付資料審核」選單與頁首右上角都會顯示紅色數字，代表目前**待審核（PENDING）**的代付單數量。
- 不含測試商戶（
OTTEST）的代付單 —— 測試單不會讓紅點一直掛著 - 進入後台時與之後的即時推播使用同一套計算，重新整理前後的數字一致，不會出現「重整後正確、過一會兒又跳回錯的」情況
- 有新申請或審核完成時數字即時更新
操作按鈕
表格中的操作按鈕皆以純圖示顯示，滑鼠懸停時以 tooltip 提示功能名稱。
商戶回調紀錄
僅在 SUCCESS 或 REJECTED 狀態顯示。點擊 Webhook 圖示開啟彈窗，顯示：
- 提領編號
- 回調網址（商戶設定的 notifyUrl）
- 回調嘗試列表：每次嘗試顯示嘗試次數、時間戳、HTTP 回應狀態碼、請求內容（JSON）、回應內容
- 人工補發回調 按鈕：可手動重新發送回調通知至商戶，操作前需經過二次確認
共用元件
商戶回調紀錄（MerchantNotifyLogs）為共用元件，同樣用於超商代碼、ATM、信用卡等訂單查詢頁面。
複製範本
點擊複製圖示，將代付資訊依據自訂範本格式複製到剪貼簿。
範本變數： {merchantName}、{merchantCode}、{bankCode}、{branchCode}、{bankCodeName}、{bankAccount}、{accountName}、{amount}、{fee}、{payoutNo}、{createdAt}、{remark}、{status}
點擊範本設定（齒輪圖示）可自訂範本格式：
- 可用變數以標籤顯示，點擊插入
- 即時預覽面板顯示實際輸出
- 範本儲存於瀏覽器 localStorage
複製歷史：每次複製會記錄操作者名稱、時間、IP 與指紋，顯示於複製按鈕的 tooltip 中。
核准 / 駁回
僅在 PENDING 狀態顯示：
- 核准（綠色按鈕）：開啟審核彈窗，可上傳付款憑證圖片與填寫審核備註
- 駁回（紅色按鈕）：開啟審核彈窗，填寫駁回原因
指定代付通道
站點限定
只有啟用此功能的站點，審核彈窗才會出現「代付通道」下拉；其他站點沒有這個欄位。
核准時可以指定這筆錢是用哪張卡出的，這個值會顯示在列表的「代付通道」欄， 並累計進通道列表的代付統計。
- 下拉預設只列出標示為 僅限代付 且啟用中的卡對卡卡片，那是絕大多數情況要挑的範圍
- 下拉上方有 「顯示全部通道」 開關。同一個網銀帳號同時做代收與代付時， 那張卡不會標成「僅限代付」、預設也就不在清單裡 —— 打開開關就能挑到它。 展開後僅限代付的卡仍排在最前面並標上「僅限代付」標籤
- 開關的狀態會記住，下次打開審核彈窗維持你上次的選擇
- 不選就不寫：留空送出不會清掉自動代付已經寫好的卡片
預設不全列是刻意的
啟用中的卡對卡卡片可能有兩百多張，全部列出來會讓原本只在幾張裡挑的操作員每次都要翻很久， 選錯就是把出款金額掛到一張根本沒出過款的收款卡上。
自動代付完成時的處理
爬蟲自動代付在向銀行查證確認匯出成功後，會走與人工按下「核准」完全相同的流程 —— 扣商戶錢包（金額＋手續費）、寫餘額異動紀錄與操作歷程、推播、站內信， 以及發回調通知商戶。審核人會記為「自動代付（查證確認）」，並帶著銀行交易序號以便對帳。
若這張單在此之前已經被人工審過，系統不會把它退回可重跑的狀態（錢已經匯出去了）， 只會把錯誤訊息留在單上交人工處理。
TG 通知自動收回
審核完成後（無論核准或駁回），系統會自動刪除該筆代付在 Telegram 群組中的通知訊息，確保群組內只保留待處理的代付通知。
例外：部分站點設定為代付審核通過後 保留 TG 通知訊息（不收回），方便作為已完成的紀錄留存。
事後修改代付通道
站點限定
只有啟用代付通道統計的站點才有這個功能。
審核時選錯卡、或當時沒選，事後可以在列表「代付通道」欄點旁邊的橘色「左右箭頭」圖示改正。
誰能用：角色需具備「代付資料審核 → 修改代付通道」權限（最高管理角色自動擁有，其他角色請到「權限管理 → 角色」勾選）。有權限就能直接使用，不需要 Google 驗證碼；沒有權限的帳號看不到這顆按鈕。
哪些代付單能改：只有已完成的代付單。待審核的單還在處理中，已駁回的單錢沒有匯出去，都不能改。
可選的通道：所有卡對卡通道，包含已停用的卡（當初出款的卡事後可能已經停用），也可以改成「不指定」，代表這筆不計入任何通道。
操作步驟：
- 選新的代付通道，按「下一步」。
- 確認畫面會顯示這筆的統計（1 筆與金額）會從哪張卡轉到哪張卡，按「確認修改」才會送出。
修改後系統會做的事：
- 通道列表的代付統計會一併轉移：原通道少 1 筆與這筆金額，新通道多 1 筆與這筆金額。「今日」的歸屬仍以實際出款時間為準，不會因為修改而變成今天。
- 代付審核列表、匯出 CSV、雲帳戶歷程的「代付通道」都會顯示新的通道。
- 修改前後的通道與金額會寫進操作歷程。
不會影響：商戶的錢包餘額、代付回調（不會重發）、Telegram 通知、自動代付的派工。
查看憑證
當狀態為 SUCCESS 且已上傳憑證時，點擊可開啟全螢幕圖片檢視器（ImageViewer），支援縮放、旋轉、拖曳等操作。
補傳憑證
當狀態為 SUCCESS 但尚未上傳憑證時，可補傳付款憑證圖片。
TG 代付領單
需先在 TG 機器人打開「代付領單」（每隻機器人預設關閉）。開啟後，代付申請的 TG 通知會帶「🙋 領取」按鈕，群組裡的人領單、匯款後按「✅ 已完成」，系統就會自動審核通過並回調商戶（與在這裡按「核准」完全相同：扣商戶餘額、記錄異動、發回調與站內信）。設定方式見 TG 機器人 → 代付領單。
這一頁會多出：
| 項目 | 說明 |
|---|---|
| 狀態欄下方的領取狀態 | 未領取／領取中：某某 · N 分鐘／TG 完成：某某／自動代付處理中（有機器人開啟代付領單時才標「未領取」）。領取超過 30 分鐘還沒完成會變成紅色 |
| 核准／駁回時的提醒 | 單已被別人在 TG 領走時，彈窗會列出領取人與領取時間，必須勾選「我已與某某確認，這筆沒有重複匯款」才能送出 |
| 強制釋放（🔓） | 有「強制退回」權限的人可以釋放領取（例如領取人已下班），必須填原因。釋放後 TG 訊息恢復「領取」按鈕 |
避免重複匯款
- 已被 TG 領走的單，自動代付不會再處理；自動代付處理中的單，TG 也領不到。
- 強制釋放或在這裡核准之前，請先確認領取人沒有匯出這筆款項。
匯出 CSV
點擊 「匯出」 按鈕，匯出所有篩選結果（上限 99,999 筆）。
匯出欄位包含：建立時間、提領編號、商戶、金額、手續費、銀行代碼、分行代碼、銀行帳號、戶名、狀態、來源、操作者、IP、審核者、審核時間、備註、審核備註。
即時更新
頁面透過 WebSocket 連線即時接收代付申請的狀態變更，新申請或狀態更新時列表自動重新整理。
虛擬滾動
代付列表採用虛擬滾動載入，每次載入 20 筆，捲動至底部自動載入更多，大幅提升大量資料的瀏覽效能。
CSV 匯出注意事項
匯出的 CSV 中，銀行帳號欄位強制以文字格式輸出，避免 Excel 自動將前導零移除。