建銀亞洲 CCB
本頁說明
講什麼：建銀亞洲的 API 流水採集、CcbasiaMatch 匹配規則、BOCO 日期處理機制的完整業務規則 適合誰：需要了解建銀對接細節的產品經理 前置閱讀：銀行能力矩陣預計閱讀：3 分鐘 負責人：入金產品經理
核心要點：建銀亞洲通過 API 採集流水，匹配引擎有獨特的 BOCO 日期處理機制——需注意跨日流水的歸屬判定。
能力總覽
| 能力 | 支持情況 | 協議/通道 | 核心服務 |
|---|---|---|---|
| 入金流水採集 | ✅ | API 定時拉取 | 標準 BankFlow 採集 |
| 出金 | ❌ | — | — |
| 子賬戶 | ❌ | — | — |
| eDDA/eDDI | ❌ | — | — |
| FPS | ❌ | — | — |
| 銀證 BST | ❌ | — | — |
建銀亞洲是純入金銀行——只負責採集流水和匹配入金申請，不支持出金。匹配規則是所有銀行中最嚴格的之一，四個條件缺一不可。
渠道接口概覽
| 維度 | 說明 |
|---|---|
| Protocol | API |
| 數據採集 | 定時拉取 |
| IMPORT_BANK_ID | 15 (CCBASIA) |
| TransType | 206 |
| 匹配引擎 | CcbasiaMatch |
入金：API 流水採集
採集方式
建銀通過標準 API 接口提供流水數據，系統定時拉取並寫入統一的 BankFlow 格式。
數據流
API 接口字段
建銀的流水數據基於通用 BankFlow 格式，包含以下關鍵字段：
| 字段 | 說明 | 用途 |
|---|---|---|
| transaction_id | 交易唯一標識 | 去重唯一鍵 |
| transaction_date | 交易日期 | 日期窗口匹配 |
| value_date | 起息日 | 輔助日期參考 |
| currency | 幣種 | 幣種匹配條件 |
| amount | 交易金額 | 金額容差匹配 |
| payer_name | 付款人姓名 | 姓名精確匹配 |
| payer_account | 付款人賬號 | 輔助識別 |
| beneficiary_account | 收款賬號 | moomoo 收款賬戶標識 |
| transaction_type | 交易類型 | 區分轉入/轉出 |
| remarks | 交易備註 | 補充信息 |
流水狀態處理
建銀流水採用標準的流水處置流程：
| 狀態 | 含義 |
|---|---|
| 0 | 待處理 |
| 1 | 已匹配 |
| 2 | 已入賬 |
| 3 | 已忽略 |
| 4 | 異常 |
匹配規則 (CcbasiaMatch)
核心特徵
建銀的匹配規則是所有銀行中最嚴格的之一——四個條件必須同時滿足，任一不滿足即不匹配。
| 維度 | 規則 | 說明 |
|---|---|---|
| 自動入賬 | ❌ 不支持 | 僅輔助匹配推薦，需人工確認 |
| 幣種匹配 | 必須一致 | 流水幣種 = 申請幣種 |
| 姓名匹配 | 英文精確匹配 (nameUsEqual) | 不支持模糊/相似匹配 |
| 金額匹配 | 標準容差（見下表） | 允許小額手續費扣減 |
| 日期匹配 | BOCO 日期規則 (daySimilarBoc) | -3 ~ +4 天，比標準多 2 天 |
金額容差
| 幣種 | 容差範圍 | 對比中銀本地 |
|---|---|---|
| HKD | CRM - 20 ≤ 流水 ≤ CRM | 與中銀本地一致 (-20) |
| USD | CRM - 3 ≤ 流水 ≤ CRM | 與中銀本地一致 (-3) |
為什麼容差與中銀本地一樣小？ 建銀入金以本地轉賬為主，手續費較低且可預測，因此採用通用標準容差即可覆蓋。
BOCO 日期窗口
建銀使用 daySimilarBoc 日期規則，窗口為 -3 ~ +4 天，比標準的 -3 ~ +2 天多 2 天：
| 日期規則 | 窗口範圍 | 使用銀行 |
|---|---|---|
daySimilar（標準） | -3 ~ +2 天 | DBS、恒生等大多數銀行 |
daySimilarBoc（BOCO） | -3 ~ +4 天 | 建銀 CCB、中銀跨境 |
為什麼多 2 天？ 建銀和中銀跨境共用 BOCO 日期規則。跨境轉賬可能因節假日、時區差異導致到賬延遲，+4 天的正向窗口可以覆蓋更多延遲場景。建銀雖以本地為主，但沿用了同一規則。
完整匹配邏輯
匹配條件匯總
| 條件 | 檢查方法 | 要求 | 缺失時結果 |
|---|---|---|---|
| 幣種 | 直接比較 | 流水幣種 = 申請幣種 | 不匹配 |
| 姓名 | nameUsEqual | 英文姓名精確相等（忽略大小寫） | 不匹配 |
| 金額 | amountSimilar | HKD: -20~0 / USD: -3~0 | 不匹配 |
| 日期 | daySimilarBoc | 流水日期在申請日期 -3~+4 天內 | 不匹配 |
與其他銀行的差異
大多數銀行在金額容差內匹配成功後會返回"普通匹配"，部分條件不滿足還可能降級為"建議匹配"。建銀沒有降級機制——要麼四個條件全滿足返回普通匹配，要麼直接不匹配。
定時任務
| 任務 | 頻率 | 說明 |
|---|---|---|
| 流水採集 | 定時拉取 | 從建銀 API 獲取最新流水 |
| match:ccbasia | 每 3 分鐘 | 執行建銀流水匹配 |
跟進時間：1 天——建銀匹配結果推薦給運營後，運營人員需在 1 天內完成人工審核。
與相似銀行對比
| 維度 | 建銀 CCB | 中銀 BOCHK 本地 | 工銀 ICBC |
|---|---|---|---|
| 入金協議 | API 拉取 | B2E XML API | 銀企直聯 API |
| 出金 | ❌ | ✅ FTS/FPS/電匯 | ❌ |
| HKD 容差 | -20 | -20 | -20 |
| USD 容差 | -3 | -3 | -3 |
| 日期窗口 | -3~+4 天 (BOCO) | -15~+15 天 | 標準 |
| 姓名規則 | 精確 (nameUsEqual) | 精確或相似 | 標準 |
| 自動入賬 | ❌ | ✅ | ❌ |
| 匹配嚴格度 | ⭐⭐⭐ 最嚴格 | ⭐⭐ 中等 | ⭐⭐ 中等 |
需求變更指引
| 變更需求 | 改動位置 | 說明 |
|---|---|---|
| 修改金額容差 | CcbasiaMatch.php → amountSimilar() | 調整 HKD -20 / USD -3 閾值 |
| 修改日期窗口 | CcbasiaMatch.php → daySimilarBoc() | 調整 -3~+4 天範圍 |
| 放寬姓名匹配 | CcbasiaMatch.php → 改為 nameSimilar() | 從精確匹配改為相似匹配 |
| 啟用自動入賬 | CcbasiaMatch.php → 添加 depositInstance 返回邏輯 | 當前不支持，啟用需評估風險 |
| 新增支持幣種 | CcbasiaMatch.php → 幣種判斷 | 添加新幣種的容差配置 |
| 修改匹配頻率 | deposit/doc/crontab.sh → match:ccbasia | 調整 cron 間隔 |
| 修改採集頻率 | 流水採集服務 cron 配置 | 調整定時拉取間隔 |
監控與告警
| 告警項 | 觸發條件 | 嚴重度 | 處理步驟 |
|---|---|---|---|
| API 連接超時 | 建銀 API 無響應 | 🟡 中 | 檢查網路，確認建銀側服務狀態 |
| 英文姓名匹配失敗率高 | 大量流水因姓名不匹配被拒 | 🟡 中 | 檢查姓名格式要求（精確匹配），引導用戶核對 |
| BOCO 日期偏移 | 流水日期與預期偏差 | 🟡 中 | 確認時區處理邏輯，檢查 BOCO 日期轉換 |
API 接口字段詳情
流水查詢請求
| 字段 | 類型 | 必填 | 描述 |
|---|---|---|---|
account_no | string | ✅ | 建銀賬號 |
start_date | string | ✅ | 查詢起始日期。格式 YYYYMMDD |
end_date | string | ✅ | 查詢結束日期。格式 YYYYMMDD |
page_no | int | ❌ | 頁碼，默認 1 |
page_size | int | ❌ | 每頁條數，默認 50 |
流水查詢響應
| 字段 | 類型 | 描述 |
|---|---|---|
trans_date | string | 交易日期（BOCO 格式） |
trans_amount | decimal | 交易金額 |
balance | decimal | 交易後餘額 |
trans_type | string | 交易類型 |
counterparty_name | string | 對手方名稱（用於姓名匹配） |
counterparty_account | string | 對手方賬號 |
remark | string | 交易備註 |
英文姓名匹配詳解
建銀是唯一要求英文姓名精確匹配的銀行。匹配規則：
| 維度 | 規則 | 說明 |
|---|---|---|
| 匹配方式 | 精確匹配 | 流水中的 counterparty_name 必須與 CRM 申請中的英文姓名完全一致 |
| 大小寫 | 不區分 | JOHN DOE 和 John Doe 視為匹配 |
| 空格處理 | 忽略多餘空格 | JOHN DOE 和 JOHN DOE 視為匹配 |
| 常見失敗原因 | 姓名順序 | 銀行側 DOE JOHN vs moomoo 側 JOHN DOE |
| 常見失敗原因 | 中間名 | 銀行側含中間名而 moomoo 側不含 |
| 常見失敗原因 | 特殊字符 | 銀行側含 - 或 '（如 O'BRIEN） |
姓名不匹配是建銀最常見的匹配失敗原因
運營在人工匹配時，需特別注意比對姓名的順序和拼寫。如果確認是同一人，可以手動確認匹配。
讀完之後
| 我想... | 去看 |
|---|---|
| 看建銀在各銀行中的位置 | 銀行能力矩陣 |
| 了解匹配引擎的完整邏輯 | 匹配與自動入賬 |
| 對比另一家嚴格匹配銀行 | 工銀 ICBC |
| 看日期窗口的詳細規則 | 入金規則速查 |
| 查 TransType 和 Bank ID 對照 | 入金規則速查 |