Appearance
商戶資料管理
路徑：/admin/merchants/data | 快捷鍵：5 → V
商戶資料管理是系統後台最核心的配置頁面，用於建立與管理商戶、設定支付通道、配置費率與限額、管理 IP 白名單等。
頁面說明
頁面顯示可拖拽排序的商戶列表，每列顯示：
| 欄位 | 說明 |
|---|---|
| 拖拽把手 | 拖動可調整商戶顯序 |
| 商戶名稱 | 商戶的顯示名稱 |
| 商戶代碼 | 6 位英數字代碼，用於 API 串接識別 |
| 支付通道 | 四列顯示（CVS 7-11 / CVS 全家 / ATM / 信用卡），每列顯示當前輪替使用中的供應商名稱。欄位標題旁有刷新按鈕，點擊可重新查詢所有商戶的當前通道狀態。滑鼠懸停可查看手續費、費率、驗證、繳費期限、撥款日等詳細設定 |
| 轉帳設定 | 服務費率、手續費、雲帳戶日限額 |
| 撥款天數 | 各支付方式的撥款日設定（如 T+2、D+3） |
| 服務狀態 | API 服務是否啟用 |
| 啟用狀態 | 商戶是否啟用 |
| IP 白名單 | 點擊查看/管理該商戶的 IP 白名單 |
| 操作 | 編輯、刪除按鈕 |
新增商戶
- 點擊 「新增商戶」 按鈕，開啟設定表單
基本資訊
| 欄位 | 必填 | 說明 |
|---|---|---|
| 商戶名稱 | 是 | 商戶的顯示名稱 |
| 商戶代碼 | 自動 | 系統自動產生 6 位英數字代碼（避免混淆字元如 0/O/1/I），可點擊重新產生 |
串接配置
| 欄位 | 說明 |
|---|---|
| API 服務 | 啟用/停用商戶的 API 存取權限 |
| 機器人回調 | 啟用/停用機器人回調功能 |
| API Secret | 建立後產生的 API 金鑰，可查看、複製 |
支付通道設定
系統支援三種支付方式，每種獨立設定：
超商代碼（CVS）
| 欄位 | 說明 |
|---|---|
| 啟用 | 開關此支付方式 |
| 交易手續費 | 每筆交易的固定手續費（元） |
| 撥款費率 | 撥款時扣除的百分比費率 |
| 驗證功能 | 開啟後系統會比對預約通路與實際付款通路 |
| 繳費期限 | 1~30 天，超過期限未繳則訂單過期 |
| 撥款日設定 | 透過 SettlementPicker 選擇，例如 T+2 表示付款後 2 個工作天撥款 |
供應商通道插槽（7-ELEVEN / 全家獨立配置）：
超商代碼的供應商通道分為 7-ELEVEN 和 全家 兩組獨立配置。每組可各自設定不同的供應商、優先順序、限額與重置時間。這是因為不同金流供應商支援的超商通路不同：
- OMG：支援 7-ELEVEN + 全家
- 客樂得（CATPAY）：僅支援 7-ELEVEN
供應商下拉選單會根據子通路自動過濾，僅顯示支援該超商的供應商。
每組通道的運作方式相同，可配置多個供應商按優先順序排列：
- 第一個插槽：最高優先順序，訂單優先分配至此供應商
- 後續插槽：當上一個插槽達到限額後，訂單自動溢流至下一個供應商
- 最後一個插槽：固定為無限制模式，承接所有溢流訂單
每個插槽的設定：
| 欄位 | 說明 |
|---|---|
| 供應商 | 從支援該超商通路的供應商列表中選取（同一組中不可重複選取） |
| 限額模式 | 無限制 或 自訂金額（設定累積上限） |
| 累積金額 | 顯示目前已累積的金額與進度條 |
建立訂單時，系統根據 cvsChannel 參數自動路由到對應的通道組：
SEVEN→ 使用 7-ELEVEN 通道配置FAMILY→ 使用全家通道配置
若未帶 cvsChannel，系統會取 cvsReservations[0].channel 作為路由依據。
滑動時間窗口（重置時間）：控制累積金額的計算範圍，採用滑動時間窗口機制
| 值 | 說明 |
|---|---|
| 不重置 | 累積金額持續累加，不自動重置 |
| 30s ~ 30d | 僅統計最近指定時間內的已付款訂單金額 |
可選時間：30s、1m、2m、5m、15m、30m、1h、6h、12h、1d、3d、7d、14d、30d
通道溢流機制
假設商戶的 7-ELEVEN 配置了兩個供應商：
- 插槽 1：供應商 A，限額 50,000 元，重置時間 1 天
- 插槽 2：供應商 B，無限制
當供應商 A 最近 1 天內的已付款金額達到 50,000 元後，新訂單會自動路由到供應商 B。隨著時間推移，較早的訂單超出時間窗口後，供應商 A 的累積金額自然下降，額度恢復後系統會自動重新啟用。
自動開關服務
當某個支付方式的所有通道（所有子通路的所有供應商）都達到限額時，系統會自動關閉該支付方式。當任一通道額度恢復後，系統會自動重新啟用該支付方式。相關事件會記錄在通道切換歷程。
ATM 虛擬帳號
設定項目與超商代碼的單一通道組相同（無子通路拆分），差異在於使用不同的供應商選項和費率欄位。
信用卡
設定項目與超商代碼的單一通道組相同（無子通路拆分），差異在於使用不同的供應商選項和費率欄位。
轉帳設定
| 欄位 | 說明 |
|---|---|
| 轉帳服務費率 | 代付時的服務費百分比 |
| 轉帳手續費 | 代付時的固定手續費（元） |
| 雲帳戶日限額 | 該商戶每日可代付的最高金額上限 |
IP 白名單
- 新增或移除商戶的 API 來源 IP 限制
- 支援 IPv4 和 IPv6 格式
- IP 格式驗證：輸入不合法的 IP 會顯示錯誤提示
編輯商戶
點擊操作欄的編輯圖示，開啟同樣的設定表單（商戶代碼為鎖定狀態）。
API Secret 管理
在編輯模式下的串接配置區域：
- 查看金鑰：點擊眼睛圖示顯示/隱藏 API Secret
- 複製金鑰：點擊複製圖示將 Secret 複製到剪貼簿
- 重新產生金鑰：需輸入 TOTP 二階段驗證碼才能重新產生
DANGER
重新產生 API Secret 後，商戶需要更新其系統中的金鑰，否則 API 串接將失敗。請確保通知商戶更新。
IP 白名單快捷操作
在商戶列表中，每列的 IP 白名單欄位提供快捷操作：
- 已有 IP 的商戶：顯示 IP 數量按鈕，點擊展開 popover 可查看所有 IP、新增 IP、刪除 IP、複製 IP
- 尚無 IP 的商戶：顯示 ➕ 圖示，點擊直接新增第一筆 IP
拖拽排序
拖動商戶列的左側把手可調整商戶的顯示順序，放開後自動儲存。
刪除商戶
點擊刪除按鈕並確認後即刪除商戶。
DANGER
刪除商戶會同時移除該商戶所有相關資料，此操作不可復原。