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