代付資料審核

路徑：/admin/finance/payment-review  |  快捷鍵：8 → Z

審核商戶提交的代付（提款）申請，管理員可核准或駁回申請，並上傳付款憑證。頁面透過 WebSocket 即時接收新申請通知。

篩選條件

篩選項目	說明
日期區間	申請日期範圍，預設為今日
商戶	下拉選取全部或特定商戶
狀態	全部 / PENDING / SUCCESS / REJECTED
金額條件	運算子（≥、≤、=）搭配金額數值
銀行代碼	可搜尋的銀行下拉選單
分行代碼	可搜尋的分行下拉選單（依銀行連動）
銀行帳號	依銀行帳號搜尋
代付編號	依代付編號搜尋

代付帳號註記管理

篩選區域提供 「代付帳號註記管理」 按鈕，可管理特定銀行帳號的註記標記。

• 新增註記時指定銀行帳號與備註說明
• 已註記的帳號在代付列表中會以 琥珀色背景 醒目標示，方便管理員辨識需關注的帳戶
• 可新增、編輯或刪除註記

表格欄位

欄位	說明
序號	列表序號
建立時間	申請提交的日期時間
代付編號	代付識別碼（等寬字型）
商戶	申請商戶名稱
金額	代付金額（粗體，$ 前綴）
手續費	代付手續費
銀行代碼	收款銀行代碼
分行代碼	收款分行代碼
銀行帳號	收款帳號（等寬字型）
戶名	收款帳戶名稱
狀態	審核狀態標籤
來源	Portal（後台申請）或 API（API 提交）
操作者	提交申請的人員
IP	提交者 IP
操作	功能按鈕

狀態說明

狀態	說明
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 狀態顯示：

• 核准（綠色按鈕）：開啟審核彈窗，可上傳付款憑證圖片與填寫審核備註
• 駁回（紅色按鈕）：開啟審核彈窗，填寫駁回原因

查看憑證

當狀態為 SUCCESS 且已上傳憑證時，點擊可開啟全螢幕圖片檢視器（ImageViewer），支援縮放、旋轉、拖曳等操作。

補傳憑證

當狀態為 SUCCESS 但尚未上傳憑證時，可補傳付款憑證圖片。

匯出 CSV

點擊 「匯出」 按鈕，匯出所有篩選結果（上限 99,999 筆）。

匯出欄位包含：建立時間、代付編號、商戶、金額、手續費、銀行代碼、分行代碼、銀行帳號、戶名、狀態、來源、操作者、IP、審核者、審核時間、備註、審核備註。

即時更新

頁面透過 WebSocket 連線即時接收代付申請的狀態變更，新申請或狀態更新時列表自動重新整理。

無限捲動

代付列表採用無限捲動載入，每次載入 20 筆，捲動至底部自動載入更多。