1.结算提交确认接口
## 1. 结算提交确认接口
备注:已合并通用版接口(提交订单接口、确认结算接口),
#### 接口地址:
/open/api/v1/bill/payment
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义| 数据类型|是否必填|参数备注|
|-|-|-|-|-|
|payeeName|收款人姓名|String(32)|是||
|payeeIdCard|收款人身份证号码|String(18)|是||
|payType|支付类型|Integer(2)|是|支付类型该参数值填写支付类型对应数字即可 0:银行卡 1:支付宝 2:微信|
|payeeAccount|收款账户|String(128)|是||
|amount |收款金额|BigDecimal(10,2)|是|精度:小数点后两位|
|payeePhone|收款人手机号|String(16)|否|该参数用于用户接收到款短信|
|payeeBankName|收款账户开户银行|String(128)|否||
|payeeBankNo|收款账户开户银行联行号|String(30)|否||
|thirdOrderId|商户订单号|String(32)|是|商户自己生成,不可重复提交|
|thirdBizOrderId|第三方业务订单ID|String(32)|否|该参数为商户自己的业务订单号,通过该订单号能够查询该笔金额来源明细|
|transName|转账备注|String(20)|否||
|mainstayId|主体ID|Integer(2)|是|该参数由 [3.查询商户可开票列表,以及所拥有的主体接口](https://easydoc.net/doc/55505654/xSIWuyII/AcWriNWG) 可获得|
|invoiceCode|发票编码|String(64)|是|该参数由 [3.查询商户可开票列表,以及所拥有的主体接口](https://easydoc.net/doc/55505654/xSIWuyII/AcWriNWG) 可获得|
|remark|拓展字段|String(255)|否|商户备注字段|
|extStatus|拓展状态|String(32)|否|特殊意义字段 restrictPay:限制支付。可根据不同对方双方协定自定义该字段值|
|extNeedCallBack|拓展状态|String(2)|否|特殊意义字段 1:需要回调,0:不需要回调|
#### 接口响应参数data字段解密后的参数说明:
|参数名称| 参数含义| 数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|thirdOrderNo| 商户提交时的订单号|String| 是||
|transNo|交易号|String| 是||
|checkStatus| 检测状态 |Integer|是|-1:检测失败 1:检测成功|
|errorCode|失败编码|String|否|失败时返回|
|reason|失败原因|String|否||
|remark|拓展字段|String|否|商户备注字段|
## 2. 结算结果异步回调
>d 该接口需要第三方自行编写提供接口到SSC平台回调成功必须返回success不然会重复回调
#### 请求方式:POST
解密结果示例如下:
```json
{
"itemStatus": "2",
"amount": "12.01",
"thirdOrderNo": "xxxxx",
"transNo": "xxxx",
"paymentTime": "2019-07-05 23:41:45",
"reason": "",
"errorCode": "",
"remark": ""
}
```
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|itemStatus| 订单状态|String| 是|2结算成功 -1结算失败 |
|amount| 结算的金额|String| 是|实际结算的金额|
|thirdOrderNo| 结算订单号|String| 是||
|transNo|交易号|String| 是||
|paymentTime| 结算时间|String| 是||
|errorCode|失败编码|String|否|失败时返回|
|reason|失败原因|String| 否||
|remark|拓展字段|String|否|商户备注字段|
## 3. 结算结果查询接口
#### 接口地址:
/open/api/v1/bill/queryResult
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|是否必填|参数备注|
|-|-|-|-|
|无参数名称|需要查询的商户订单号|是|最多查询10条记录|
>d 该接口参数无需参数名称只需将商户订单号拼接处json数组即可
示例:String data = [\"orderNo1\",\"orderNo2\"... ,\"orderNo10\"];
未加密请求参数示例如下:
```json
[
"order11111",
"order22222"
]
```
#### 接口响应参数data字段解密后的参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|thirdOrderNo| 结算订单号|String| 是||
|transNo|交易号|String| 是||
|itemStatus| 订单状态|Integer| 是|0等待结算 1正在结算 2结算成功 -1结算失败 -2转账退款 -3结算终止 -4 格式检查失败|
|paymentTime| 结算时间|String| 否|结算成功返回|
|errorCode|失败编码|String|否|失败时返回|
|reason| 失败原因|String| 否||
|remark|拓展字段|String|否|商户备注字段|
解密结果示例如下:
```json
[
{
"itemStatus": 2,
"thirdOrderNo": "xxxxx",
"transNo":"xxxx",
"paymentTime": "2019-07-05 23:41:45",
"errorCode":"",
"reason": "",
"remark": ""
},
...
]
```