入金规则速查

本页说明

讲什么：入金相关的所有参考数据——状态码、限额、容差、时效、字段含义。本页是唯一信源，其他页面引用而非重复 适合谁：需要查询具体数字/代码的产品经理和运营人员 前置阅读：无，随时查阅 预计阅读：查阅型，按需搜索 负责人：入金产品经理

快速跳转 — 你可能想做的事：

查某个状态码什么意思？→ 入金状态码
查某银行的匹配容差？→ 匹配容差规则
查某银行的 TransType 代码？→ 银行通道类型代码
查超时多久会自动驳回？→ 超时与自动驳回配置
查入金类型（DepositType）？→ 入金类型
查数据库分表规则？→ 数据库分片策略

入金状态码

申请状态（Apply Status）

状态码	含义	说明
0	待处理	用户已提交，等待银行流水到达和匹配
1	处理中	已匹配/已确认扣款，正在执行 SBA 入账
2	已完成	入金成功，资金已到证券账户
3	已驳回	超时驳回或运营驳回
4	已撤回	用户主动取消
5	已冲正	已入账资金被撤回

流水状态（Flow Status）

状态码	含义	说明
0	待处理	银行流水刚到达，等待匹配
1	已处理	已匹配并完成入金
2	错误	处理失败，需人工干预
3	已锁定	运营锁定调查中
4	在途	资金在途未确认
9	已删除	标记为无效

匹配结果码

结果码	含义	后续
0	不匹配	跳过，等下一轮
1	辅助匹配	写入匹配表，等运营确认
2	完全匹配	进入自动入账判定

币种与自动入账限额

币种	代码	单笔自动入账上限	每日自动笔数上限
HKD（港币）	1	2,000,000	10 笔/用户
USD（美元）	2	300,000	10 笔/用户
CNH（离岸人民币）	3	2,000,000	10 笔/用户
JPY（日元）	4	40,000,000	10 笔/用户
SGD（新加坡元）	5	350,000	10 笔/用户

边界说明：限额为单笔判断（非累计），使用闭区间（≤），即金额恰好等于限额时仍可自动入账。超过限额不会失败，只是不能自动入账，需运营人工确认。每日 10 笔限制按自然日（00:00~24:00 HKT）计算，不区分交易日。

为什么是这些限额？

币种	限额	设计依据
HKD 200 万	覆盖 99%+ 的正常入金。超过 200 万的入金极少见，且金额越大误匹配的风险和影响越大
USD 30 万	约等于 HKD 200 万（按 ~6.5 汇率），保持各币种限额等价
CNH 200 万	与 HKD 等额设置
JPY 4000 万	约等于 HKD 200 万（按 ~0.05 汇率）
SGD 35 万	约等于 HKD 200 万（按 ~5.7 汇率）
每日 10 笔	正常用户极少一天入金超过 3 次。10 笔留了充足余量，同时防止异常批量入金

如果需求变更：修改自动入账限额

代码位置：deposit/src/app/Business/Match/MatchBase.php（约第 38-44 行）

MAX_AUTO_DEPOSIT_AMOUNT_HKD = 2000000
MAX_AUTO_DEPOSIT_AMOUNT_USD = 300000
MAX_AUTO_DEPOSIT_AMOUNT_CNH = 2000000
MAX_AUTO_DEPOSIT_AMOUNT_JPY = 40000000
MAX_AUTO_DEPOSIT_AMOUNT_SGD = 350000
MAX_AUTO_DEPOSIT_COUNT = 10  // 每日每用户上限笔数

常见变更场景：

调高/调低某币种限额 → 修改对应常量值。注意：这会影响所有银行的自动入账判定
调整每日笔数上限 → 修改 MAX_AUTO_DEPOSIT_COUNT
某银行使用不同限额 → 需在该银行的 Match 类中覆写限额检查逻辑（当前所有银行共用同一限额）

匹配容差规则

标准容差

公式：Apply.amount - 容差 ≤ Flow.amount ≤ Apply.amount（流水金额可比申请少最多"容差"元，闭区间）

场景	币种	容差
本地转账	HKD / CNH / JPY	0 ~ 20
本地转账	USD / SGD	0 ~ 3
跨区/跨行	HKD / CNH / JPY	0 ~ 420
跨区/跨行	USD / SGD	0 ~ 60

边界说明：差额恰好等于容差值时仍算匹配。例如 HKD 本地容差 20：申请 50,000、流水 49,980 → 匹配成功。跨区容差更大是因为中转行手续费不可控。

各银行特殊容差

不同银行有各自的容差标准。"自动入账容差"用于全自动入账判定，"辅助匹配容差"用于生成候选匹配对供人工确认——后者更宽松。

银行	币种	自动入账容差	辅助匹配容差
中银（BOCHK）	HKD	0~20	0~20
中银（BOCHK）	USD	0~3	0~3
汇丰（HSBC）	HKD	0~65	0~420
汇丰（HSBC）	USD	0~14	0~60
工银亚洲	HKD	0~20	0~20
工银亚洲	USD	0~55	0~55
星展（DBS）	HKD	0~350	0~350
星展（DBS）	USD	0~50	0~50
EWB	HKD	—	0~420
EWB	USD	—	0~60
EWB 子账户	全币种	0~40	0~100
众安子账户	HKD	0~350	0~350
众安子账户	USD	0~50	0~50
新加坡工银	HKD	0~500	0~500
新加坡工银	USD	0~70	0~70

匹配时间窗口

流水类型	匹配窗口	适用银行/场景
标准流水	流水日期 -3天 ~ +2天	大部分银行常规流水
中银流水	流水日期 -3天 ~ +4天	中银 B2E（流水延迟较大）
实时流水	流水到达时间 ~ +2天	MT910、银证等实时推送
实时 FPS	流水到达时间 -1小时 ~ +2天	FPS（允许流水略早于申请）
非实时流水	流水日期 -3天 ~ +2天	批量导入的历史流水

边界说明：时间窗口中的"天"按自然日计算（非交易日）。"-3天"指 申请日期 - 3 × 24小时，精确到秒。"流水日期"对于实时流水使用到达时间戳（精确到秒），对于批量流水使用交易日期（精确到天，以 00:00:00 为准）。

为什么不同流水类型用不同窗口？

窗口	设计依据
标准 -3/+2 天	用户可能先申请后转账（最多提前 3 天申请），或先转账后申请（最多延后 2 天申请）。覆盖绝大部分正常操作时序
中银 +4 天	B2E 每日仅 3 次拉取 + 2 小时格式转换，流水可能比交易晚 1~2 天进入系统，因此额外放宽 2 天
FPS -1 小时	FPS 秒级到账，但用户可能先转账再申请（银行流水比申请早几秒到几十秒）。-1 小时覆盖这种"先转后申"场景
实时 +2 天	实时流水精确到秒，用更精准的时间比较而非天级比较，降低同金额同用户多笔入金的误匹配风险

超时与自动驳回配置

申请超时后系统自动处理，分两阶段：先通知（提醒上传凭证），再驳回。天数按 HKEX 交易日计算。

银行	入金方式	通知天数	驳回天数（通知后）
工银/恒生/中银	FPS	1	1
工银/恒生/中银	网银同行	1	1
工银/恒生/中银	网银跨行（HKD）	2	1
工银/恒生/中银	网银跨行（USD/CNH）	4	1
工银/恒生/中银	ATM	2	1
工银/恒生/中银	支票	2	1
汇丰	网银同行	1	1
汇丰	网银跨行	4	1
EWB	所有方式	4	1
众安子账户	所有方式	不通知	10

补充凭证超时：需补充凭证超 20 个交易日未提供 → 自动驳回。凭证已提供但超 10 个交易日无流水 → 自动驳回。

边界说明：超时天数表中的"天"按 HKEX 交易日计算（排除周末和香港公众假期）。补充凭证超时按交易日计算。两种口径不同——入金超时用交易日是因为银行只在交易日处理转账。

如果需求变更：调整超时驳回天数

代码位置：deposit/src/app/Business/AutoNoticeReject.php（约第 371-424 行）

超时通知和驳回天数通过 getConfig() 方法按银行和入金方式配置，返回结构为：

[
    'notice_day' => 通知天数,    // 申请创建后多少交易日发通知
    'reject_day' => 驳回天数,    // 通知发出后多少交易日自动驳回
]

常见变更场景：

调整某银行某方式的通知天数 → 在 getConfig() 的对应分支中修改 notice_day 值
调整补充凭证超时 → 搜索 supplement 相关常量（当前：未提供=20 天，已提供无流水=10 天）
新增银行的超时配置 → 在 getConfig() 中添加新的条件分支
关闭某银行的自动通知（如众安子账户模式） → 将 notice_day 设为 null 或特殊标记

注意：

天数按 HKEX 交易日计算（排除周末和公众假期），交易日历维护在 deposit/config/ 目录
修改通知天数会影响用户收到的推送消息时机
驳回后系统会自动发送驳回通知给用户（驳回原因码=9 超时）

自动处理时段

方式	营业时段	暂停期
BST 银证	周一 08:00 ~ 周五 16:00	—
eDDA（汇丰/恒生）	周一 07:00 ~ 周六 10:00	—
天星银证	工作日营业时间	—
FPS	与 BST 类似	—
匹配引擎	7×24（每 3 分钟）	自动入账受上述时段限制

每日 16:00~16:10 为账户对账暂停期，所有自动入金处理暂停。

自动入账处理时段（按币种）

不同币种的自动入账开始时间不同——USD 晚于其他币种 2 小时开始，避免美元清算时段干扰：

币种	开始时间	结束时间	周六	说明
HKD	07:00	次日 04:00	到 09:55 关闭	覆盖港股交易日全时段
USD	09:01	次日 04:00	到 09:55 关闭	晚于 HKD，避免美元清算干扰
CNH	07:00	次日 04:00	到 09:55 关闭	同 HKD
JPY	07:00	次日 04:00	到 09:55 关闭	同 HKD
SGD	07:00	次日 04:00	到 09:55 关闭	同 HKD

非处理时段内的流水仍会被匹配引擎匹配，但不会触发自动入账——降级为辅助匹配等运营确认。

配置位置：deposit/src/app/Business/DepositConfigNew.php（USD 特殊开始时间约第 440 行，周六关闭约第 498 行）

2412 暂停窗口（适用所有自动入账）：

暂停时段	原因	影响范围
08:55 ~ 09:00	开盘前对账	所有自动入账暂停
16:05 ~ 16:10	收盘后对账	所有自动入账暂停

配置位置：deposit/src/app/Business/DepositConfigNew.php:603-641

eDDA 银行维护窗口：

银行	维护时段	影响
恒生	周日 00:00 ~ 08:30	不接受 eDDI 请求
汇丰	周日 00:00 ~ 12:00	不接受 eDDI 请求

维护时段内提交的 eDDI 指令进入 Blank 状态，下个工作时段自动激活。详见 eDDA 代扣入金 § 处理时段。

处理时效参考

方式	最快	典型	最慢
eDDA	数分钟	~5 分钟	数小时（银行侧延迟）
BST 银证	~10 分钟	~10 分钟	下一交易日（非营业时段）
天星银证	~10 分钟	~10 分钟	下一交易日
FPS 转数快	3 分钟	3~5 分钟	下一匹配周期
网银同行	2 小时	2 小时	当日
网银跨行	2 天	2~3 天	4 天（外币）
ATM/柜台	2 小时	2 小时	次交易日 11:00
缴付账单	2 小时	2 小时	次交易日
支票	2 天	2~3 天	3 天
海外汇款	3 天	5 天	5+ 天

各银行流水到达时效

各银行流水的采集方式、协议、到达时效和采集服务的完整对比 → 银行流水采集 § 汇总对比表

驳回原因码

代码	含义	典型场景
1	信息不清楚	凭证/信息无法辨认
2	网银信息缺失	网银转账缺少必要信息
3	ATM 信息缺失	ATM 凭证缺少必要信息
4	银行账户信息缺失	缺少银行账户信息
5	证券账户异常	用户账户状态有问题
6	交易被取消	银行侧取消了交易
7	申请被合并	多笔申请合并处理
8	重复申请	系统检测到重复入金
9	超时	长时间未收到资金
10	其他（港区）	香港地区其他原因
11	其他（大陆）	大陆地区其他原因
12	其他（海外）	海外地区其他原因
14	账户不一致	转账人与申请人不一致
15	转账信息不足	转账凭证信息不完整

入金方式代码

代码	Key	中文名	模式
1	`bst`	银证转账	Direct
2	`atm`	ATM/柜台	Push
3	`fps`	FPS 转数快	Push
4	`bp`	缴付账单	Push
5	`ebank`	网银转账	Push
6	`check`	支票	Push
7	`subAccount`	海外汇款	Push
8	`edda`	eDDA 恒生	Pull
9	`eddaHSBC`	eDDA 汇丰	Pull
10	`bstAsb`	天星银证	Direct

入金类型（Deposit Type）

代码	类型	说明
1	NORMAL	标准流程——流水匹配后自动入账
2	PRE_APPROVAL	预审批——用于线上开户场景
3	ABNORMAL	异常模式——运营在流水系统中手工创建
4	TRANS_AUTO	自动审批——前端精确匹配后自动审批
5	HIGH_RISK	高风险——命中风控规则，需人工审核
11	NORMAL_HOLD	冻结模式——先冻结再入账
21	STOCK_HOLD	股票定投冻结模式——eDDI 入金后冻结，预留给股票定投扣款
31	FUND_PURCHASE_HOLD	基金申购冻结模式——eDDI 入金后冻结，预留给基金申购

HOLD 类型说明：代码 11/21/31 统称为 HOLD 类型（HOLD_LIST = [11, 21, 31]）。这些类型的入金到账后资金被系统冻结，预留给对应的投资操作。冻结释放时机由投资侧系统控制，非入金系统管辖。
配置位置：deposit/src/app/Common/EddiDepositType.php

通知类型

代码	类型	触发场景
1	普通入金通知	入金完成
2	线上开户绑卡通知	线上开户首次入金绑卡成功
3	绑卡后入金通知	线上开户绑卡后的入金完成
4	大陆预开户通知	大陆预开户入金到账

核心字段说明

申请关键字段（Apply）

字段	业务含义
`uid`	用户 ID（牛牛号），决定申请存入哪张分表
`amount`	用户申请入金金额
`real_amount`	实际到账金额，可能因手续费低于申请金额
`currency`	币种：HKD / USD / CNH
`deposit_method`	入金方式代码（见上表）
`status`	申请状态（0~5，见上表）
`export_bank_id`	付款银行 ID（用户侧）
`import_bank_id`	收款银行 ID（公司侧）
`bank_card_number`	用户银行账号，匹配引擎用来做卡号比对
`area`	付款银行地区：HK / CN / OS
`notice_type`	通知类型（1~4，见上表）
`deal_type`	处理方式：`bst`（银证）/ `eddi`（eDDA/eDDI 代扣）/ `auto`（脚本自动）/ `manual`（人工）
`supplement_status`	凭证补充状态：0=不需要 / 1=待补充 / 2=已补充
`reject_reason`	驳回原因（见驳回原因码表）
`expected_time`	预计完成时间
`founder`	创建者 ID，0=用户自行发起，>0=运营代创建

流水关键字段（Flow）

字段	业务含义
`trans_type`	银行/交易类型代码，决定流水存入哪张分表
`amount`	实际入账金额
`currency`	币种
`en_name`	汇款人英文名，匹配引擎用来做姓名比对
`cn_name`	汇款人中文名
`customer_account`	汇款人银行账号，匹配引擎用来做卡号比对
`date`	到账日期（YYYYMMDD），匹配引擎用来做日期比对
`type`	转账类型（柜台/网银/FPS 等）
`status`	流水处理状态（0~9，见上表）
`uid`	匹配到的用户 ID，初始为 0
`apply_id`	匹配到的申请 ID，初始为 0
`abnormal`	异常标识：0=正常 / 1=异常流水

匹配关键字段（Match）

字段	业务含义
`flow_id`	关联的流水 ID
`apply_id`	关联的申请 ID
`uid`	用户 ID
`status`	匹配状态：0=待确认 / 1=已确认 / 2=已忽略

匹配表是临时表——匹配确认或入账完成后，记录会被清理以保持表大小。

数据库分片策略

入金系统涉及的核心表按以下规则分片：

表	分片规则	分片键	示例
`applys`	`uid % 100`	用户 ID	`applys_42` = uid 尾数为 42 的用户
`flows`	`{trans_type}_{YYYYMM}`	银行类型 + 月份	`flows_218_202604` = 2026年4月汇丰流水
`tasks`	`(id / 1000) % 100`	任务 ID	`tasks_05`
`setup_eddis`	不分片	—	全量存储
`hsbc_eddis` / `hs_eddis`	不分片	—	全量存储
`matches`	不分片（临时表）	—	匹配完成后定期清理

配置位置

Apply 分表逻辑：deposit/src/app/Business/Apply.php — table() 方法
Flow 分表逻辑：deposit/src/app/Business/Flow.php:80 — CREATE_WHEN_TABLE_NOT_FOUND 配置

定时任务速查

所有入金相关的 Cron 任务汇总：

匹配相关

任务名	频率	银行	关联页面
`match:ccbasia`	每 3 分钟	建银亚洲	匹配引擎
`match:ewb`	每 3 分钟	EWB	匹配引擎
`match:boc`	每 3 分钟	中银	匹配引擎
`match:hangseng`	每 3 分钟	恒生	匹配引擎
`match:hsbc`	每 3 分钟	汇丰	匹配引擎
`match:main icbc-new`	每 3 分钟	工银	匹配引擎
`match:main za-sub-account`	每 3 分钟	众安	匹配引擎

监控相关

任务名	频率	职责	关联页面
`monitor:flow-monitor`	每 30 分钟	流水堆积告警	入金排障
`abnormal-deposit:search`	每 30 分钟	孤立流水扫描	入金排障
`abnormal-deposit:update-status`	每 3 分钟	异常入金状态更新	入金排障

对账相关

任务名	频率	职责	关联页面
`bank_reconciliation:generate`	16:15 每日	当日对账报告	—
`bank_reconciliation:generate --date=yesterday USD`	09:05 每日	昨日 USD 对账	—
`crmbos_reconciliation:generate`	每小时	CRM-BOS 系统间对账	—

配置位置

所有 Cron 定义：deposit/doc/crontab.sh

银行通道类型代码（TransType）

代码	银行	类型
101	民生银证	银证
102	招行银证	银证
201	恒生银行	直连
202	工银亚洲	直连
204	民生银行	直连
205	招商银行	直连
203	交通银行 BANKCOMM	直连
206	建银亚洲	直连
207	VELO 银行	直连
208	星展银行	直连
209	ANZ 银行	直连
217	EWB 子账号	直连
218	汇丰 MT910	直连
219	渣打子账号	直连
220	新加坡工银子账户 SGICBC_SUBACC	直连
221	众安银行	直连
301	中银银企 B2E	直连
302	恒生 eDDA/eDDI（入金代扣）	eDDA
303	汇丰 eDDA/eDDI（入金代扣）	eDDA
304	天星银证	银证
401	DWOLLA	美股 Dwolla 入金
501	US_IPO	美股打新资金回流
502	INC_FT_TRANS	INC 富途资金互转

注意：eDDA（授权）和 eDDI（扣款指令）都是入金协议，不涉及出金。恒生/汇丰的出金通道是企业网银转账。

退款与冲正参考数据

冲正相关状态码

数据对象	字段	冲正相关值	含义
Apply（申请）	`status`	5	已冲正——已入账资金被撤回
Task（任务）	`status`	REVERSE	任务已冲正
Flow（流水）	`result`	3（RESULT_REFUND）	流水标记为退款（不影响证券账户）

冲正 API 端点

API	方法	用途	权限
`/deposit/reverse`	POST	单笔入金任务冲正	`CASH_IN_TASK_REVERSE`
`/deposit/batch` (action=reverse)	POST	批量入金任务冲正	`CASH_IN_TASK_REVERSE`
`/flow/refund`	POST	单笔流水退款标记	`CASH_IN_FLOW_HANDLE`
`/flow/refund-batch`	POST	批量流水退款标记	`CASH_IN_FLOW_HANDLE`
`/flow/unlock` (is_refund=1)	POST	解锁流水并标记退款	`CASH_IN_FLOW_HANDLE`

冲正前置条件速查

操作	前置状态	权限	其他要求
任务冲正	Apply.status = 2（已完成）	`CASH_IN_TASK_REVERSE`	证券账户余额 ≥ 冲正金额
流水退款	Flow.status = 0（待处理）	`CASH_IN_FLOW_HANDLE`	无
解锁退款	Flow.status = 3（已锁定）	`CASH_IN_FLOW_HANDLE`	无

冲正相关代码位置

任务冲正入口：deposit/src/app/Business/Deposit.php:877-935 — reverse()
SBA 反向编排：deposit/src/app/Business/SOA/SBA/Deposit.php:309 — turnAround('CashDepositReverse')
冲正中间件：deposit/src/app/Business/Tasks/Deposit.php:276-287 — reverseMiddleware()
流水退款：deposit/src/app/Business/BankFlow.php:674-724 — refund()
解锁退款：deposit/src/app/Business/BankFlow.php:1639-1695 — unlock()
Apply 状态常量：deposit/src/app/Business/Apply.php — STATUS_REVERSE = 5
Task 状态常量：deposit/src/app/Classes/Task/Status.php — REVERSE = 5
Flow 结果常量：deposit/src/app/Business/BankFlow.php — RESULT_REFUND = 3

完整的退款机制说明 → 退款与冲正运营操作步骤 → 冲正/退款指引

读完之后

我想...	去看
了解某条规则的业务含义	匹配与自动入账
看 eDDA 授权/扣款错误码	eDDA 代扣入金
按症状排查入金问题	入金排障
推动入金参数变更	入金变更指南
查更多术语和缩写	术语表
了解退款和冲正机制	退款与冲正

这个页面有帮助吗？

入金规则速查 ​

入金状态码 ​

申请状态（Apply Status） ​

流水状态（Flow Status） ​

匹配结果码 ​

币种与自动入账限额 ​

匹配容差规则 ​

标准容差 ​

各银行特殊容差 ​

匹配时间窗口 ​

超时与自动驳回配置 ​

自动处理时段 ​

自动入账处理时段（按币种） ​

处理时效参考 ​

各银行流水到达时效 ​

驳回原因码 ​

入金方式代码 ​

入金类型（Deposit Type） ​

通知类型 ​

核心字段说明 ​

申请关键字段（Apply） ​

流水关键字段（Flow） ​

匹配关键字段（Match） ​

数据库分片策略 ​

定时任务速查 ​

匹配相关 ​

监控相关 ​

对账相关 ​

银行通道类型代码（TransType） ​

退款与冲正参考数据 ​

冲正相关状态码 ​

冲正 API 端点 ​

冲正前置条件速查 ​

读完之后 ​