商戶資料管理

路徑：/admin/merchants/data  |  快捷鍵：5 → V

商戶資料管理是系統後台最核心的配置頁面，用於建立與管理商戶、設定支付通道、配置費率與限額、管理 IP 白名單等。

頁面按鈕

頁面右上角提供三個按鈕：

按鈕	權限 / 條件	說明
通道排序	merchants.update，且站點未啟用通道列表功能	開啟拖拉排序彈窗，調整通道在全站下拉選單中的顯示順序（詳見通道列表）
管理假資料	-	開啟假資料管理彈窗（原本位於商戶編輯彈窗內，已移至列表頁，不需先開啟商戶即可管理）
新增商戶	merchants.create	開啟商戶設定表單

頁面說明

頁面顯示可拖拽排序的商戶列表，每列顯示：

欄位	說明
拖拽把手	拖動可調整商戶顯序
商戶名稱	商戶的顯示名稱
商戶代碼	6 位英數字代碼，用於 API 串接識別
當日收款上限	逐列顯示有設定上限的支付方式（CVS / ATM / 信用卡）。每列左側為方式標籤，右側為 進度條在上、今日已收 / 上限 數字在下 的直式排列。三種方式皆未設定上限時顯示 -
代收設定	四列顯示（CVS 7-11 / CVS 全家 / ATM / 信用卡），每列顯示當前輪替使用中的供應商名稱；若該通道有設定累積限額，供應商名稱 下方 會多一行 額度進度條 + 已累積金額 / 限額。欄位標題旁有刷新按鈕，點擊可重新查詢所有商戶的當前通道狀態。滑鼠懸停可查看手續費、費率、驗證、繳費期限、撥款日等詳細設定。（站點限定） 部分站點會在超商（7-11／全家共用一個）、ATM、信用卡左側各顯示一個開關，可直接開關該商戶的代收方式
代付設定	代付開關、服務費（%）、手續費（元）、每日上限（元）、保留款（元）。（站點限定） 部分站點這裡是一個可直接切換的開關；其他站點顯示唯讀的「代付開啟／代付關閉」徽章，要改須進編輯視窗
撥款天數設定	逐列顯示超商代碼 / ATM / 信用卡的撥款規則（如 T/0、D/3）
API服務	API 服務是否啟用（已啟用／未啟用）
狀態	商戶帳號是否啟用（已啟用／未啟用）
IP 白名單	點擊查看/管理該商戶的 IP 白名單
操作	編輯、刪除按鈕

代收方式快速開關（站點限定）

部分站點的「代收設定」欄位左側會有開關，可直接開關該商戶的超商代碼、ATM、信用卡代收，不必進入編輯視窗、也不用另外按儲存，切換後立即生效：

• 超商的 7-11 與全家共用同一個開關（兩者在設定上屬於同一個「超商代碼」代收方式）
• 已關閉的那一組通道資訊會整組淡化顯示，一眼看得出哪些方式停用中
• 效果與在編輯視窗的支付通道設定裡開關該方式完全相同；若該方式先前是因為達到當日收款上限被系統自動關閉，用開關重新開啟後即恢復收單
• 需要商戶編輯權限才會顯示，唯讀帳號看不到開關
• 送出失敗時開關會自動彈回原本的狀態，並顯示錯誤訊息

其他站點沒有這排開關，仍是進入編輯視窗調整。

代付快速開關（站點限定）

「代付設定」欄位也有同樣的快速開關，位置在原本那顆「代付開啟／代付關閉」徽章的所在處 ——開關本身就是狀態顯示，所以有開關的站點不再另外顯示徽章。

• 關閉時底下的服務費、手續費、每日上限、保留款會整組淡化，一眼看得出這個商戶不出款
• 只有從未設定過代付的商戶才會維持原樣（那是「沒設定」而不是「已關閉」）
• 需要商戶編輯權限才會顯示；沒有編輯權限時該格顯示唯讀徽章，仍看得出開關狀態
• 代收與代付的快速開關是兩個獨立的站點功能，只開其中一個的站點只會看到那一組

這個開關與代收的快速開關互相獨立，切換後立即生效、送出失敗會自動彈回。

懸停的通道清單只列「現在在收」的

「代收設定」欄位滑鼠懸停展開的通道清單，只列出該商戶目前啟用中的通道。

在多數站點，把一張卡從商戶設定裡移除的做法就是把那組配置停用，所以停用的配置 其實是這個商戶歷來換過的每一張卡 —— 全部列出來會是一整片，真正在收的那幾張反而被淹掉。 清單標題的張數與底下的行數現在一定一致。

代收開關歷程

站點限定

只有啟用此功能的站點，「代收設定」欄位標題旁才會出現歷程按鈕；其他站點沒有這顆按鈕。

點「代收設定」標題旁的歷程圖示，可查誰在什麼時候把哪個商戶的超商／ATM／信用卡開關 開起來或關掉，內容包含商戶、被改的付款方式、前後狀態（例如「超商 開啟 → 關閉」）、 操作人、時間與來源 IP。

• 按鈕放在欄位標題旁而不是每一列 —— 歷程本來就是跨商戶一起看的
• 彈窗內可依商戶篩選並翻頁；每次重新開啟都會回到「全部商戶」的第一頁
• 這項功能不新增任何紀錄，它讀的是本來就在寫的操作歷程，所以一開就查得到全部歷史
• 載入失敗時只會顯示空清單，不會擋住商戶管理本身

進度條顏色

「當日收款上限」與「代收設定」欄位的進度條採用相同的顏色規則：使用率 未達 70% 顯示綠色、70%～89% 顯示黃色、90% 以上 顯示紅色，可一眼看出哪些商戶或通道即將收滿。

兩處都採「進度條在上、數字在下」的直式排列：進度條起點固定對齊，不會因供應商名稱長短而左右浮動，上下列的數字也採等寬字型（tabular-nums）方便直向掃視。

新增商戶

1. 點擊 「新增商戶」 按鈕，開啟設定表單

基本資訊

欄位	必填	說明
商戶名稱	是	商戶的顯示名稱
商戶代碼	自動	系統自動產生 6 位英數字代碼（避免混淆字元如 0/O/1/I），可點擊重新產生

串接配置

欄位	說明
API 服務	啟用/停用商戶的 API 存取權限
機器人回調	啟用/停用機器人回調功能
API Secret	建立後產生的 API 金鑰，可查看、複製

支付通道設定

系統支援三種支付方式，每種獨立設定：

超商代碼（CVS）

欄位	說明
啟用	開關此支付方式
當日收款上限	緊接在開關下方，設定該支付方式每日的收款金額上限。留空表示不限額。設定後下方顯示今日已收金額／上限的使用進度條
交易手續費	每筆交易的固定手續費（元）
撥款費率	撥款時扣除的百分比費率
驗證功能	開啟後系統會比對預約通路與實際付款通路
繳費期限	1~30 天，超過期限未繳則訂單過期
撥款日設定	透過 SettlementPicker 選擇，例如 T+2 表示付款後 2 個工作天撥款
代收區間設定	（站點限定） 卡片最下方，設定此支付方式可開單的時段，未設定＝不限時段（24 小時皆可開單，詳見 代收區間設定）

供應商通道插槽（7-ELEVEN / 全家獨立配置）：

超商代碼的供應商通道分為 7-ELEVEN 和 全家 兩組獨立配置。每組可各自設定不同的供應商、優先順序、限額與重置時間。這是因為不同金流供應商支援的超商通路不同：

• OMG：支援 7-ELEVEN + 全家
• 客樂得（CATPAY）：僅支援 7-ELEVEN

供應商下拉選單會根據子通路自動過濾，僅顯示支援該超商的供應商。

每組通道的運作方式相同，可配置多個供應商按優先順序排列：

• 第一個插槽：最高優先順序，訂單優先分配至此供應商
• 後續插槽：當上一個插槽達到限額後，訂單自動溢流至下一個供應商
• 最後一個插槽：固定為無限制模式，承接所有溢流訂單

插槽順序用左側的 拖曳把手 調整，按下「儲存」後才會寫入。

（站點限定）通道篩選：四組通道（7-ELEVEN／全家／ATM／信用卡）的標題列右側各有一個篩選框。輸入供應商名稱或代碼即可只留下符合的通道卡片（空白分隔可下多個條件，需全部命中），旁邊顯示「顯示數／總數」。適合一個支付方式配了十幾二十張卡、要改其中一張的情況。

（站點限定）狀態篩選：同一組通道的標題列 下方 另有一行分段按鈕，每一段會標出該狀態目前有幾張卡。可與上面的關鍵字篩選疊加使用 —— 兩個條件都命中才會顯示。

分段	包含哪些通道
全部	不篩狀態，該組的全部通道
啟用	通道卡片的啟用開關為「開」
停用	通道卡片的啟用開關為「關」
滿額	已達累積限額、目前不再分配訂單的通道

適合用在「這組配了二十張卡，想快速看哪幾張已經收滿」這類情況。

篩選只影響畫面，不影響儲存

關鍵字與狀態兩種篩選 都不會 把沒顯示的通道刪掉或停用 —— 按下「儲存」時送出的仍是該組的全部通道。

篩選期間該組的 拖曳排序、新增通道、批次帶入會暫停（畫面上少了幾張卡，排序與批次套用的範圍容易被誤判），按鈕列會換成「篩選中」提示與清除入口。要排序或新增請先清除篩選（也可以按 Esc）。

分配模式（每組通道底部，兩個以上通道才可選）：

模式	說明
滿額輪替	依插槽順序，第一個沒滿就一直用它，滿了才溢流到下一個。拖曳順序＝實際的優先順序
均攤輪替	把該組通道當成一個池，每筆訂單挑目前累積金額最低、且還有額度的通道。拖曳順序只影響畫面排列，不影響實際分配

（站點限定）均攤輪替自動排序：切換到「均攤輪替」時，系統會把該組 已收滿（金額或筆數達上限）的通道自動排到下面、還在收的浮上來，通道多的時候不必一張張找。未收滿與已收滿兩群各自維持原本的相對順序，手動拖出來的排列不會被打散。

只在兩個時機自動排一次：切換到均攤輪替的當下、以及開啟編輯視窗載入通道的當下（載入時就已排好，畫面不會先跳出舊順序再重排）。之後不再自動介入，仍可自由拖曳調整。滿額輪替不會自動排序 —— 那邊的順序就是實際的優先順序，自動重排等於偷改分配結果。

每個插槽的設定：

欄位	說明
供應商	從支援該超商通路的供應商列表中選取（同一組中不可重複選取）
限額模式	無限制 或 自訂金額（設定累積上限）
筆數限制	可選設定每日收款筆數上限，達到後該插槽不再接單（站點限定）
最小／最大開單金額	單筆訂單的金額範圍，超出範圍直接拒單（站點限定）。留空或 0 = 不限制
累積金額	顯示目前已累積的金額與進度條

開單金額範圍怎麼判斷

系統選通道時就會把收不了這筆金額的通道排除，只在收得了的通道之中，再依該組的分配模式（滿額／均攤／隨機輪替）挑一張。通道沒設定金額範圍時，該筆只受超商／ATM／信用卡大項的最小最大開單金額限制。

因此可以用「分段配置」讓各種金額都收得到，例如：多張設 5001 ~ 30000，另外配一張 30001 ~ 9999999 專收大額 —— 大額訂單會自動走到後者。

若所有通道都收不了該金額，才回報「交易金額超出範圍」。這時不會動到任何通道的累積額度。

分段配置要留意兩件事

• 重疊區間會被一起消耗：若專收大額那張設成 20000 ~ 9999999，而其他張是 5001 ~ 30000，則 20001~30000 這段兩邊都收得了，大額卡會被這段訂單分掉。想讓它專心守大額，下限就要設在其他張的上限之上（例如 30001 起）。
• 它仍然受累積上限約束：專收大額的通道若設了累積金額上限，收滿之後大額就沒有通道可用了。要嘛不設上限、要嘛多配幾張。

換句話說，系統會盡力把每筆金額送到收得了的通道，但不會變出額度 —— 每個金額級距都要有足夠的通道承接。

累積上限怎麼判斷（站點限定）

一般情況下，只要「已累積金額 小於 上限」這張卡就還接得下單，不看這一筆多少錢 —— 所以一張上限 20,000、已累積 19,999 的卡，仍然接得下一筆 200,000，收完變成 219,999， 要下一筆才會被排除。上限實際扮演的是「什麼時候換下一張卡」的觸發點。

部分站點改為事前試算：判斷的是「已累積 ＋ 這一筆 是否仍在上限內」， 放不下就直接往下一張還放得下的卡走，上限成為真正的天花板。

啟用這個模式後，若整組通道都放不下這一筆（但額度其實還沒用完），建單會被拒絕並回報 「金額超出可用額度」——這與「所有通道都已收滿」是不同的情形，不會觸發輪替重置， 該組通道原本累積的數字也不會被歸零。

批次帶入（站點限定）：一組通道常常要設成同一套上限，一張一張填很費事。每組通道的按鈕列有一顆「批次帶入」，點開後填一次就補到該組所有已選擇通道的插槽 —— 只補還沒設定的欄位，已經填過的值不會被蓋掉：

可帶入的欄位	備註
累積金額上限	一律提供
筆數上限	該站點有開筆數限制才會出現
最小／最大開單金額	該站點有開開單金額範圍才會出現

幾個要知道的行為：

• 只補空白欄位：通道上已經有值的欄位一律保留，批次帶入不會覆蓋。要改既有的值請直接改那張卡片
• 逐欄判斷，不是逐張：同一張卡可以「累積金額上限保留原值、筆數上限被補上」
• 留空的欄位不帶入 —— 只想補筆數就只填筆數，其他欄位完全不碰
• 每張卡的欄位空白（或 0）都代表「不限制」＝尚未設定，會被補上
• 全組通道的欄位都已有設定時會提示「沒有可帶入的欄位」，不會有任何變動
• 只套用到已選好供應商的插槽，還沒選通道的空插槽不動
• 只影響同一組（7-11／全家／ATM／信用卡各自獨立），不跨付款方式
• 只改畫面上的值，仍要按「儲存」才寫入 —— 誤觸直接關掉編輯視窗即可

建立訂單時，系統根據 cvsChannel 參數自動路由到對應的通道組：

• SEVEN → 使用 7-ELEVEN 通道配置
• FAMILY → 使用全家通道配置

若未帶 cvsChannel，系統會取 cvsReservations[0].channel 作為路由依據。

重置模式：控制累積金額的重置方式，僅有兩種模式

模式	說明
不重置	累積金額持續累加，不自動重置
每日 00:00 重置	每日凌晨 00:00 自動歸零累積金額

什麼情況會重新起算：儲存商戶時，只有下列兩種編輯會把該通道的已收金額與筆數歸零

操作	為什麼要重算
變更重置模式	改的是累積的時間週期本身，等同開新的一輪
停用後重新啟用	該通道重新上線，停用期間本來也不會累積

調整上限不會重新起算

修改「累積金額上限」或「筆數上限」不會歸零已收金額與筆數 —— 上限就是上限，改大改小都直接套用在既有的累積上。

因此若把上限調到比目前已收金額還低（例如已收 60,000 卻把上限改成 50,000）， 儲存後該通道會立刻被視為收滿、不再被路由選中，要等重置或輪替才會恢復。

通道溢流機制

假設商戶的 7-ELEVEN 配置了兩個供應商：

• 插槽 1：供應商 A，限額 50,000 元，每日 00:00 重置
• 插槽 2：供應商 B，無限制

當供應商 A 當日累積金額達到 50,000 元後，新訂單自動路由到供應商 B。隔日凌晨 00:00 累積金額歸零，供應商 A 重新啟用。當所有通道都達到限額時，系統暫停接單，等待隔日 00:00 重置。

自動輪替（autoRecycle）模式的通道會在商戶列表中顯示當前的 輪替回合數 標籤，方便掌握輪替狀態。

自動開關服務

當某個支付方式的所有通道（所有子通路的所有供應商）都達到限額時，系統會自動關閉該支付方式。當任一通道額度恢復後，系統會自動重新啟用該支付方式。相關事件會記錄在通道切換歷程。

超商自動下撥（站點限定功能）：

欄位	說明
超商自動下撥	開關，啟用後該商戶的超商訂單在繳費完成時自動觸發下撥，結算至商戶雲帳戶

TIP

此開關僅在部分站點顯示，與超商服務通道並排於同一列（供應商標題列右側）。需先啟用超商支付方式才可操作。預設為 關閉，既有商戶維持原本從超商代碼下撥頁人工下撥的流程，需逐一開啟才會生效。

開啟後的影響

• 該商戶的超商訂單不會再出現在超商代碼下撥頁的待下撥清單，撥款天數設定對這些訂單不再有作用。
• 訂單付款後直接變為「已下撥」，因此無法再標記退款（退款僅限「已付款」狀態的訂單）。

ATM 虛擬帳號

設定項目與超商代碼的單一通道組相同（無子通路拆分），差異在於使用不同的供應商選項和費率欄位。

卡對卡通道的所屬商戶（站點限定）：卡對卡的每張「卡」對應一個實體銀行帳號，入帳靠爬蟲比對金額與帳號，所以一張卡同一時間只能給一個商戶用。同一張卡掛在兩個商戶底下的話，兩邊的訂單會搶同一個帳號的入帳紀錄。

通道下拉裡已經有人在用的卡，第二行會標出目前的持有商戶。要把卡換到目前編輯的商戶名下，直接選它就好，系統會跳出確認視窗：

情況	行為
原商戶在這張卡上還有未完成訂單	不能轉，視窗會列出是哪幾筆，請先處理完
轉走後原商戶在該付款方式底下沒有其他可用通道	可以轉，但視窗會紅字提醒那個商戶會停止收款
其他情況	確認後立即生效

未完成訂單為什麼一定要先處理

卡對卡的入帳比對只看「哪張卡、多少錢、對方帳號」，不看是哪個商戶的訂單。兩個商戶同時在同一張卡上有未完成訂單時，一筆入帳會落到建立時間較新的那一筆上 —— 錢可能記到錯的商戶頭上。這是系統擋下轉移的唯一理由，也是不能繞過的。

轉移獨立於「儲存」

按下確認就立刻生效，不需要也不會等你按下方的「儲存」。反過來說，按取消關掉編輯視窗也救不回來 —— 要換回去請再轉一次。

轉移後新商戶的這張通道從乾淨狀態開始（不限額、累積歸零），原商戶已收的款項與錢包餘額完全不受影響；爬蟲設定綁的是卡本身，也不用跟著改。

這個動作需要單獨的「卡對卡通道轉移」權限 —— 能編輯自己手上的商戶，不等於能動別的商戶的通道配置。兩邊的通道切換歷程都會留下紀錄。

卡對卡自動下撥（站點限定功能）：

欄位	說明
卡對卡自動下撥	開關，啟用後 CTCPAY 卡對卡訂單在繳費完成時自動觸發下撥結算至商戶雲帳戶

TIP

此開關僅在啟用 CTCPAY 卡對卡功能的站點顯示，與 ATM 服務通道並排於同一列。需先啟用 ATM 支付方式才可操作此開關。

信用卡

設定項目與超商代碼的單一通道組相同（無子通路拆分），差異在於使用不同的供應商選項和費率欄位。

當日收款上限

超商代碼、ATM、信用卡三種支付方式可各自設定「當日收款上限」，用於控制單一商戶每日透過該方式的收款總額。

項目	說明
設定位置	各支付方式卡片內，開關的正下方
預設值	留空（不限額），既有商戶不受影響
使用進度條	顯示「今日已收 / 上限」與百分比，未達 80% 綠色、80% 以上橘色、100% 紅色

達標自動關閉：當該支付方式當日累計收款金額達到上限時，系統會 自動關閉該支付方式，商戶無法再以此方式建立訂單。系統會記錄自動關閉的標記，並由排程於 每日 00:00（台灣時間）自動重新啟用。

適用範圍

達標判斷涵蓋所有付款成功的途徑，包含供應商真實回調與後台人工補登（CVS / ATM / 信用卡）。當日累計金額以台灣時間的付款時間（paidAt）計算，凌晨 00:00～08:00 的訂單亦正確納入當日統計。

代收區間設定

（站點限定） 超商代碼、ATM、信用卡三種支付方式可各自設定「哪些時段可以開單」，讓商戶只在指定時段內收單。

項目	說明
設定位置	各支付方式卡片的最下方（服務通道區塊底下）
預設值	未新增任何時段（標題旁顯示「未設定＝不限時段」）＝24 小時皆可開單，既有商戶不受影響
時段單位	精確到分（例如 09:30 ~ 17:45），起訖各一個時間輸入框；同一個支付方式可新增多個時段

一旦新增了時段，就 只有落在這些時段內才能建立訂單；時段外開單會被拒絕，商戶端收到「該付款方式目前非開放時段」。

時段的寫法

• 結束時間不含該分鐘：09:00 ~ 18:00 代表 09:00–17:59 可開單，18:00 之後就不收了； 09:30 ~ 17:45 代表 09:30–17:44
• 開始大於結束＝跨日：22:30 ~ 02:00 代表 22:30–01:59
• 要收到午夜請把結束設成 00:00：09:00 ~ 00:00 代表 09:00–23:59
• 開始與結束不可相同：09:00 ~ 09:00 同時可以讀成「整天開放」與「只開這一瞬間」， 語意含糊，儲存時會被擋下。但 09:00 ~ 09:30 是可以的 —— 起訖小時相同、分鐘不同就是一段有效的區間
• 多個時段取聯集，沒被涵蓋到的時間就是不收單（設 09:00 ~ 12:00 與 14:00 ~ 18:00，則 12:00–13:59 不收單）
• 時間一律以台灣時間判斷

原本只能設到整點

這個設定過去只能選整點，既有商戶設定的時段都是整點。改成精確到分之後， 那些設定的意義完全不變（9:00 ~ 18:00 仍是 09:00–17:59），不需要重新設定。

與付款方式開關、當日收款上限的關係

三者各自獨立生效：付款方式的開關關閉時，不論時段設定為何都不收單；當日收款上限達標會自動關閉該付款方式；代收區間只管「現在這個時間能不能開單」。

代收區間不影響 已建立訂單 的繳費 —— 時段外，先前建立且未過期的訂單仍可正常繳納。

手動重開

若管理員或商戶在達標後手動將該支付方式重新開啟，系統會清除自動關閉標記，隔日 00:00 的排程不會重複處理。

開啟編輯視窗時的即時校正

開啟商戶編輯彈窗時，系統會一次取得通道設定、當日用量與支付方式的即時開關狀態，因此若某方式已因達標被自動關閉，開關會直接反映關閉狀態。

商戶列表頁的「當日收款上限」欄位也會同步顯示各方式的今日用量進度條，並可搭配 TG 機器人的「當日收款上限達標」通知即時掌握。

轉帳設定

欄位	說明
代付功能	啟用/停用該商戶的代付功能（站點限定，特定站點可獨立控制每個商戶的代付開關）
轉帳服務費率	代付時的服務費百分比
轉帳手續費	代付時的固定手續費（元）
雲帳戶日限額	該商戶每日可代付的最高金額上限

代付時段金額區間

站點限定功能，啟用後可為每個商戶設定不同時段的代付金額限制。

欄位	說明
時段	起始時間 ~ 結束時間，精確到分（例如 09:30 ~ 17:45）；規則與代收區間設定相同：結束不含該分鐘、開始大於結束為跨日
最小金額	該時段允許的最小代付金額
最大金額	該時段允許的最大代付金額

可新增多組時段規則，每組獨立設定。標題旁固定顯示 「未設定＝不限時段與金額；有設定＝僅這些時段可代付」：

起訖相同的舊設定會被標成警告

早期新增時段的預設值是 00:00 ~ 00:00，那種起訖相同的區間永遠不會匹配到任何時刻， 等於那一段的金額限制形同沒設定，但畫面上看不出來。

現在編輯畫面會把這種區間標成警告，但不會擋住儲存 —— 擋住的話那些商戶連改手續費 都存不了。看到警告時請自行決定要把它改成正確的區間，還是整段刪掉。 （系統判斷時會忽略所有不合法的區間；若一個商戶的區間全部不合法，等同「沒設定」而不限時段。）

• 沒有新增任何時段：完全不做限制，任何時間、任何金額都送得出去。
• 有設定：商戶送出代付申請的時間必須落在其中一個時段內，否則直接拒絕；落在某個時段內時，金額還必須符合該時段的最小／最大值。

TIP

此設定區塊僅在特定站點顯示。商戶在代付申請頁面會看到當前可用的時段與金額範圍提示；不在任何時段內時，會改成紅字提示現在無法申請並列出可申請的時段。

只設一段，等於其餘時間全部關閉

時段是開關，不是只有金額限制。只設定一段 10:00 ~ 22:00，代表 22:00 ~ 隔天 10:00 完全不能申請代付。 若要整天都能申請、只是不同時段給不同金額上限，必須把 24 小時用多段鋪滿，並注意 段與段之間不要留空隙 （例如 22:00 ~ 23:40 與 00:00 ~ 10:00 之間的 23:40 ~ 00:00 就是關閉的）。

與「代收區間設定」的關係

兩者的時段語意相同（沒落在任何時段就不能送出），差別只在 代付的每一段還帶金額上下限： 落在時段內時，金額還要符合該段的最小／最大值。

黑名單阻擋開單

商戶可啟用黑名單阻擋功能，當訂單建立時比對到黑名單，系統會直接 拒絕建立訂單（而非僅標記警示）。

欄位	說明
啟用	開啟/關閉黑名單阻擋功能。開關旁的 ❓ 圖示點擊後可查看功能說明
比對欄位	可分別勾選：姓名、手機號碼、電子郵件。僅勾選的欄位會參與比對

WARNING

啟用阻擋功能後，命中黑名單的訂單將無法建立，API 會回傳錯誤碼 4320。與原本僅標記的行為不同，請確認商戶已知悉此變更。

啟用後台快速取號

控制該商戶的 商戶後台 能不能直接開單。適用於只該走系統串接、不希望人工在後台手動建立訂單的商戶。

欄位	說明
啟用後台快速取號	預設開啟。關閉後，該商戶的後台側邊選單不再顯示「快速取號」，直接輸入網址也會被導回商戶首頁

TIP

此開關僅在特定站點顯示。未顯示此開關的站點，所有商戶的後台一律看得到快速取號。

WARNING

關閉後 不影響 API 串接取號，該商戶仍可透過 POST /api/payment/create 正常建立訂單，已建立的訂單也不受影響。若商戶的後台仍送出快速取號請求（例如關閉前就開著頁面），API 會回傳錯誤碼 4331。

保留款

欄位	說明
保留款金額	設定該商戶的保留款金額。保留款會從雲帳戶餘額中扣除，計算可用餘額時使用：可用餘額 = 餘額 − 保留款

假資料管理

假資料功能用於替換訂單中的買家個人資訊（姓名、手機、信箱、地址），保護商戶客戶隱私。

商戶端設定（商戶編輯彈窗）

欄位	說明
啟用假資料替換	開啟/關閉該商戶的假資料替換功能。開關旁的 ❓ 圖示點擊後可查看功能說明
替換欄位	勾選要替換的欄位：姓名、手機、信箱、地址（地址為站點限定）

假資料集管理（管理假資料彈窗）

點擊商戶列表頁右上角的 「管理假資料」 按鈕開啟，不需先選擇商戶。

頂部操作按鈕：

按鈕	說明
重新計算	依實際訂單重新統計每筆假資料的使用次數（地址類型無對應訂單欄位，不列入計算）
從主站同步	從站限定，一鍵從主站同步假資料集。同步完成後顯示差異摘要（總數／新增／移除）
匯出	將目前的假資料集匯出為 CSV
批量匯入	一次貼上多筆假資料建立
新增	新增單筆假資料

篩選列：類型下拉、商戶下拉（站點限定）、關鍵字搜尋。

表格欄位：

欄位	說明
類型	假資料類型 Badge：姓名 / 手機 / 信箱 / 地址
值	假資料內容（等寬字型）
商戶	站點限定。行內下拉選單，可直接切換該筆假資料要綁定的商戶。表頭 ❓ 圖示說明「共用」與「綁定商戶」的差異
使用次數	該筆假資料已被使用的次數
操作	編輯、刪除

假資料綁定商戶（站點限定）

站點啟用後，每筆假資料可設定為 共用（不綁定，所有商戶皆可取用）或 綁定指定商戶（僅該商戶的訂單會取用）。

綁定時系統會自動連動商戶設定：

1. 若該商戶尚未啟用假資料替換，會提示確認後 自動啟用
2. 同時將該假資料的類型（例如地址）自動加入 該商戶的替換欄位勾選
3. 完成後自動刷新商戶列表，設定即時生效

解除綁定時，系統會檢查該商戶是否還有同類型的假資料；若已無任何綁定，會彈窗詢問是否 一併關閉 該商戶對應的替換欄位。

三個入口皆有連動

行內下拉切換、新增／編輯儲存、批量匯入三種操作都會執行上述連動檢查，切換過程中會顯示 loading 狀態，避免重複點擊。

地址類型（站點限定）

假資料新增了 地址 類型，供 CatPay 通道取號時自動替換付款人地址（payer_address）。若商戶未設定地址假資料，系統會使用預設值 Taiwan。

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

刪除商戶會同時移除該商戶所有相關資料，此操作不可復原。