深色模式
EWB
本页说明
讲什么：East West Bank 的 CSV/BAI2 文件导入入金、主账户与子账户双匹配规则、电汇出金的完整业务规则 适合谁：需要了解 EWB 对接细节的产品经理 前置阅读：银行能力矩阵预计阅读：4 分钟 负责人：入金产品经理
核心要点：EWB 通过 CSV/BAI2 文件导入流水，支持主账户和子账户双匹配模式，主要服务跨境电汇场景。
能力总览
| 能力 | 支持情况 | 协议/通道 | 核心服务 |
|---|---|---|---|
| 入金流水采集 | ✅ | CSV + BAI2 文件导入（手动上传） | 运营人员手动导入 |
| 出金电汇 | ✅ | Telegraphic Transfer 电汇 | method=ewb |
| 子账户 | ✅ | 主账户(34) + 子账户(38) | EwbMatch / EwbSubAccountMatch |
| eDDA/eDDI | ❌ | — | — |
| FPS | ❌ | — | — |
| 银证 BST | ❌ | — | — |
EWB 是唯一使用文件导入方式采集流水的银行——没有实时 API，运营人员手动上传 CSV 或 BAI2 文件，系统解析后进入匹配引擎。同时支持主账户和子账户两套独立的匹配逻辑。
渠道接口概览
| 维度 | 说明 |
|---|---|
| Protocol | 文件导入（无实时 API） |
| 数据格式 | CSV 和 BAI2 格式 |
| 采集方式 | 运营人员手动上传文件 |
| IMPORT_BANK_ID | 34（主账户 VELO）/ 38（子账户 EWB_SUBACC） |
| TransType | 207（VELO）/ 217（EWB_SUBACC） |
入金：CSV 文件导入
什么是 CSV/BAI2 导入
EWB 不提供实时 API，银行通过邮件或门户提供交易数据文件。运营人员下载后手动上传到入金系统，系统解析文件内容，将流水写入数据库后进入匹配引擎。
数据流
CSV 文件格式
CSV 是 EWB 最常用的流水文件格式，逗号分隔，包含以下关键字段：
| 字段 | 说明 | 示例 |
|---|---|---|
| Transaction Date | 交易日期 | 2026-04-28 |
| Value Date | 起息日 | 2026-04-28 |
| Description | 交易描述/摘要 | Wire Transfer / Other Deposit |
| Debit Amount | 借方金额 | — |
| Credit Amount | 贷方金额（入金关注此字段） | 10000.00 |
| Currency | 币种 | HKD / USD |
| Payer Name | 付款人姓名 | CHAN TAI MAN |
| Payer Account | 付款人账号 | — |
| Reference No | 交易参考号 | 用于去重 |
| Type | 交易类型 | Wire Transfer / Other Deposit |
BAI2 文件格式
BAI2（Bank Administration Institute Version 2）是美国银行业标准的对账文件格式，采用固定格式记录头/记录体/记录尾结构：
| 记录类型 | 代码 | 说明 |
|---|---|---|
| File Header | 01 | 文件头，包含发送方/接收方标识 |
| Group Header | 02 | 组头，包含银行标识和日期 |
| Account Header | 03 | 账户头，包含账号和余额信息 |
| Transaction Detail | 16 | 交易明细（入金核心数据） |
| Account Trailer | 49 | 账户尾，包含汇总信息 |
| Group Trailer | 98 | 组尾 |
| File Trailer | 99 | 文件尾 |
BAI2 交易明细（16 记录）字段说明
| 字段位置 | 说明 | 用途 |
|---|---|---|
| Type Code | 交易类型代码 | 区分借/贷、电汇/其他 |
| Amount | 交易金额 | 匹配核心 |
| Fund Type | 资金类型 | 即时/1天/2天可用 |
| Bank Reference | 银行参考号 | 去重唯一键 |
| Customer Reference | 客户参考号 | 补充标识 |
| Text | 描述文本 | 包含付款人信息 |
匹配规则：双引擎架构
EWB 是唯一使用两套独立匹配引擎的银行——主账户和子账户各有一套规则，互不干扰。
引擎 1：EWB 普通匹配 (ID:34, EwbMatch)
用于处理主账户（bank_id=34）的入金流水。
| 维度 | 规则 |
|---|---|
| 自动入账 | ❌ 已禁用（代码已注释 return MatchResult::depositInstance） |
| HKD 金额容差 | CRM - 420 ≤ 流水 ≤ CRM |
| USD 金额容差 | CRM - 60 ≤ 流水 ≤ CRM |
| 日期窗口 | 标准 daySimilar |
| 匹配引擎 | EwbMatch.php |
为什么 HKD 容差高达 -420？ EWB 的入金以电汇为主，国际电汇经过中转行可能扣除 20-400 港币不等的手续费，因此容差设为所有银行中最大的 -420。
匹配逻辑：
| 条件组合 | 匹配结果 | 说明 |
|---|---|---|
| 金额精确相等 + 姓名精确匹配 | 普通匹配 | 最理想情况 |
| type="Other Deposit" + 金额精确相等 | 普通匹配 | 不看姓名（见下方说明） |
| 姓名相似 + 金额在容差范围内 | 普通匹配 | 允许手续费扣减 |
| 其他 | 不匹配 | — |
"Other Deposit" 特殊规则
当流水类型为 "Other Deposit" 时，系统只看金额不看姓名。这类流水通常是银行内部调账或批量入账，付款人信息不准确或缺失，强制姓名匹配会导致漏单。
引擎 2：EWB 子账户匹配 (ID:38, EwbSubAccountMatch)
用于处理子账户（bank_id=38）的入金流水，匹配规则比主账户更严格但支持自动入账。
| 维度 | 规则 |
|---|---|
| 自动入账 | ✅ 已启用 |
| 自动入账 HKD 容差 | CRM - 40 ≤ 流水 ≤ CRM |
| 辅助匹配 HKD 容差 | CRM - 100 ≤ 流水 ≤ CRM |
| 支持币种 | 仅 HKD |
| 匹配引擎 | EwbSubAccountMatch.php |
为什么子账户容差更小？ 子账户入金通常是本地转账，手续费较低且可预测，不需要像主账户电汇那样预留大额容差。
匹配逻辑：
| 条件组合 | 匹配结果 |
|---|---|
| 币种=HKD + 金额在自动入账容差内（-40~0） | 自动入账 (Deposit Match) |
| 币种=HKD + 金额在辅助匹配容差内（-100~0） | 普通匹配 |
| 其他 | 不匹配 |
两套引擎对比
| 维度 | 主账户 (ID:34) | 子账户 (ID:38) |
|---|---|---|
| 匹配类 | EwbMatch | EwbSubAccountMatch |
| 自动入账 | ❌ 禁用 | ✅ 启用 |
| HKD 容差 | -420 ~ 0 | -40（自动）/ -100（辅助） |
| USD 容差 | -60 ~ 0 | ❌ 不支持 |
| 姓名检查 | 精确或相似 | 不适用（子账户已证明归属） |
| 特殊规则 | Other Deposit 免姓名 | 仅限 HKD |
出金：电汇 (Telegraphic Transfer)
出金方法
| 维度 | 说明 |
|---|---|
| 方法码 | TRANSFER_METHOD_EWB = 'ewb' |
| 分类 | 电汇方法（allTeleMethod） |
| 中文名 | EWB 电汇 |
| 自动化程度 | 半自动（需运营操作） |
| 跟进时间 | 3 天 |
电汇出金数据流
跟进时间为什么是 3 天？ 国际电汇通常需要 1-3 个工作日到账，运营人员需要在此期间跟踪银行侧处理状态。
子账户体系
EWB 采用主账户+子账户的双层架构，通过不同的 bank_id 区分：
| bank_id | 名称 | 类型 | TransType | 匹配引擎 | 用途 |
|---|---|---|---|---|---|
| 34 | VELO | 主账户 | 207 | EwbMatch | 常规电汇入金 |
| 38 | EWB_SUBACC | 子账户 | 217 | EwbSubAccountMatch | 子账户入金 |
主账户与子账户的业务区别：
- 主账户：所有用户共享一个收款账号，入金后通过姓名+金额匹配到具体用户
- 子账户：每个用户分配唯一的子账户号，入金后通过账号直接确认归属，因此可以支持自动入账
需求变更指引
| 变更需求 | 改动位置 | 说明 |
|---|---|---|
| 修改主账户金额容差 | EwbMatch.php → amountSimilar() | 调整 HKD -420 / USD -60 阈值 |
| 修改 "Other Deposit" 规则 | EwbMatch.php → type 判断逻辑 | 添加/移除免姓名匹配的交易类型 |
| 启用主账户自动入账 | EwbMatch.php → 取消注释 depositInstance 返回 | 当前已禁用，启用需评估风险 |
| 修改子账户自动入账容差 | EwbSubAccountMatch.php → amountSimilarForAuto() | 调整 HKD -40 阈值 |
| 修改子账户辅助匹配容差 | EwbSubAccountMatch.php → amountSimilar() | 调整 HKD -100 阈值 |
| 子账户支持 USD | EwbSubAccountMatch.php → 币种判断 | 当前仅支持 HKD |
| 新增子账户类型 | 数据库 bank_id 配置 + 新增 Match 类 | 需同时注册匹配引擎 |
| 修改出金跟进时间 | 出金跟进配置 | 调整 3 天期限 |
| 修改出金审批模板 | Task.php → $stepTemplates | 调整 EWB 电汇出金审批流程 |
| 修改 CSV 解析规则 | CSV 文件解析服务 | 适配银行侧字段变更 |
常见客诉 Top 3
| # | 用户反馈 | 原因 | 客服话术 |
|---|---|---|---|
| 1 | "EWB 入金没到" | CSV 文件未导入或格式错误 | "您的入金正在处理中，如超过 2 个工作日请联系客服" |
| 2 | "EWB 电汇出金很慢" | 跨境电汇通常 1-3 个工作日 | "电汇出金通常需要 1-3 个工作日到账，请耐心等待" |
| 3 | "子账户和主账户弄混了" | Bank ID 34(主) vs 38(子) 导入错误 | "请确认入金对应的账户类型，如有错误请联系客服修正" |
监控与告警
| 告警项 | 触发条件 | 严重度 | 处理步骤 |
|---|---|---|---|
| CSV 文件导入失败 | 文件格式不符合 BAI2 规范 | 🔴 高 | 检查文件编码和分隔符，对照模板修正 |
| 文件格式变更 | EWB 银行侧调整了导出格式 | 🔴 高 | 获取新格式说明，更新解析逻辑 |
| 主/子账户文件混淆 | 导入了错误类型的文件 | 🟡 中 | 确认 Bank ID（34=主账户, 38=子账户），重新导入 |
读完之后
| 我想... | 去看 |
|---|---|
| 看 EWB 在各银行中的位置 | 银行能力矩阵 |
| 了解匹配引擎的完整逻辑 | 匹配与自动入账 |
| 看另一家有子账户的银行（DBS） | 星展 DBS |
| 查出金通道的执行细节 | 通道执行手册 |
| 查 TransType 和 Bank ID 对照 | 入金规则速查 |
这个页面有帮助吗？