腳本配置

路徑：/admin/system/scrapers  |  快捷鍵：- → U  |  選單位置：爬蟲管理 → 腳本配置

管理銀行網銀爬蟲（Bank Scraper）的部署與連線狀態。爬蟲用於自動登入銀行網銀查帳，將入帳交易即時比對訂單並完成自動回調。

站點限定

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

頁面說明

頁面頂部提供「下載腳本」與「新增」按鈕，下方為爬蟲實例列表。

搜尋與狀態篩選的右側會顯示 腳本最新版號（例如 v1.0.98），也就是客戶端目前應該更新到的版本。若暫時取不到（例如連不上發布來源），該欄位會自動隱藏，不影響其他功能。

表格欄位

欄位	說明
名稱	爬蟲實例名稱（粗體）
狀態	online（綠色標籤）或 offline（灰色標籤），依 WebSocket 心跳判定
啟用卡號	該爬蟲負責監控的銀行卡號列表，最多顯示 3 個標籤，超過以 +N 標籤展開
最後心跳	上次 WebSocket 心跳的時間
建立時間	爬蟲實例建立時間
操作	功能按鈕

操作按鈕

按鈕	說明
複製安裝碼	複製該爬蟲的安裝碼至剪貼簿
重新產生金鑰	重新產生 API Key，產生後顯示新的安裝碼（需確認）
編輯	修改名稱與啟用卡號
刪除	刪除爬蟲實例（需確認）

新增爬蟲

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

欄位	必填	說明
名稱	是	爬蟲實例的識別名稱
啟用卡號	否	多選下拉，從 CTCPAY vendor 列表中選取該爬蟲要監控的卡號，支援全選/取消全選

建立成功後會彈出安裝碼（Setup Code），需複製並用於客戶端安裝。

DANGER

安裝碼包含 API Key，僅在建立與重新產生金鑰時顯示，請妥善保存。

安裝教學

點擊頁面頂部的「下載腳本」按鈕開啟彈窗（標題為「客戶端安裝教學」），以分頁方式提供 Windows 與 macOS 的安裝步驟：

Windows

1. 安裝：開啟 PowerShell，貼上一行安裝指令（含安裝碼），自動下載並設定爬蟲
2. 啟動：在開始選單搜尋 scraper 即可啟動
3. 解除安裝：貼上一行解除安裝指令即可移除

macOS

1. 安裝：開啟終端機，貼上一行安裝指令（含安裝碼），自動下載並設定
2. 啟動：從「應用程式」資料夾開啟，或在終端機輸入 scraper
3. 解除安裝：貼上一行解除安裝指令即可移除

桌面應用程式

爬蟲提供圖形化桌面應用程式（Electron GUI），介面已全面中文化，支援：

• 即時顯示連線狀態與爬取紀錄
• 自動偵測並下載所需瀏覽器（首次啟動時）
• 選單列中文化操作
• 代付分頁查看當日代付訂單（見下方）
• 快照分頁查看與匯出頁面現場（見下方）
• 版本更新檢查與一鍵安裝（見下方）

代付分頁

桌面版的「代付」分頁會顯示台北時間當日建立的全部代付訂單，供操作人員在轉帳時核對。

項目	說明
資料來源	向後端查詢，不是本機資料；「今天」一律以台北時區計算，與爬蟲機器所在時區無關
狀態文案	待處理／已完成／已拒絕，與後台代付審核頁一致
顯示上限	單次最多 500 筆；當日總筆數仍會完整顯示，超出時請改以後台查詢
資料範圍	只提供轉帳核對必要的欄位，不含操作者、來源 IP、回調紀錄等後台資訊

綁定卡片

桌面版的「管理綁定卡片」清單會列出所有卡對卡通道，包含已停用的（標示「已停用」）。

為什麼停用的卡也要列出來

這個彈窗送出的是完整清單（等於覆寫）。停用的卡若沒有列出來就無法被勾選， 下次存檔時就會從綁定裡消失，而且整個過程沒有任何訊息 —— 卡片重新啟用後查帳也不會自己回來。

已停用的卡照樣可以開啟、登入網銀、自動查帳與自動配對回調。 停用只代表「不再把新訂單派到這張卡」：停用前建立、還沒過期的待付款訂單仍然存在， 客戶早就拿到那組帳號正要匯款，擋掉自動配對只會讓那些錢全部得走人工補登。

自動配對失敗時的原因

一筆入帳沒有配到訂單時，畫面上會直接寫出原因，不再只是「no matches」：

原因	意思
這筆入帳沒有對方帳號	明細裡沒解析到付款人帳號欄，無從比對
找不到金額 X 的待付款訂單	可能已逾期、已付款，或那筆單不在這張卡上
有 N 張金額 X 的待付款訂單，但預約帳號都對不上	訊息會同時印出入帳的付款人帳號與訂單預約的帳號，一眼看得出是誰的格式不對
疑似重複認列	2 小時內已有人工補登同金額同帳號的訂單，改由人工判斷
配對過程發生錯誤	系統錯誤，訊息會帶出詳細內容

代付作業

桌面版的代付一律是只把轉帳表單填好，不自動按下送出 —— 錢由操作員親手匯出。

項目	說明
選卡視窗	顯示通道名稱，與「查帳」分頁的格式一致，不必再靠帳號認卡
取消後換卡	取消一筆代付後可以立刻改用另一張卡重跑，不必等
代付進行中	該台機器上的自動查帳會全部暫停，避免兩件事互相搶瀏覽器
代付前檢查	動手前會先確認銀行登入狀態還在，session 掉了就先處理登入，而不是走到一半才說「找不到轉帳頁」
按了沒動靜	三種會靜默失敗的情況都補上了畫面回饋，不會再出現按了「自動代付」卻什麼都沒發生

已按下送出但讀不到結果時，絕不會自動重跑

如果送出鍵已經按下、但沒讀到銀行的結果頁（例如瀏覽器被關掉），錢可能已經匯出去了。 這種情況系統會把這張單留在原處、不釋放派工，並在單上寫明 「已按下送出但沒讀到結果，錢可能已經匯出，請至銀行確認後再結案」。

絕不可以把它放回可重跑的狀態 —— 放回去等於同一張單被重新認領又匯一次。

送出後自動向銀行查證

送出之後系統會自行向銀行查證這筆是否真的匯出成功。查證確認成功時，這張單會走 與人工按下「核准」完全相同的流程（扣款、寫紀錄、推播、站內信、回調商戶）， 審核人記為「自動代付（查證確認）」，詳見代付審核。

快照分頁

桌面版的「快照」分頁會把爬蟲每進入一個頁面時留下的現場列出來， 出問題時不必再請人去翻資料夾、也不必重現一次才看得到畫面。

欄位	說明
時間	存下這一份的時間（當天只顯示時分秒）
銀行	這份現場屬於哪一張卡／哪一家銀行
步驟／頁面	是哪一頁或哪一個步驟（例如「頁面 /netbank/query」「代付 SUBMIT」「查帳 0 筆」）
說明	為什麼留下這一份
大小	這一份佔多少空間

• 點 「開啟」 會在獨立視窗直接把那一頁打開來看
• 上方下拉可只看某一家銀行，右上角顯示目前總共佔用多少空間
• 「匯出 ZIP 到桌面」 會把快照打包成一個壓縮檔放到桌面並自動選取它，方便傳給技術人員

佔用空間是固定的，不會愈長愈大

平時每一個頁面只保留最新一份，所以一張卡就是「它走過的那幾頁」各一份。 查帳是每 30 秒自動跑一輪、不是有人在點，如果每次都留一份，一張卡一天就會產生數 GB。

診斷模式

需要往前翻好幾輪（例如要比對「上一次成功時畫面長什麼樣」）時，打開分頁上的 診斷模式 開關，保留份數會放大。

它會自動到期（開關旁有倒數），不必擔心忘了關 —— 忘了關就會一直累積， 而快照裡有客戶姓名、完整帳號與交易明細。

快照含個資，而且只存在那台電腦上

快照是銀行頁面的原樣保存，裡面有姓名、完整銀行帳號、餘額與交易明細。

• 只存在爬蟲那台電腦，不會回傳到系統後台，我們這邊也看不到
• 保留 7 天，過期自動刪除
• 匯出前請先確認內容，不要傳給不相干的人

開啟檢視時頁面上的所有程式碼都已被移除、也不會連線到任何網站， 純粹是「把當時的畫面顯示出來」。

版本更新

桌面版可自行檢查並安裝新版本，設定頁提供「檢查更新」按鈕與「自動檢查更新」開關。

項目	說明
自動檢查	啟動後約 1 分鐘檢查一次，之後每 6 小時一次；可由設定頁的開關關閉
手動檢查	點擊「檢查更新」立即比對；已是最新版時也會明確顯示結果
安裝方式	只提示、不自動安裝 —— 更新會重啟程式並中斷各銀行的登入狀態，須由操作人員自行挑時間
二次確認	按下更新後仍需再次確認，並提醒更新完成後各銀行需重新登入
失敗處理	檢查失敗只顯示訊息，不影響查帳與代付的正常運作

更新前請先確認沒有進行中的作業

安裝新版會關閉程式並重新啟動，正在進行的查帳與網銀登入狀態都會中斷。建議在非交易尖峰時段更新，完成後重新登入各銀行。

系統需求

• macOS 10.15+ 或 Windows 10+
• 需要網路連線
• 約 500MB 磁碟空間
• 無需預先安裝任何軟體（瀏覽器會自動下載）

編輯爬蟲

可修改爬蟲名稱與啟用卡號。啟用卡號的變更會即時透過 WebSocket 推送至已連線的爬蟲客戶端。

爬蟲運作原理

爬蟲客戶端安裝於客戶機器上，透過 Playwright 自動化瀏覽器登入銀行網銀，定期查詢帳戶交易明細。查詢到的入帳交易透過 WebSocket 回報至後端，後端根據金額與帳號資訊自動比對待付款訂單，匹配成功則完成訂單並發送回調通知。

目前支援的銀行包含國泰世華、玉山、台新、中國信託、星展、富邦、彰化、高雄、京城、將來、樂天等主要銀行，共計 60+ 支 adapter（含個人網銀與企業公戶）。