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 對照 | 入金規則速查 |