1.资金账户接口
## 1.充值
### 1.1.充值接口
#### 接口地址：
/open/api/v1/balance/recharge
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|thirdRechargeNo|第三方充值单号|String(32)|是|具有唯一性|
|mainstayId|主体ID|Integer(2)|是|根据查询商户合作信息接口获取|
|payType|账户类型|Integer(2)|否|默认为0（银行卡账户充值）详情请看下面【账户类型说明】|
|amount|打款金额|BigDecimal(11,2)|是||
|bankVoucherFile|充值银行回执单URL|String(640)|是||
|remarks|备注|String(640)|否||
#### 账户类型说明
|payType|说明|
|-|-|-|
|0|银行卡账户|
|1|支付宝账户|
|2|微信账户|
#### 接口响应参数data字段解密后的参数说明：
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|thirdRechargeNo| 第三方充值单号| String|是||
|entryAmount| 打款金额|String|是||
|rechargeAmount| 实际到账金额|String|是| 前置收费：到账金额=打款金额-合同费用；后置收费：到账金额=打款金额||
|contractTaxRate| 合同费率|String|是| ||
|contractTaxAmount| 合同费用|String|是| ||
### 1.2.充值审核回调
>d 回调参数解密请参考 [回调说明](https://easydoc.net/doc/95180784/Ry461Ra3/IVn3pmlF#nav_7)
#### 请求方式：POST
解密结果示例如下：
```json
{
"callbackType":"recharge",
"thirdRechargeNo": "xxxxx",
"auditStatus": "2",
"rechargeAmount": "12.01",
"entryAmount": "12.01",
"contractTaxAmount": "12.01",
"contractTaxRate": "xxx",
"rechargeBillNo":"xxx",
"payType":0,
"entryTime":xxx,
"failReason":"xxxx"
}
```
|参数名称| 参数含义| 数据类型|是否必有| 参数备注|
|-|-|-|-|-|
|callbackType|回调类型|String|是|固定返回：recharge|
|thirdRechargeNo| 第三方充值单号|String| 是||
|auditStatus| 充值审核状态|Integer| 是|详情请看【充值审核状态说明】|
|rechargeAmount| 实际到账金额|BigDecimal| 是||
|entryAmount| 打款金额|BigDecimal| 是||
|contractTaxRate| 合同费率|BigDecimal| 是||
|contractTaxAmount| 合同费用|BigDecimal| 是||
|rechargeBillNo| 平台充值订单号|String| 是||
|payType| 账户类型|Integer| 是|详情请看【账户类型说明】|
|entryTime| 入账时间|String| 是||
|failReason| 失败原因|String| 否||
#### 充值审核状态说明
|auditStatus|说明|
|-|-|-|
|-1|审核拒绝|
|1|审核通过|
#### 账户类型说明
|payType|说明|
|-|-|-|
|0|银行卡账户|
|1|支付宝账户|
|2|微信账户|
## 2.充值结果查询接口
#### 接口地址：
/open/api/v1/balance/rechargeResultQuery
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|thirdRechargeNo|第三方充值单号|String(32)|是|任选一个传入即可，若都传了默认使用第三方充值单号进行查询|
|rechargeBillNo|平台充值订单号|String(32)|是|任选一个传入即可，若都传了默认使用第三方充值单号进行查询|
#### 接口响应参数data字段解密后的参数说明：
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|thirdRechargeNo| 第三方充值单号|String| 是||
|auditStatus| 充值审核状态|Integer| 是|详情请看【充值审核状态说明】|
|entryAmount| 打款金额|BigDecimal| 是||
|rechargeAmount| 实际到账|BigDecimal| 是||
|contractTaxRate| 合同费率|BigDecimal| 是||
|contractTaxAmount| 合同费用|BigDecimal| 是||
|rechargeBillNo| 平台充值订单号|String| 是||
|payType| 账户类型|Integer| 是|详情请看【账户类型说明】|
|entryTime| 入账时间|Date| 是||
|failReason| 失败原因|String| 否||
#### 充值审核状态说明
|auditStatus|说明|
|-|-|-|
|-1|审核拒绝|
|1|审核通过|
#### 账户类型说明
|payType|说明|
|-|-|-|
|0|银行卡账户|
|1|支付宝账户|
|2|微信账户|
## 3.余额查询接口
#### 接口地址：
/open/api/v1/balance/query
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|mainstayId|主体id|Integer(2)|是|请参考 [查询商户合作信息接口](doc:YdC9DUA9)|
|payType|账户类型|Integer(2)|是|详情请看【账户类型说明】|
#### 账户类型说明
|payType|说明|
|-|-|-|
|0|银行卡账户|
|1|支付宝账户|
|2|微信账户|
示例：
```json
{
"mainstayId": 1,
"payType": 0
}
```
#### 接口响应参数data字段解密后的参数说明：
>d该响应参数data字段解密后为即为余额。
解密结果示例
"10.21"
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|无参数名|主体余额|BigDecimal|是||