深色模式
银行能力矩阵
本页说明
讲什么：一张表纵览各银行的入金/出金/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 表增加条目 |
读完之后
| 我想... | 去看 |
|---|---|
| 深入了解某家银行 | 点击上方矩阵表中的银行名称链接 |
| 了解匹配引擎的完整逻辑 | 匹配与自动入账 |
| 看出金通道的执行细节 | 通道执行手册 |
| 查错误码和状态码 | 统一错误码中心 |
| 查各银行的定时任务和监控 | 定时任务与监控 |
这个页面有帮助吗？