賬戶管理
1. 產品介紹
1.1 簡介
斗拱系統中的主體支持多種類型的賬戶：
- 基本戶：進件成功后默認創建，用于收款、充值、支付手續費扣收、轉賬、代發等；基本戶是唯一的。
- 現金戶：用于收款，現金戶可以創建多個。適用于不同業務場景下有收支分離要求時專戶專用。
- 延時戶：內部使用，主要用于延時交易時資金的過度。由系統自動管理只能查詢余額不能主動操作。
- 充值戶：用于接收充值資金，可作為支付手續費扣款賬戶。
- 營銷戶：渠道、平臺通過控臺將資金充值到營銷戶，用于補貼下屬商戶的交易；
- 個人支付賬戶：個人錢包功能專用；
斗拱支持渠道、商戶主動創建多個現金戶，其余賬戶類型在開通相關業務時會自動創建。
1.2 應用場景
- 為支持延時交易、收支分離、代發、補貼支付、余額支付、個人錢包等各類業務場景創建各類賬戶。
- 可以調用接口創建多個現金戶用于不同場景的收款，滿足收支分離的需求；
- 支持查詢賬戶余額方便對各類資金，包括延時戶中的在途資金進行管理；
- 支持控臺充值、轉賬方便各類資金進行劃撥；
2. 接入前準備
第一步：密鑰獲取
聯調之前需要先獲取公私鑰，參見公私解鑰參數獲取說明；
第二步：公共參數獲取
登錄服務商/商戶控臺后，可在開發設置-開發者信息中，獲取sys_id，product_id參數信息;（如控臺未展示，請聯系對接群內匯付技術助手提供）
3. 開發指引
3.1 對接規范
調用匯付接口，均采取POST形式提交，數據格式統一為JSON格式，相關SDK及簽名方法見鏈接：
SDK示例：Java 開發工具包
加簽驗簽：v2版接口加簽驗簽
3.2 系統接口
3.2.1 子賬戶開通配置
入參需關注以下域字段：
| 參數 | 中文名 | 說明 |
|---|---|---|
| huifu_id | 商戶/用戶匯付Id | 新賬戶歸屬主體 |
| acct_type | 子賬戶類型 | 02:現金戶；目前只支持接口創建現金戶 |
| acct_name | 賬戶名稱 | 自定義賬戶名稱 |
| card_info | 結算卡信息配置 | jsonObject格式。新賬戶綁定的結算銀行賬戶。支持每個賬戶可以配置獨立的結算銀行賬戶 |
| settle_config | 結算規則配置 | jsonObject格式。商戶結算規則配置 |
| cash_config | 取現信息配置 | 商戶取現信息配置，jsonArray格式； |
返參需關注以下字段：
| 參數 | 中文名 | 說明 |
|---|---|---|
| acct_id | 子賬戶號 | 新生成的子賬戶號 |
| token_no | 綁卡序列號 | 綁定結算銀行賬戶的ID號 |
注意：結算卡的修改會發短信驗證碼給原結算卡持有人；
3.2.2 修改子賬戶配置
入參關注以下字段：
| 參數 | 中文名 | 說明 |
|---|---|---|
| huifu_id | 商戶/用戶匯付Id | 新賬戶歸屬主體 |
| acct_id | 子賬戶號 | 要修改的子賬戶號 |
| card_info | 結算卡信息配置 | jsonObject格式。新賬戶綁定的結算銀行賬戶。支持每個賬戶可以配置獨立的結算銀行賬戶 |
| settle_config | 結算規則配置 | jsonObject格式。商戶結算規則配置 |
| cash_config | 取現信息配置 | 商戶取現信息配置，jsonArray格式; |
注意：結算卡的修改會發短信驗證碼給原結算卡持有人；
3.2.3 賬戶余額信息查詢
返參需關注以下域字段：
| 參數 | 中文名 | 說明 |
|---|---|---|
| acctInfo_list | 賬戶信息列表 | JsonArray格式;各子賬戶余額信息 |
3.2.4 賬務流水查詢
入參關注以下字段：
| 參數 | 中文名 | 說明 |
|---|---|---|
| acct_id | 子賬戶號 | 指定要查的賬戶號 |
返參需關注以下域字段：
| 參數 | 中文名 | 說明 |
|---|---|---|
| acct_log_list | 賬務流水列表 | JsonArray格式 |
注：當前每天可以查詢出的賬務流水記錄不超過10000筆。
4. API列表
| 類型 | 功能 | 描述 |
|---|---|---|
| 應用程序接口 | 子賬戶開通配置 | 創建新的子賬戶并進行結算、取現配置 |
| 應用程序接口 | 修改子賬戶配置 | 修改子賬戶及配置 |
| 應用程序接口 | 賬戶余額信息查詢接口 | 商戶所有子賬戶的余額查詢 |
| 應用程序接口 | 賬務流水查詢 | 查詢商戶下指定賬戶的賬務流水 |
