Appearance
代付資料審核
路徑：/admin/finance/payment-review | 快捷鍵：8 → Z
審核商戶提交的代付（提款）申請，管理員可核准或駁回申請，並上傳付款憑證。頁面透過 WebSocket 即時接收新申請通知。
篩選條件
| 篩選項目 | 說明 |
|---|---|
| 日期範圍 | 申請日期範圍，預設為今日 |
| 商戶 | 下拉選取全部或特定商戶 |
| 狀態 | 全部 / PENDING / SUCCESS / REJECTED |
| 申請提領金額 | 運算子（≥ 大於等於、≤ 小於等於、= 等於）搭配金額數值 |
| 銀行代碼 | 可搜尋的銀行下拉選單 |
| 分行代碼 | 可搜尋的分行下拉選單（依銀行連動） |
| 銀行帳號 | 依銀行帳號搜尋 |
| 提領編號 / 商戶訂單號 | 依提領編號或商戶端訂單號搜尋 |
篩選列右側常駐統計摘要：總筆數、總金額、總服務費、總手續費。
（站點限定） 部分站點會多一格 合計費用＝總手續費＋總服務費，用不同底色標示，方便直接看出這批代付總共收了多少費用，不必自己把兩個數字加起來。其他站點不顯示這一格。
工具列按鈕
| 按鈕 | 說明 |
|---|---|
| 查詢 | 依目前條件搜尋 |
| 匯出 | 將篩選結果匯出為 CSV（需 payout.export 權限） |
| 歷史待審核單 | 快速調出所有尚未處理的待審核代付單 |
| 複製版型設定 | 設定「複製代付資訊」時輸出的文字版型（見下方） |
| 註記 | 開啟「代付帳號註記管理」彈窗 |
代付帳號註記管理
點擊工具列的 「註記」 按鈕開啟彈窗，可管理特定銀行帳號的註記標記。
- 新增註記時指定銀行帳號與備註說明
- 已註記的帳號在代付列表中會以 琥珀色背景 醒目標示，方便管理員辨識需關注的帳戶
- 可新增、編輯或刪除註記
彈窗操作按鈕
| 按鈕 | 條件 | 說明 |
|---|---|---|
| 從主站同步 | 從站限定 | 一鍵從主站同步註記資料，完成後顯示差異摘要（總數／新增／移除） |
| 匯出 | - | 將目前的註記清單匯出為 CSV |
| 匯入 | - | 從 CSV 批次匯入註記 |
| 新增 | - | 展開新增表單，填寫銀行帳號與備註 |
表單改為按需展開
新增／編輯表單改為點擊「新增」或編輯按鈕後才展開，未使用時不佔用彈窗空間，註記清單可顯示更多筆。點擊「取消」可隨時收合表單。
表格欄位
| 欄位 | 說明 |
|---|---|
| 序號 | 列表序號 |
| 建立時間 | 申請提交的日期時間 |
| 提領編號 | 代付識別碼（等寬字型） |
| 商戶 | 申請商戶名稱 |
| 金額 | 代付金額（粗體，$ 前綴） |
| 手續費 | 代付手續費 |
| 銀行代碼 | 收款銀行代碼（上方顯示代碼，下方顯示銀行名稱） |
| 分行代碼 | 收款分行代碼 |
| 銀行帳號 | 收款帳號（等寬字型） |
| 戶名 | 收款帳戶名稱 |
| 狀態 | 審核狀態標籤 |
| 代付通道 | （站點限定） 這筆錢是用哪張卡出的（見下方指定代付通道）；其他站點沒有這一欄 |
| 來源 | 後台（後台申請）或 串接（API 提交） |
| 操作者 | 提交申請的人員 |
| IP | 提交者 IP |
| 操作 | 功能按鈕 |
代付金額的小數顯示
代付的金額、服務費、手續費整數就不顯示小數點（$10,000 而不是 $10,000.00），只有真的有小數時才顯示（例如服務費算出 $1,000.5）。列表、明細、審核與補傳憑證彈窗、複製範本、匯出檔案、Telegram 代付通知與站內信都是同一套規則。
代收訂單、結算與餘額的金額不套用這條規則 —— 有啟用金額小數的站點在那些地方仍固定顯示到小數第二位。
狀態說明
| 狀態 | 說明 |
|---|---|
| PENDING | 待審核 |
| SUCCESS | 已核准 |
| REJECTED | 已駁回 |
歷史待審核單
篩選區域提供 「歷史待審核單」 按鈕（黃色，帶歷史圖示）。點擊開啟彈窗，一次顯示全部 PENDING 狀態的代付申請（不受日期篩選限制），方便管理員快速瀏覽所有尚未處理的申請。
彈窗中每筆紀錄提供：
- 複製：依範本格式複製代付資訊
- 核准 / 駁回：直接在彈窗中操作，確認後會關閉歷史彈窗並開啟審核確認彈窗
TIP
當無待審核申請時，會顯示「無待審核代付單」提示。
操作按鈕
表格中的操作按鈕皆以純圖示顯示，滑鼠懸停時以 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 通知訊息（不收回），方便作為已完成的紀錄留存。
查看憑證
當狀態為 SUCCESS 且已上傳憑證時，點擊可開啟全螢幕圖片檢視器（ImageViewer），支援縮放、旋轉、拖曳等操作。
補傳憑證
當狀態為 SUCCESS 但尚未上傳憑證時，可補傳付款憑證圖片。
匯出 CSV
點擊 「匯出」 按鈕，匯出所有篩選結果（上限 99,999 筆）。
匯出欄位包含：建立時間、提領編號、商戶、金額、手續費、銀行代碼、分行代碼、銀行帳號、戶名、狀態、來源、操作者、IP、審核者、審核時間、備註、審核備註。
即時更新
頁面透過 WebSocket 連線即時接收代付申請的狀態變更，新申請或狀態更新時列表自動重新整理。
虛擬滾動
代付列表採用虛擬滾動載入，每次載入 20 筆，捲動至底部自動載入更多，大幅提升大量資料的瀏覽效能。
CSV 匯出注意事項
匯出的 CSV 中，銀行帳號欄位強制以文字格式輸出，避免 Excel 自動將前導零移除。