深色模式
建银亚洲 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 对照 | 入金规则速查 |
这个页面有帮助吗？