黑名單管理

路徑：/admin/system/blacklist  |  快捷鍵：2 → B

黑名單管理用於標記可疑的付款人資訊，防範惡意交易。系統會在訂單建立時自動比對黑名單資料，命中時會在訂單查詢頁面顯示橘色「黑名單」警示標籤。

預設情況下黑名單僅標記，不影響交易流程。若商戶啟用了黑名單阻擋開單功能，命中黑名單時將直接拒絕建立訂單。

自動比對機制

訂單建立時，系統會自動以付款人的 姓名、手機、信箱、身分證字號 比對黑名單：

• 命中時：訂單標記 blacklistHit，查詢頁面顯示橘色脈動「黑名單」badge
• 未命中時：不做任何標記，無影響
• 預設不阻擋：僅標記，不影響商戶回調流程
• 可啟用阻擋：商戶若在商戶管理中啟用阻擋功能，命中時將拒絕建立訂單
• 可同時存在：一筆訂單可能同時觸發「預約異常」（紅色）與「黑名單」（橘色）

在訂單查詢頁面（超商代碼/ATM/信用卡）展開訂單詳情，可查看命中的黑名單項目（欄位、值、備註）。

頁面說明

頁面分為兩區：

類型管理區

位於篩選列下方的可收合區塊（標題旁的數字 badge 顯示目前類型總數），展開後列出所有可用的黑名單類型標籤：

預設類型（紅色標籤，不可刪除）： 圈存、人頭戶、套利、惡意退款、威脅報警、三方詐騙、惡意通報、對沖對壓、多站台惡意註冊、友站提供、警示帳戶、團體投注

自訂類型（黃色標籤）： 在下方輸入框輸入名稱後按 Enter 或點 ＋ 即可新增，標籤上的 ✕ 可刪除。

自訂類型只存在這台瀏覽器

自訂類型儲存於瀏覽器本地（localStorage），不會同步到其他人或其他裝置。換電腦、換瀏覽器或清除瀏覽資料後就會消失，已套用在黑名單資料上的類型文字則不受影響。

黑名單列表

欄位	說明
#	列表序號
建立時間	紀錄建立的日期時間
付款人姓名	付款人姓名
付款人手機	手機號碼（可多筆，以 +N 顯示數量）
付款人郵件	電子信箱（可多筆，以 +N 顯示數量）
銀行資訊	銀行代碼-帳號（可多組）
身分證	身分證字號（可多筆，以 +N 顯示數量）
類型	標記的類型標籤
備註	文字備註（表格中截斷顯示，點擊可看完整內容）
啟用	啟用中（綠色）/ 已停用（灰色）

篩選條件

篩選項目	說明
付款人姓名	依付款人姓名搜尋
付款人手機	依手機號碼搜尋
付款人郵件	依電子信箱搜尋
銀行代碼	依銀行代碼搜尋
銀行帳號	依銀行帳號搜尋
身分證	依身分證字號搜尋
類型	下拉選取特定類型（全部類型 / 各類型）
啟用	全部狀態 / 啟用中 / 已停用

篩選列右側顯示 共 N 筆 的即時筆數統計。

新增黑名單

1. 點擊 「新增黑名單」 按鈕
2. 填寫以下資訊：

欄位	說明
付款人姓名	付款人姓名（文字輸入）
付款人手機	輸入後按 Enter 成為標籤，可新增多筆。格式驗證：必須為 09 開頭的 10 碼台灣手機號碼
付款人郵件	輸入後按 Enter 成為標籤，可新增多筆。格式驗證：需符合 Email 格式
身分證	輸入後按 Enter 成為標籤，可新增多筆。格式錯誤會顯示「身分證格式不正確」
銀行資訊	可新增多組銀行代碼 + 帳號組合。銀行代碼支援搜尋選取
類型	點選標籤按鈕，可複選多個類型
備註	自由輸入文字備註
啟用	預設啟用，可切換為停用

3. 點擊 「儲存」 完成新增

編輯黑名單

點擊操作欄的編輯圖示，開啟編輯表單（同新增表單），修改後儲存即可。

刪除黑名單

點擊操作欄的刪除圖示，確認後即刪除該筆黑名單紀錄。

匯入 CSV

1. 點擊 「匯入」 按鈕
2. 選擇 .csv 檔案上傳
3. 系統會批次匯入黑名單資料

匯出 CSV

點擊 「匯出」 按鈕，下載所有黑名單資料為 CSV 檔案。

無限捲動

黑名單列表採用無限捲動載入，每次載入 500 筆。行動裝置上的無限捲動已針對觸控操作進行最佳化。

檢視詳細資料

當黑名單紀錄包含多筆手機、信箱、身分證字號或銀行資訊時，表格中僅顯示第一筆加上 +N 數字。點擊該欄位可開啟詳細資料彈窗，檢視所有完整資料。

跨站鏡像與唯讀（站點限定）

站點限定

只有啟用此功能的站點才是唯讀的。沒有啟用的站點一律可以自己新增、編輯與刪除黑名單， 畫面上也不會出現「同步主站」按鈕。

部分站點是以「主站寫、從站鏡像」的方式共用同一份黑名單：從站的黑名單頁為唯讀， 只能查看與匯出，資料由主站同步下來（頁面上另有「同步主站」按鈕可手動拉取最新一份）。

同一套規則也套用在代付帳號註記（代付審核頁）與假資料管理這兩處資料上。

站點之間的關聯不等於唯讀

一個站點可能因為要向上層查詢系統餘額而掛著與主站的關聯，那與「這份資料要不要鏡像」 是兩件事。是否唯讀只取決於這項站點功能有沒有啟用。