通道列表

路徑：/admin/payment/channels  |  快捷鍵：2 → /  |  選單位置：系統管理 → 通道列表

站點限定

此功能僅在特定站點啟用，需與管理員接洽啟用。

部分站點只看得到「檢視版」的通道列表：頁面、篩選、收款統計與排序完全一樣， 但表格少掉「所屬商戶」「啟用狀態」「參考餘額」三欄，也沒有「商戶」篩選 —— 那三欄屬於卡片的管理設定，這些站點不從這一頁管卡片的配置與啟閉。 「顯示欄位」裡同樣不會列出那三個選項。

通道列表提供所有金流供應商（Payment Vendor）的集中管理介面，可查看每個通道的即時收款統計、所屬商戶配置、參考餘額，並支援啟用/停用切換與 CRUD 操作。

篩選條件

篩選項目	說明
編號	開關打開就只列出有編號的通道；再輸入內容可對編號做模糊比對（只記得後三碼也找得到）
支援方式	全部方式 / 超商代碼 / ATM 轉帳 / 信用卡
通道類型	全部類型 / 各供應商類型
狀態	全部狀態 / 啟用 / 停用
搜尋	依通道名稱或代碼搜尋

編號的開關切下去就立刻生效，不必再按「查詢」——它本身就是一個完整的篩選條件。 編號的輸入框則要按 Enter 或「查詢」才套用（邊打字邊篩會讓列表一直跳動）。

篩選列右側顯示四組 啟用率統計（通道總計、ATM 轉帳、超商代碼、信用卡），每組顯示啟用率百分比與「啟用 N／停用 N」的數量。

畫面上的數字最後一次更新的時刻標在「查詢」按鈕正上方（顯示為「更新於 11:34:38」）—— 想確認畫面是不是最新的時候，看的就是準備要按重整的那個位置。

表格欄位

欄位	說明
#	序號
編號	卡片編號（取自通道名稱開頭「編號-」的那組數字）；沒有編號的顯示 - 並以淡色區隔
通道名稱	通道名稱（粗體）+ 代碼（灰色小字）
通道類型	類型標籤（歐買尬、客樂得、卡對卡、測試通道等，皆已中文化）
支援方式	該通道支援的支付方式標籤（可多個）。支援超商代碼時，該卡開通的超商通路（7-ELEVEN / 全家）會以組織圖式的連接線掛在「超商代碼」底下 —— 通路不再是獨立一欄
所屬商戶	使用該通道的商戶列表，子欄位為「通路 / 額度 · 筆數 / 單筆限額」
狀態	啟用/停用開關（Switch）
累積收款	通道歷史累積收款金額（翠綠色）
昨日收款	昨日收款金額
今日收款	今日收款金額（紅色，與左邊累積收款的綠色對照 —— 這是每天最常盯的一欄）
最近收款	最後一筆收款的金額與時間
代付筆數	這張卡出過幾筆代付（站點限定，見下方代付累積統計）
代付金額	這張卡出過多少代付金額（站點限定，同上）
參考餘額	可編輯的參考餘額欄位（鎖定/解鎖切換）。預設收起，要看請到「顯示欄位」勾回來
操作	編輯、刪除按鈕

通道名稱是連結，點下去會直接跳到該卡的訂單查詢頁並自動把「服務通道」篩選設成這張卡， 不必再去下拉裡找同一張 —— 詳見下方點通道名稱看訂單。

「啟用狀態」欄的表頭分成上下兩排：上排是全選勾選框與欄位標題，下排是「全部啟用／全部停用」 的批次按鈕，勾選要處理的列之後按下去即可整批切換。

表格上方右側的 「顯示欄位」 可自選要顯示哪幾欄（用法見系統後台概覽）。

表頭排序

點擊表頭可排序，每一欄都是三段循環：降冪 → 升冪 → 取消（取消後回到原本的順序）。

可排序的欄	說明
編號	依數值大小排（不是文字排，所以 9 會排在 87963 前面）；沒有編號的一律沉底
通道名稱 / 通道類型	文字排序
累積收款 / 昨日收款 / 今日收款 / 最近收款	金額排序
額度 / 筆數 / 單筆限額	見下方「所屬商戶欄位詳情」

同一時間只會有一組排序生效，換一欄排序時前一欄自動取消 —— 否則看不出目前是依哪一欄排的。

收款欄位的順序

四個收款欄位預設依時間跨度由大到小排：累積收款 → 昨日收款 → 今日收款 → 最近收款。

近期優先（站點限定）

部分站點改為 今日收款 → 最近收款 → 昨日收款 → 累積收款 —— 實際盯盤最常看的是今日與最近這一筆，把它們放到最左邊就不必每次把視線跨過另外兩欄。 兩種順序都只是欄位位置不同，數字、配色與計算方式完全一樣。

代付累積統計

站點限定

只有啟用此功能的站點才會出現「代付筆數」與「代付金額」兩欄。

這兩欄回答的是「這張卡出了多少代付」，每一格分兩行：

今日 1 筆          今日 $130,000     ← 粗體，每天都在變的數字
累積 5 筆          累積 $300,000     ← 小灰字，背景資訊

• 兩行都帶標籤（今日／累積），因為兩個數字長得一模一樣，少了標籤就分不出哪行是哪個
• 從沒出過款的卡顯示 - 而不是 0，兩者意思不同
• 只算已完成（審核通過）的代付單；今日以實際出款時間認定

資料來源是每張代付單上記錄的「用哪張卡出的」： 自動代付在派工時就記下指派的卡片、回報成功時以實際出款的那張為準； 人工審核則由操作員在代付審核頁指定。 這個欄位加入之前的舊單沒有這項紀錄，不列入統計。

點通道名稱看訂單

點表格上的通道名稱會直接跳到該卡的訂單查詢頁，並自動把「服務通道」篩選設成這張卡。

依這張卡支援的付款方式決定跳到哪一頁（多種方式時依此優先序）： 超商 → 超商訂單、ATM → ATM 訂單、信用卡 → 信用卡訂單。

沒有支援的付款方式、或你沒有那一頁的查看權限時，通道名稱維持純文字不可點 —— 點了會被權限擋掉的連結比沒有連結更容易讓人誤以為系統壞了。

所屬商戶欄位詳情

所屬商戶欄位以巢狀結構顯示每個使用此通道的商戶：

• 商戶名稱：使用該通道的商戶
• 子通路：如 7-ELEVEN、全家、ATM 等
• 額度：已累積金額/限額，未設限時顯示 ∞，並依使用率以綠/黃/紅色標示
• 筆數：已用筆數/筆數限額，未設限時同樣顯示 ∞
• 單筆限額：該商戶配置的單筆最小～最大金額

額度、筆數、單筆限額三欄各自可排序（同樣是降冪 → 升冪 → 取消）。 一個商戶在同一張卡上可能有多筆通道（例如同時配了超商與 ATM）， 排序時是把該商戶在這張卡上的所有通道加總後再比大小，不是只看第一筆。

僅顯示啟用中的配置

所屬商戶欄位僅顯示 啟用中 的通道配置，已停用的配置不會出現在列表中 （但仍佔著位置，見下方「配置商戶」）。

行內編輯

站點限定

以下三個操作僅在有啟用通道列表的站點提供。

不必進商戶資料管理，直接在所屬商戶欄位上就能調整配置：

操作	位置	說明
調整限額	每筆通道右側的鉛筆圖示	修改該商戶在這張卡上的單筆最小／最大金額
移除配置	商戶名稱旁的叉叉圖示	把這張卡從該商戶身上移除
配置商戶	欄位底部的「配置商戶」按鈕	把這張卡配給新的商戶

調整限額的表單只會填入「這個通道自己設定過」的值。畫面上看到的限額有可能是 繼承自商戶大項（超商／ATM／信用卡）的設定，那種值會以灰字放在輸入框的提示位置 （例如「1,000（繼承自商戶）」），留空即維持繼承。把提示的數字手動打進去存檔， 等於把商戶層的值固化成這個通道的專屬設定，日後改商戶設定這個通道就不會再跟著變。

配置商戶時如果選到「以前配置過、後來停用」的組合，系統會提示將重新啟用 而不是無聲地把它打開 —— 停用的配置在畫面上看不到，但仍然佔著位置。

帶出上次的限額（站點限定）

站點限定

部分站點在「配置商戶」選好付款方式時，會自動把這張卡上次設定過的單筆上下限、 累積額度與筆數上限帶進四個欄位，並標出那組設定是哪一天存的。

實體收款卡經常在商戶之間換手，限額多半是那張卡自己的銀行／風控上限，換商戶不會變， 每次重打一遍既費時又容易打錯。

• 記憶是逐卡、逐付款方式（超商還會再分門市通路）分開存的， 沒記過的付款方式就是四格全空，不會拿另一組的值來湊
• 提示會帶上日期並要求你確認 —— 卡的限額會因為銀行調整而變，記憶沒有時效， 日期才是判斷依據
• 留空仍然代表「繼承商戶設定」或「不限制」，帶出來的值也可以直接改掉
• 配置商戶、行內編輯限額、商戶編輯彈窗、卡對卡轉移，只要改過限額都會更新記憶

卡對卡通道選到別的商戶已持有的卡時，會走轉移確認流程（該卡若還有未完成的訂單會先擋下）， 與商戶資料管理裡的轉移是同一套規則。

僅限代付的卡不能配置商戶

標示為 僅限代付 的卡只出款、不收款，所屬商戶欄位不會出現「配置商戶」按鈕（該欄顯示「-」）。

這不是限制而是避免白做工：這種卡本來就不會被收款流程選中，配下去的通道一筆訂單都收不到， 但畫面上看起來是設定好的 —— 商戶編輯彈窗的服務通道下拉同樣不會列出這些卡。

如果某張卡是先配置給商戶、之後才改成僅限代付，原本的配置仍然看得到， 而且鉛筆（調整限額）與叉叉（移除配置）都還能用，方便把殘留的配置清乾淨。 要重新讓這張卡收款，把它的「僅限代付」關掉即可。

收款進來時自動更新

有收款進來時，該通道的額度與筆數會自動更新，不需要重新整理頁面。

只有真的變動的那幾列會重畫，其餘維持原狀，所以捲動位置、展開狀態與篩選都不會被打斷。 分頁切到背景、正在載入、或有任何彈窗開著時會先跳過，不在你操作到一半時換掉畫面上的數字。

與訂單列表對照時

訂單查詢頁有自己的自動刷新，兩邊的更新時機不同，短時間內看到的數字可能有幾秒的落差， 稍等一下就會一致。

參考餘額

參考餘額用於記錄通道供應商的帳戶餘額參考值，方便管理員掌握各通道的資金狀態：

• 鎖定狀態：顯示餘額數值 + 鎖定圖示，點擊鎖定圖示可切換為編輯模式
• 編輯狀態：顯示輸入框 + 解鎖圖示，按 Enter 或失去焦點自動儲存

新增通道

點擊 「新增通道」 按鈕開啟表單：

欄位	必填	說明
通道名稱	是	通道的顯示名稱
通道代碼	是	唯一識別代碼
通道類型	是	下拉選取供應商類型
支援方式	是	多選：超商代碼 / ATM 轉帳 / 信用卡
超商通路	否	當選擇超商代碼時可指定：7-ELEVEN / 全家
API 基礎網址	否	可留空，待技術人員後續配置
啟用狀態	是	預設啟用

API 基礎網址改為選填

在有啟用通道列表的站點，新增通道時可先留空 API 基礎網址，系統會自動填入佔位網址 https://pending-setup.local，待技術人員取得供應商正式網址後再回來編輯即可。

注意：佔位網址無法實際串接，通道在完成配置前不應啟用收單。

網銀登入連結

編輯卡對卡（CTCPAY）類型通道時，系統會依銀行代碼自動帶入對應的網銀登入網址。 對照表涵蓋各家銀行與農漁會體系（含南農中心所屬的 512~526、612~627 等代碼）， 與爬蟲端實際會開啟的登入頁完全一致。

手動改過的網址不會被蓋掉：只有在新增卡片、或改動銀行代碼／通道類型時才會自動帶入， 重新打開編輯視窗不會把你填的網址覆寫回預設值。

通道排序

供應商在全站各處下拉選單（商戶通道設定、訂單查詢篩選、發票開立等）的顯示順序可自訂。

開啟方式：

• 本頁面（通道列表）的 「通道排序」 按鈕
• 未啟用通道列表功能的站點：於商戶資料管理頁面右上角開啟

操作方式：

1. 點擊「通道排序」開啟彈窗，列出所有供應商（顯示順序號、名稱、代碼、類型標籤）
2. 拖動左側把手調整順序
3. 點擊「儲存」寫回系統

排序生效範圍

儲存後，全站所有供應商下拉選單都會依此順序顯示。未設定排序的供應商排在最後，並沿用原本的品牌排序規則（OMGpay 優先、同品牌內測試通道優先、其餘按繁體中文排序）。

支援的通道類型

類型代碼	中文標籤
catpay	客樂得
omgpay	歐買尬
newebpay	藍新
ecpay	綠界
familynet	全網
familynet2	全網2
ctcpay	卡對卡
gc555	GC555
mock	測試通道

全網2（familynet2）

全網2 對應 全家代碼繳費 2.0 金流通道，屬超商代碼（CVS）類型，支援取號與繳費回調。新增通道時於「通道類型」選擇「全網2」即可。

GC555（gc555）

GC555 支援 超商代碼（CVS） 與 ATM 虛擬帳號 兩種收款方式。

超商：與其他超商通道用起來一樣 —— 建單就會拿到繳費代碼，收銀台直接顯示，商戶用 API 建單也拿得到 paymentNo。 （這個通道的供應商 API 本身只回付款頁網址，代碼是平台代為取回的，所以建單會比其他通道多約 1 秒。）

超商代碼只有 2 小時

這個通道的繳費代碼有效期是供應商定的 2 小時，遠短於一般通道。 平台會自動把訂單的繳費期限縮到這個時間 —— 即使商戶的付款方式設定是 1～3 天， 這個通道的訂單期限仍以供應商的 2 小時為準，避免付款人拿著早就失效的代碼去超商。

ATM 虛擬帳號：建單不會產生虛擬帳號，而是回傳供應商自己的付款頁網址； 付款人在收銀台填完資料後會被導向該頁面完成繳費。 建單當下就會向供應商確認開得出來 —— 開不出來的話訂單直接標成「失敗」並把供應商的原文 留在訂單上供客服查，不會給商戶一張永遠不會有付款資訊的待付款單。

極少數情況下（供應商頁面改版或暫時無法讀取）超商也會退回導轉付款頁的流程， 此時該筆訂單不會有繳費代碼，只會有付款頁連結 —— 這是刻意的保底，避免顯示一組錯的或空的代碼。

新增通道時的欄位對應：

欄位	填入內容
通道代碼	供應商的商戶後台登入帳號（不是 Merchant Token）
API 基礎網址	選擇通道類型後會自動帶入
憑證金鑰 1	Merchant Token
憑證金鑰 2	Merchant Key
憑證金鑰 3	ATM 建單用的預設身分證字號

憑證金鑰 3 之所以必填，是因為供應商規定 ATM 建單一定要帶身分證字號，而收銀台不會向付款人索取這項資料； 沒有填的話 ATM 訂單會被供應商退件，只有超商可以正常建單。

選用設定（額外設定 JSON）：

• cvsCodes：限制只能在指定的超商門市繳費（門市店號陣列）。不需要限制時請不要填—— 一旦設定，付款人在清單外的門市繳費不會入帳。
• defaultBuyerName / defaultBuyerPhone：付款人姓名或手機格式不符供應商規定時的替代值 （供應商規定姓名不可含數字、手機須為 09 開頭共 10 碼）。 :::

編輯通道

可修改通道的名稱、類型、支援的支付方式與超商通路等設定。

刪除通道

點擊刪除按鈕並確認後刪除通道。

DANGER

刪除通道前請確認該通道未被任何商戶使用中，否則會影響商戶的收款能力。

刪除是「從列表移除」，不是抹掉歷史

刪掉的通道會從列表、通道路由、統計與查帳中一併消失，畫面上的效果與過去一樣， 但那張卡的資料列仍保留著，它先前收的訂單不會跟著查不到 （例如幣商依統一編號查訂單，仍然找得到已刪除通道底下的單）。

同一組通道代碼被刪掉之後還可以再開回來：新增時填入已刪除的代碼，系統會把那一列復原， 不會擋你說「代碼已存在」。

啟用/停用切換

透過 Switch 開關可即時切換通道的啟用狀態：

• 停用：該通道將不再接受新訂單，但不影響已建立的訂單
• 啟用：恢復接受新訂單

收款統計

每個通道顯示三個維度的收款數據：

• 累積收款：通道建立以來的歷史總收款金額
• 昨日收款：昨日（00:00~23:59）的收款金額
• 今日收款：今日目前為止的收款金額

權限

權限代碼	說明
channels.read	查看通道列表頁面
merchants.update	新增、編輯、刪除通道、切換啟用狀態、通道排序