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 作為路由依據。
重置模式：控制累積金額的重置方式，僅有兩種模式
| 模式 | 說明 |
|---|---|
| 不重置 | 累積金額持續累加，不自動重置 |
| 每日 00:00 重置 | 每日凌晨 00:00 自動歸零累積金額 |
通道溢流機制
假設商戶的 7-ELEVEN 配置了兩個供應商：
- 插槽 1：供應商 A，限額 50,000 元，每日 00:00 重置
- 插槽 2：供應商 B，無限制
當供應商 A 當日累積金額達到 50,000 元後，新訂單自動路由到供應商 B。隔日凌晨 00:00 累積金額歸零，供應商 A 重新啟用。當所有通道都達到限額時，系統暫停接單，等待隔日 00:00 重置。
自動輪替（autoRecycle）模式的通道會在商戶列表中顯示當前的 輪替回合數 標籤，方便掌握輪替狀態。
自動開關服務
當某個支付方式的所有通道（所有子通路的所有供應商）都達到限額時，系統會自動關閉該支付方式。當任一通道額度恢復後，系統會自動重新啟用該支付方式。相關事件會記錄在通道切換歷程。
ATM 虛擬帳號
設定項目與超商代碼的單一通道組相同（無子通路拆分），差異在於使用不同的供應商選項和費率欄位。
卡對卡自動下撥（站點限定功能）：
| 欄位 | 說明 |
|---|---|
| 卡對卡自動下撥 | 開關，啟用後 CTCPAY 卡對卡訂單在繳費完成時自動觸發下撥結算至商戶雲帳戶 |
TIP
此開關僅在啟用 CTCPAY 卡對卡功能的站點顯示，與 ATM 服務通道並排於同一列。需先啟用 ATM 支付方式才可操作此開關。
信用卡
設定項目與超商代碼的單一通道組相同（無子通路拆分），差異在於使用不同的供應商選項和費率欄位。
轉帳設定
| 欄位 | 說明 |
|---|---|
| 轉帳服務費率 | 代付時的服務費百分比 |
| 轉帳手續費 | 代付時的固定手續費（元） |
| 雲帳戶日限額 | 該商戶每日可代付的最高金額上限 |
代付時段金額區間
站點限定功能，啟用後可為每個商戶設定不同時段的代付金額限制。
| 欄位 | 說明 |
|---|---|
| 時段 | 起始小時 ~ 結束小時（24 小時制） |
| 最小金額 | 該時段允許的最小代付金額 |
| 最大金額 | 該時段允許的最大代付金額 |
可新增多組時段規則，每組獨立設定。商戶提交代付申請時，系統會根據當前時間判斷是否在允許的時段內，並驗證金額是否符合區間限制。
TIP
此設定區塊僅在特定站點（如 AUY支付）顯示。商戶在代付申請頁面會看到當前可用的時段與金額範圍提示。
黑名單阻擋開單
商戶可啟用黑名單阻擋功能，當訂單建立時比對到黑名單，系統會直接 拒絕建立訂單（而非僅標記警示）。
| 欄位 | 說明 |
|---|---|
| 啟用 | 開啟/關閉黑名單阻擋功能 |
| 比對欄位 | 可分別勾選：姓名、手機號碼、電子郵件。僅勾選的欄位會參與比對 |
WARNING
啟用阻擋功能後，命中黑名單的訂單將無法建立，API 會回傳錯誤碼 4320。與原本僅標記的行為不同，請確認商戶已知悉此變更。
保留款
| 欄位 | 說明 |
|---|---|
| 保留款金額 | 設定該商戶的保留款金額。保留款會從雲帳戶餘額中扣除，計算可用餘額時使用：可用餘額 = 餘額 − 保留款 |
假資料管理
假資料功能用於替換訂單中的買家個人資訊（姓名、手機、信箱等），保護商戶客戶隱私。
| 欄位 | 說明 |
|---|---|
| 啟用 | 開啟/關閉假資料替換功能 |
| 假資料集 | 管理假資料項目，每筆包含姓名、手機、信箱等欄位 |
| 使用次數 | 顯示每筆假資料已被使用的次數 |
| 從主站同步 | 可從主站一鍵同步假資料集（測試站限定，正式環境隱藏同步按鈕） |
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
刪除商戶會同時移除該商戶所有相關資料，此操作不可復原。