账户管理
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列表
| 类型 | 功能 | 描述 |
|---|---|---|
| 应用程序接口 | 子账户开通配置 | 创建新的子账户并进行结算、取现配置 |
| 应用程序接口 | 修改子账户配置 | 修改子账户及配置 |
| 应用程序接口 | 账户余额信息查询接口 | 商户所有子账户的余额查询 |
| 应用程序接口 | 账务流水查询 | 查询商户下指定账户的账务流水 |
