銀行能力矩陣
本頁說明
講什麼：一張表縱覽各銀行的入金/出金/eDDA/FPS/BST 能力，匹配規則速查，出入金方法碼映射 適合誰：需要快速查看某家銀行支持什麼的產品經理 前置閱讀：無，隨時查閱 預計閱讀：查閱型，按需搜索 負責人：出入金產品團隊
能力矩陣
| 銀行 | 入金流水 | 出金匯款 | eDDA/eDDI | FPS/BST |
|---|---|---|---|---|
| 中銀 BOCHK | B2E | FTS | - | FPS |
| 匯豐 HSBC | MT910 | 網銀 | eDDA + eDDI | - |
| 恒生 HASE | 恒生流水 | 網銀 | eDDA + eDDI | - |
| 渣打 SCB | - | FPS | - | FPS |
| 廣發 CGB | - | FPS API | - | FPS |
| 工銀 ICBC | 銀企直聯 | - | - | - |
| 招行 CMB | BST | BST | - | BST |
| 民生 MS | BST | BST | - | BST |
| 天星 Airstar | API | API | - | BST |
| EWB | CSV | 電匯 | - | - |
| 建銀 CCB | API | - | - | - |
| 星展 DBS | API | - | - | - |
| 交通 BANKCOMM | API | - | - | - |
| 眾安 ZA | 子帳戶 | - | - | - |
通道分類：13 家銀行按接入方式分三類——BST 銀證通道（招行/民生/天星，實時雙向轉賬）、eDDA/網銀通道（匯豐/恒生，代扣入金+網銀出金）、FPS/電匯/其他（中銀/渣打/廣發等，各有獨立協議）。側邊欄按此分組排列。
對接協議速查
| 銀行 | 協議類型 | 傳輸方式 | 核心服務 |
|---|---|---|---|
| BOCHK | B2E (Bank-to-Enterprise) | HTTP POST (XML) | bochk_flow_go (Go) |
| BOCHK 出金 | FTS (Fund Transfer) | SFTP S14/S16 (XML) | bochk_relay (Python) |
| HSBC | MT910 (SWIFT) | SFTP + GPG 加密 | hsbc_bank_flow_service (Python) |
| HSBC eDDI | eDDA/eDDI API | SRPC (Protobuf) | sba_hsbc_eddi (Python) |
| 恒生 eDDI | eDDA/eDDI API | SRPC (Protobuf) | sba_hase_eddi (Python) |
| SCB | REST API | HTTPS (JSON) | scb_service (Go) |
| CGB | FPS 報文 | HTTPS (XML) | cgb_fps_service (Go) |
| ICBC | 銀企直聯 | HTTPS + RSA (JSON) | icbc_be_relay (Python) |
| CMB | Socket 二進制 | 專線 TCP (GB18030) | cmb_stock_trans (Python) |
| 民生 | Socket 二進制 | 專線 TCP (GB18030) | ms_stock_bank_transaction (Python) |
| 天星 | REST API | HTTPS (JSON) | airstar_service (Go) |
| EWB | 文件導入 | CSV | — |
| CCB | REST API | HTTPS (JSON) | — |
| DBS | REST API | HTTPS (JSON) | — |
入金匹配規則速查
當一筆銀行流水進來後，系統需要把它和用戶的入金申請做匹配。每家銀行的匹配容差不同：
| 銀行 | 金額容差 (HKD/CNH) | 金額容差 (USD) | 日期窗口 | 特殊規則 |
|---|---|---|---|---|
| BOCHK | 本地 -20, 跨境 -420 | 本地 -3, 跨境 -60 | ±15 天 | FPS/網銀精確匹配，CHATS -20，跨境匯入 -420 |
| HSBC | 常規 -420, 自動 -65 | 常規 -60, 自動 -14 | 無固定窗口 | 按銀行卡號 + 金額匹配，無日期約束 |
| 恒生 | -20（WY/默認）/ 精確（ATM/GT/ZP/BP） | -3 | -3~+2（WY）/ 批次時間（ATM/GT） | 按流水類型分別匹配 |
| EWB | -420 | -60 | 無固定窗口 | 按幣種 + 姓名 + 金額匹配，無日期約束 |
| CCB | -20 | -3 | -3~+4 天 | 英文姓名精確匹配 |
| DBS | -350 (自動入賬) | -50 (自動入賬) | 無固定窗口 | 子帳戶歷史校驗優先，無日期約束 |
| ICBC | -420（自動）/ -20（CHATS） | -60（自動）/ -3 | ±15 天 | 新舊匹配雙路徑並行 |
| BST 三家 | 精確匹配 | 精確匹配 | 實時 | 直連，無需流水匹配 |
金額容差解讀："-20" 表示 CRM 申請金額 - 20 ≤ 銀行流水金額 ≤ CRM 申請金額。扣除的是銀行手續費，所以只允許流水金額比申請金額少，不允許多。
日期窗口詳細規則（來自 MatchRule.php）
| 規則名稱 | 窗口 | 公式 | 使用銀行 |
|---|---|---|---|
| daySimilar | -3~+2 天 | 流水日期-3 ≤ 申請日期 ≤ 流水日期+2 | 恒生(WY/ZP/默認) |
| daySimilarBoc | -3~+4 天 | 流水日期-3 ≤ 申請日期 < 流水日期+4 | CCB |
| — | — | — | HSBC、EWB、DBS 的匹配邏輯不包含日期窗口校驗。 |
| daySimilarRealTime | 同日~+2 天 | 流水時間 ≤ 申請日期 ≤ 流水日+2 | 實時推送銀行 |
| daySimilarRealTimeFps | -1小時~+2 天 | 流水時間-1h ≤ 申請日期 < 流水日+2 | FPS |
| BOC 自定義 | ±15 天 | 申請日期-15 < 流水日期 < 申請日期+15 | BOCHK |
出金方法碼映射
出金系統通過 method 字段決定走哪個通道。12 種方法碼如下：
| 方法碼 | 中文名 | 對應銀行 | 通道類型 |
|---|---|---|---|
manual | ICBC 轉賬 | 工銀 | 人工處理 |
auto_bs | 銀證轉賬 | 招行/民生/天星 | BST 自動 |
check | 支票轉賬 | — | 支票 |
tele_transfer | 中銀香港跨境電匯 | 中銀 | 跨境電匯 |
boc | 中銀同行提款 | 中銀 | FTS 同行 |
hase | 恒生網銀出金 | 恒生 | 企業網銀 |
hsbc | 匯豐網銀出金 | 匯豐 | 企業網銀 |
boc_fps | 中銀 FPS 出金 | 中銀 | FPS |
cgb_fps_api | FPS API（廣發） | 廣發 | FPS API |
ewb | EWB 電匯 | EWB | 電匯 |
chats_rtgs | CHAT/RTGS出金 | — | 銀行清算 |
sc | 渣打網銀出金 | 渣打 | FPS |
方法分組（Method.php）
| 分組 | 含義 | 包含方法 |
|---|---|---|
| allEBankMethod | 所有電子出金 | manual, boc, hase, hsbc, boc_fps, cgb_fps_api, chats_rtgs, sc |
| allTeleMethod | 電匯類 | tele_transfer, ewb |
| allSetMethod | 可配置方法 | 除 auto_bs, ewb, tele_transfer 外的 9 種 |
| allTabMethod | 管理後台可見 | allSetMethod + ewb + tele_transfer |
入金 Bank ID 速查
入金系統通過 import_bank_id 標識銀行來源：
| Bank ID | 銀行 | 備註 |
|---|---|---|
| 7 | 招行 CMB | 銀證入金 |
| 8 | 恒生 HASE | 流水入金 + eDDI 代扣 |
| 9 | 中銀 BOC | B2E 流水 |
| 10 | 工銀 ICBC | 銀企直聯流水 |
| 11 | 匯豐 HSBC | MT910 流水 + eDDI 代扣 |
| 13 | 民生 MS | 銀證入金 |
| 15 | 建銀 CCB | API 流水 |
| 16 | 星展 DBS | API 流水 |
| 21 | 交通銀行 | API 流水 |
| 12 | 渣打 SCB | FPS 出金流水 |
| 34 | EWB | CSV 文件導入 |
| 38 | EWB 子帳戶 | 子帳戶 CSV |
| 55 | 天星 Airstar | BST API |
按場景選銀行
上面的矩陣是"某銀行→支持什麼"，下面這張表反過來："我要做什麼→哪些銀行可選"。
| 我需要... | 可選銀行 / 通道 | 推薦首選 | 理由 |
|---|---|---|---|
| FPS 秒級入金 | 中銀 FPS、渣打、廣發 | 中銀 | 覆蓋用戶最廣，入金流水自動採集 |
| eDDA 自動代扣入金 | 匯豐、恒生 | 匯豐 | 用戶基數大，OTP 安全等級高 |
| BST 實時雙向轉賬 | 招行、民生、天星 | 天星 | 唯一支持線上開戶 + Mandate 授權 |
| 自動出金（無需人工操作） | 招行/民生/天星 BST (auto_bs)、廣發 FPS API (cgb_fps_api) | BST | 最成熟，三家已上線 |
| 大額出金（>100 萬 HKD） | 企業網銀 (hase/hsbc)、CHATS/RTGS | 企業網銀 | 無單筆上限，但需運營手動操作 |
| 跨境出金到大陸 | 中銀跨境電匯 (tele_transfer)、EWB 電匯 (ewb) | 中銀 | FTS 直連，自動化程度高 |
| 子帳戶獨立入金 | 星展 DBS、EWB | DBS | API 自動採集，EWB 需 CSV 導入 |
| 最低接入成本試點 | EWB（CSV 文件導入） | EWB | 零開發量，純文件導入 |
| 僅入金流水採集（不做出金） | 工銀、建銀、星展、交通 | — | 按用戶群體選擇 |
運營速查：服務時間與維護窗口
| 銀行 | 入金服務時間 | 出金服務時間 | 例行維護窗口 |
|---|---|---|---|
| 中銀 BOCHK | B2E: 每日 3 次（上午/下午/傍晚） | FTS: 工作日 | 週日 02:00~06:00 |
| 匯豐 HSBC | MT910: 7×24 實時推送 | 網銀: 工作日 | 不定期（提前郵件通知） |
| 恒生 HASE | 流水: 工作日 | 網銀: 工作日 | 週日凌晨（提前通知） |
| 渣打 SCB | — | FPS: 7×24 | 季度升級（提前通知） |
| 廣發 CGB | — | FPS API: 7×24 | 不定期 |
| 工銀 ICBC | 銀企直聯: 7×24 | — | 週六 23:00~週日 06:00 |
| 招行 CMB | BST: 工作日 07:00~次日 04:00 | BST: 工作日 07:00~15:55 | 週日凌晨 |
| 民生 MS | BST: 工作日 07:00~次日 04:00 | BST: 工作日 07:00~15:55 | 週日凌晨 |
| 天星 Airstar | BST API: 工作日 08:00~22:00 | BST API: 工作日 09:00~15:55 | 不定期 |
| EWB | CSV: 工作日 | 電匯: 工作日 | — |
維護窗口的影響
維護期間入金流水可能延遲到達、出金指令可能無法發送。遇到維護窗口內的「超時」告警，先確認是否在維護時間內再決定是否升級。
通道運行概況
手動更新。運營發現通道異常時更新此表，恢復後標回正常。
| 銀行 | 入金狀態 | 出金狀態 | 最近異常 | 備註 |
|---|---|---|---|---|
| 中銀 BOCHK | 🟢 正常 | 🟢 正常 | — | — |
| 匯豐 HSBC | 🟢 正常 | 🟢 正常 | — | — |
| 恒生 HASE | 🟢 正常 | 🟢 正常 | — | — |
| 渣打 SCB | 🟢 正常 | 🟢 正常 | — | — |
| 廣發 CGB | — | 🟢 正常 | — | — |
| 工銀 ICBC | 🟢 正常 | — | — | 僅入金 |
| 招行 CMB | 🟢 正常 | 🟢 正常 | — | — |
| 民生 MS | 🟢 正常 | 🟢 正常 | — | — |
| 天星 Airstar | 🟢 正常 | 🟢 正常 | — | — |
| EWB | 🟢 正常 | 🟢 正常 | — | — |
| 建銀 CCB | 🟢 正常 | — | — | 僅入金 |
| 星展 DBS | 🟢 正常 | — | — | 僅入金 |
| 交通 BANKCOMM | 🟢 正常 | — | — | 僅入金 |
如果需求變更：新增銀行接入
新增銀行時需更新以下位置（按順序）：
| # | 文件 | 操作 |
|---|---|---|
| 1 | 本頁 banks/matrix.md | 能力矩陣表、對接協議表、Bank ID 表各增一行 |
| 2 | banks/ 目錄 | 新建獨立銀行頁面（參考現有頁面結構） |
| 3 | docs/.vitepress/config.mts | sidebar Part 3 增加條目 |
| 4 | appendix/error-codes.md | 增加該銀行錯誤碼章節 |
| 5 | ops/monitoring.md | 如有定時任務/流水採集，增加對應監控條目 |
| 6 | deposit/matching.md | 如該銀行有入金匹配，增加銀行專屬規則 |
| 7 | withdraw/channels.md | 如該銀行有出金通道，增加通道執行說明 |
| 8 | guide/glossary.md | Bank ID 表增加條目 |
讀完之後
| 我想... | 去看 |
|---|---|
| 深入了解某家銀行 | 點擊上方矩陣表中的銀行名稱連結 |
| 了解匹配引擎的完整邏輯 | 匹配與自動入賬 |
| 看出金通道的執行細節 | 通道執行手冊 |
| 查錯誤碼和狀態碼 | 統一錯誤碼中心 |
| 查各銀行的定時任務和監控 | 定時任務與監控 |
這個頁面有幫助嗎？