账户管理

1. 产品介绍

1.1 简介

斗拱系统中的主体支持多种类型的账户：

• 基本户：进件成功后默认创建，用于收款、充值、支付手续费扣收、转账、代发等；基本户是唯一的。
• 现金户：用于收款，现金户可以创建多个。适用于不同业务场景下有收支分离要求时专户专用。
• 延时户：内部使用，主要用于延时交易时资金的过度。由系统自动管理只能查询余额不能主动操作。
• 充值户：用于接收充值资金，可作为支付手续费扣款账户。
• 营销户：渠道、平台通过控台将资金充值到营销户，用于补贴下属商户的交易；
• 个人支付账户：个人钱包功能专用；

斗拱支持渠道、商户主动创建多个现金户，其余账户类型在开通相关业务时会自动创建。

1.2 应用场景

• 为支持延时交易、收支分离、代发、补贴支付、余额支付、个人钱包等各类业务场景创建各类账户。
• 可以调用接口创建多个现金户用于不同场景的收款，满足收支分离的需求；
• 支持查询账户余额方便对各类资金，包括延时户中的在途资金进行管理；
• 支持控台充值、转账方便各类资金进行划拨；

2. 接入前准备

第一步：密钥获取

联调之前需要先获取公私钥，参见公私解钥参数获取说明；

第二步：公共参数获取

登录服务商/商户控台后，可在开发设置-开发者信息中，获取sys_id，product_id参数信息;（如控台未展示，请联系对接群内汇付技术助手提供）

3. 开发指引

3.1 对接规范

调用汇付接口，均采取POST形式提交，数据格式统一为JSON格式，相关SDK及签名方法见链接：

SDK示例：Java 开发工具包

加签验签：v2版接口加签验签

3.2 系统接口

3.2.1 子账户开通配置

入参需关注以下域字段：

返参需关注以下字段：

注意：结算卡的修改会发短信验证码给原结算卡持有人；

3.2.2 修改子账户配置

入参关注以下字段：

注意：结算卡的修改会发短信验证码给原结算卡持有人；

3.2.3 账户余额信息查询

返参需关注以下域字段：

3.2.4 账务流水查询

入参关注以下字段：

返参需关注以下域字段：

注：当前每天可以查询出的账务流水记录不超过10000笔。

4. API列表

5.常见问题