入金規則速查

本頁說明

講什麼：入金相關的所有參考數據——狀態碼、限額、容差、時效、字段含義。本頁是唯一信源，其他頁面引用而非重複 適合誰：需要查詢具體數字/代碼的產品經理和運營人員 前置閱讀：無，隨時查閱 預計閱讀：查閱型，按需搜索 負責人：入金產品經理

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

查某個狀態碼什麼意思？→ 入金狀態碼
查某銀行的匹配容差？→ 匹配容差規則
查某銀行的 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 端點 ​

沖正前置條件速查 ​

讀完之後 ​