确认式结算接口

## 确认式结算接口 说明:确认式结算接口为商户提供订单前置信息校验,商户可通过前置调用提交接口验证该笔订单是否可结算,同时商户可对提交后校验成功订单做二次审核后,决定是否继续执行资金结算。 #### 调用时序图 ![image.png](https://cos.easydoc.net/74722269/files/kywkyw3j.png) ### 1.1 结算单提交接口 #### 接口地址: /open/api/v1/lw/bill/submitBill #### 请求方式:POST #### 请求参数说明: |参数名称|参数含义|数据类型|是否必填|参数备注| |-|-|-|-|-| |payeeName|收款人姓名|String|是|| |payeeIdCard|收款人身份证号码|String|是|| |payType|账户类型|int|否|0:银行账户1:支付宝账户| |payeeAccount|收款账号|String|是|| |amount |收款金额|String|是|收款金额必须为数字| |payeePhone|收款人手机号|String|否|该参数用于用户接收到款短信| |thirdOrderId|商户订单号|String|是|商户自己生成,不可重复提交| |thirdBizOrderId|第三方业务订单ID|String|否|该参数为商户自己的业务订单号,通过该订单号能够查询该笔金额来源明细| |mainstayId|主体ID|Long|是|该参数值可通过《[查询企业合作主体,发票类目等信息](https://easydoc.net/doc/64606353/WRXJG4oL/lH8xS88b#nav_0)》查询| |invoiceCode|发票编码|String|是|该参数值可通过《[查询企业合作主体,发票类目等信息](https://easydoc.net/doc/64606353/WRXJG4oL/lH8xS88b#nav_0)》查询| |remark|备注|String|否|备注字数不可超过32个字符| |transName|转账备注|String|否|备注字数不可超过20个字符| #### 接口响应参数data字段解密后的参数说明: |参数名称| 参数含义| 数据类型| 是否必有| 参数备注| |-|-|-|-|-| |billNo| 订单号|String|是|| |actualAmount| 结算金额|BigDecimal|是|个体户实际到账金额| |valueAddedTaxAmount|增值税|BigDecimal|是|| |additionalTaxAmount|附加税|BigDecimal|是|| |personIncomeTaxAmount|个税|BigDecimal|是|| |contractTaxAmount|服务费(合同税费)|BigDecimal|是|| |paymentAmount|实际打款金额(需要扣除的费用)|BigDecimal|是|| |itemStatus| SSC平台订单状态|Integer|是|[结算结果状态码](https://easydoc.net/doc/95180784/Ry461Ra3/g5SDIGDl) |failReason|失败原因|String|否| ### 结算单确认结算接口 #### 接口地址: /open/api/v1/lw/bill/sureGrant #### 请求方式:POST #### 请求参数说明: |参数名称|参数含义|数据类型|是否必填|参数备注| |-|-|-|-|-| |billNo|订单号|String|是|该值由提交订单接口返回| |settlementCertUrl|结算证明|String|否|url链接| #### 接口响应参数data字段解密后的参数说明: |参数名称| 参数含义|数据类型| 是否必有| 参数备注| |-|-|-|-|-| |thirdOrderNo| 第三方订单号|String| 是|生成订单接口的thirdOrderId字段的值| |billNo| 订单号|String|是| || |itemStatus| 结算结果状态|int| 是|详情请参考[结算结果状态码](https://easydoc.net/doc/95180784/Ry461Ra3/g5SDIGDl)| |returnMsg|失败原因|String|否||