1.资金账户接口
## 1.余额查询接口
#### 接口地址:
/open/api/v1/balance/query
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|是否必填|参数备注|
|-|-|-|-|
|mainstayId|主体id|是|对应要查询某个主体的ID|
|payType|支付类型|是|详情请看[支付类型码](doc:nD2opxYu)|
>d ◆填写主体名称:
示例:
String data = {"mainstayId":"1","payType":"0"};
#### 接口响应参数data字段解密后的参数说明:
|参数名称| 参数含义| 是否必有| 参数备注|
|-|-|-|-|
>d该响应参数data字段解密后为即为余额。
解密结果示例
"10.21"
## 2.1 充值接口
#### 接口地址:
/open/api/v1/balance/recharge
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|是否必填|参数备注|
|-|-|-|-|
|mainstayId|主体ID|是||
|payType|支付类型|否|0:银行卡账户 1:支付宝账户。默认为0(银行卡账户充值)|
|amount|充值金额|是||
|bankVoucherFile|充值银行回执单|是|该参数为通过[11.上传文件接口](doc:tqGD889B)将文件上传后返回的值|
|remarks|备注|否||
|thirdRechargeNo|第三方充值单号|是||
#### 接口响应参数data字段解密后的参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|thirdRechargeNo| 第三方充值单号| String|是||
|entryAmount| 打款金额|String|是||
|rechargeAmount| 实际充值到账金额(扣除税费)|String|是| ||
|contractTaxRate| 税率|String|是| ||
|contractTaxAmount| 税费|String|是| ||
## 2.2 充值成功回调
>d 该接口需要第三方自行编写提供接口到SSC平台回调成功必须返回success不然会重复回调 接口编写示例跟9.签约回调接口说明一致
#### 请求方式:POST
解密结果示例如下:
```json
{"auditStatus":"2","rechargeAmount":"12.01","thirdRechargeNo":"xxxxx","entryAmount":"12.01","contractTaxAmount":"12.01","contractTaxRate":"xxx"}";
```
|参数名称| 参数含义| 数据类型|是否必有| 参数备注|
|-|-|-|-|-|
|auditStatus| 充值审核状态|int| 是||
|rechargeAmount| 充值金额|BigDecimal| 是||
|thirdRechargeNo| 第三方充值单号|String| 是||
|entryAmount| 入账金额|BigDecimal| 是||
|contractTaxAmount| 合同税费|BigDecimal| 是||
|contractTaxRate| 合同税率|BigDecimal| 是||
## 3.充值结果查询接口
#### 接口地址:
/open/api/v1/balance/rechargeResultQuery
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|是否必填|参数备注|
|-|-|-|-|
|thirdRechargeNo|第三方充值单号|是||
#### 接口响应参数data字段解密后map中的参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|auditStatus| 充值审核状态|int| 是||
|rechargeAmount| 充值金额|BigDecimal| 是||
|thirdRechargeNo| 第三方充值单号|String| 是||
|entryAmount| 入账金额|BigDecimal| 是||
|contractTaxAmount| 合同税费|BigDecimal| 是||
|contractTaxRate| 合同税率|BigDecimal| 是||
如果 data字段为空则代表未取得充值结果
## 4.入金成功回调
>d 该接口需要第三方自行编写提供接口到SSC平台回调成功必须返回success不然会重复回调 接口编写示例跟9.签约回调接口说明一致
#### 请求方式:POST
解密结果示例如下:
```json
{"thirdRechargeNo":"xxxxx","rechargeAmount":"12.01","entryAmount":"10.01"}";
```
|参数名称| 参数含义| 是否必有| 参数备注|
|-|-|-|-|
|thirdRechargeNo| 充值订单号| 是|该充值订单号由双方约定规则前缀,否则不进行回调|
|rechargeAmount| 商户实际充值的金额| 是|商户实际充值了多少钱|
|entryAmount| 入金金额| 是|平台入金金额|