1.资金账户
## 1.账户充值金额计算接口
#### 接口地址：
/open/api/v1/yns/balance/amountCal
>d轻税众包业务线可调用该接口进行打款金额与充值金额计算
1.轻税众包前置收费打款金额=充值金额*（1+合作费率），充值金额=账户到账金额。该模式下账户余额=个体户可到账金额。
2.轻税众包后置收费打款金额=充值金额=账户到账金额。该模式下账户余额=个体户可到账金额+合作费用。
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|参数类型|是否必填|参数备注|
|-|-|-|-|-|
|belongBusiness|所属业务线|int(3)|是|2.轻税众包业务线 4：云纳税业务线|
|mainstayId|主体|int(3)|是||
|rechargeAmount|充值金额|String(18)|选填||
|paymentAmount|打款金额|String(18)|选填|充值金额与打款金额选填一项，如果都不为空，则默认选择充值金额|
#### 响应参数说明：
|参数名称|参数含义|参数类型|是否必填|参数备注|
|-|-|-|-|-|
|paymentAmount|打款金额|String|是||
|rechargeAmount|充值金额|String|是||
## 2. 账户余额查询
>d当请求商户业务模式为直营模式时，只返回商户余额
#### 接口地址：
/open/api/v1/qs/balance/query
>d该接口无需请求参数即可查询余额。
#### 接口响应参数data字段解密后的参数说明：
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|banlance| 余额|String|是||
|payType| 账户类型|Integer|是|0：银行卡 1：支付宝|
|mainstayName| 主体名称|String|否|众包才有值|
>d该响应参数data字段解密后为即为余额。
解密结果示例
[{"banlance":"11.40","mainstayName":"安吉"}]
## 3. 账户余额充值（个体工商户众包模式）
#### 接口地址：
/open/api/v1/qs/balance/recharge
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|mainstayId|主体ID|Integer(2)|是||
|payType|账户类型|Integer(2)|否|0:银行卡 1:支付宝；不传默认为0|
|amount|打款金额|BigDecimal(11,2)|是||
|bankVoucherFile|银行打款回执单|String(640)|否|该参数为通过[1.上传文件接口](https://easydoc.net/doc/34949871/grcmeR1I/mnWkEMuT)上传将文件上传后返回的值|
|remarks|备注|String(640)|否||
|thirdRechargeNo|第三方充值单号|String(32)|是||
#### 接口响应参数data字段解密后的参数说明：
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|thirdRechargeNo| 第三方充值单号| String|是||
|entryAmount|打款金额|String|是| 前置收费显示扣除合同税费金额；后置收费显示打款金额|
|rechargeAmount|充值金额|String|是|||
|contractTaxRate| 合同税率|String|是| ||
|contractTaxAmount| 合同税费|String|是| ||
## 4.充值结果查询接口
#### 接口地址：
/open/api/v1/qs/balance/rechargeResultQuery
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|是否必填|参数备注|
|-|-|-|-|
|thirdRechargeNo|第三方充值单号|是|任选一个传入即可，若都传了默认使用第三方充值单号进行查询|
|rechargeBillNo|平台充值订单号|是|任选一个传入即可，若都传了默认使用第三方充值单号进行查询|
#### 接口响应参数data字段解密后map中的参数说明：
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|rechargeBillNo| 平台充值订单号|String| 是||
|payType| 账户类型|int| 是||
|auditStatus| 充值审核状态|int| 是|0:待审核 1:审核通过 -1:审核拒绝|
|rechargeAmount| 充值金额|BigDecimal| 是||
|thirdRechargeNo| 第三方充值单号|String| 是||
|entryAmount| 入账金额|BigDecimal| 是||
|contractTaxAmount| 合同税费|BigDecimal| 是||
|contractTaxRate| 合同税率|BigDecimal| 是||
|entryTime| 入账时间|String| 是||
|failReason| 失败原因|String| 是||
如果 data字段为空则代表未取得充值结果
## 5. 充值成功异步回调
#### 请求方式：POST
```json
{
"callbackType":"qsRecharge",
"auditStatus":"1",
"rechargeAmount":"108",
"entryAmount":"100",
"thirdRechargeNo":"chongzhi123",
"entryTime":"2020-12-12 09:23:12",
"contractTaxAmount":"8",
"contractTaxRate":"0.08",
"failReason":"xxxxx"
}
```
|参数名称| 参数含义| 数据类型|是否必有| 参数备注|
|-|-|-|-|-|
|callbackType|回调类型|String|是|固定返回：qsRecharge|
|auditStatus| 充值审核状态|Integer| 是|0:待审核 1:审核通过 -1:审核拒绝|
|rechargeAmount| 打款金额|BigDecimal| 是||
|entryAmount| 到账金额|BigDecimal| 是||
|thirdRechargeNo| 第三方充值单号|String| 是||
|entryTime| 充值时间 |String| 是||
|contractTaxAmount| 合同税费|BigDecimal| 是||
|contractTaxRate| 合同税率|BigDecimal| 是||
|failReason| 失败原因|String| 否||
## 6. 提现申请
#### 接口地址：
/open/api/v1/qs/balance/withdraw
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|mainstayId|主体ID|Integer|众包必填，直营无效|1-安吉 2-长兴 3-乐清|
|amount|提现金额|BigDecimal|是|两位小数|
|bankNo|收款账号|String|众包必填，直营无效|最长256字符|
|accountName|账户名称|String|众包必填，直营无效|最长256字符|
|bankName|开户行|String|众包必填，直营无效|最长256字符|
|payType|账号类型|Integer|是|0-银行卡 1-支付宝|
|thirdOrderNo|第三方提现单号|String|是|最长32字符|
|remark|备注|String|否|最长256字符|
#### 接口响应参数data字段解密后的参数说明：
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|thirdOrderNo| 第三方提现单号| String|是||
|amount| 提现金额|BigDecimal|是||
|realAmount| 到账金额|BigDecimal|是| ||
|status| 状态|Integer|是| -100-待审核 0-提现中 1-提现成功 -1-提现失败||
## 7. 提现异步回调
#### 请求方式：POST
````json
{
"callbackType":"qsWithdrawResult",
"thirdOrderNo":"tixian123",
"amount":"100",
"realAmount":"108",
"status":"1",
"returnMsg":"",
"url":"https://xxx.xxx.xxx/xxxxx.png",
"payType":"0",
"mainstayId":"1"
}
````
|参数名称| 参数含义| 数据类型|是否必有| 参数备注|
|-|-|-|-|-|
|callbackType|回调类型|String|是|固定返回：qsWithdrawResult|
|thirdOrderNo| 第三方提现单号| String|是||
|amount| 提现金额|BigDecimal|是||
|realAmount| 到账金额|BigDecimal|是| ||
|status| 状态|Integer|是| -100-待审核 0-提现中 1-提现成功 -1-提现失败||
|returnMsg| 提现失败原因| String|否|提现失败时有|
|url| 打款凭证url| String|否||
|payType|账号类型|Integer|是|0-银行卡 1-支付宝|
|mainstayId|主体ID|Integer|是|-100-直营 1-安吉 2-长兴 3-乐清|
## 8. 提现记录查询
#### 接口地址：
/open/api/v1/qs/balance/withdraw/query
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|thirdOrderNo|第三方提现单号|String（32）|是||
#### 接口响应参数data字段解密后的参数说明：
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|thirdOrderNo| 第三方提现单号| String|是||
|amount| 提现金额|BigDecimal|是||
|realAmount| 到账金额|BigDecimal|是| ||
|status| 状态|Integer|是| -100-待审核 0-提现中 1-提现成功 -1-提现失败||
|returnMsg| 提现失败原因| String|否|提现失败时有|
|url| 打款凭证url| String|否||
|payType|账号类型|Integer|是|0-银行卡 1-支付宝|
|mainstayId|主体ID|Integer|是|-100-直营 1-安吉 2-长兴 3-乐清|