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": "" }, ... ] ```