客户主动补缴未完成订单

1. 接口介绍

功能简述：

本接口用于商户对客户未完成的订单发起主动补缴交易请求。

约束条件：

1、已调用信用能力查询接口，canPay字段返回C
2、已调用未完成订单查询接口，获取到客户存在未完成订单

2. 请求地址

从商户APP跳转招行APP进行主动补缴，请参考：

http://openhome.cmbchina.com/PayNew/pay/doc/cell/app/SDKPayAPI

从H5或微信公众号进行主动补缴，请参考：

http://openhome.cmbchina.com/PayNew/pay/doc/cell/H5/OneCardPayAPI

从招行APP内的商户小程序进行主动补缴，请参考：

http://openhome.cmbchina.com/PayNew/pay/doc/cell/xcx/OneNetPay

3. 请求报文

请参考第2小节相关地址。应注意：支付接口上送的分行号、商户号、订单号、订单日期、订单金额，必须与“未完成订单交易查询接口”返回的信息一致。

4. 还款结果异步通知

对应第2小节接口，从商户APP跳转招行APP进行主动补缴，异步通知请参考：

http://openhome.cmbchina.com/PayNew/pay/doc/cell/app/SuccessPayResAPI

从H5或微信公众号进行主动补缴，异步通知请参考：

http://openhome.cmbchina.com/PayNew/pay/doc/cell/H5/SuccessPayAPI

从招行APP内的商户小程序进行主动补缴，异步通知请参考：

http://openhome.cmbchina.com/PayNew/pay/doc/cell/xcx/SuccessPayAPI

5. 还款交易状态查询

如果商户未收单还款结果异步通知或发生其他异常情况，需要调用查询接口确认交易状态，请参考以下查询接口。

5.1 约束条件：

1、已调用第2节主动补缴接口
2、查询结果仅代表主动补缴交易是否成功，不代表原免密保付交易的结果（原免密保付交易的状态可根据交易状态查询接口确认）

5.2 请求地址：

生产地址：https://merchserv.netpay.cmbchina.com/merchserv/QueryPayBackOrder.do

测试地址：http://paytest.cmburl.cn:801/netpayment_directlink_nosession/QueryPayBackOrder.do

5.3 请求报文：

报文的参数名：jsonRequestData，参数值JSON格式见下表

• 请求示例

1）json报文组织:

{
    "version":"2.0",
    "charset":"UTF-8",
    "sign":"见签名处理章节",
    "signType":"SHA-256",
    "reqData":
    {
        "dateTime":"20201218162921",
        "branchNo":"0755",
        "merchantNo":"000054",
        "date":"20200905",
        "orderNo":"69579144761325"
    }
}

2）表单组织：

<form action="请求地址" method="post">
    <input type="hidden" name="jsonRequestData" value='以上json字符串' />
    <input type="hidden" name="charset" value=’utf-8’ />
</form>

3）待签名字符串示例（未包含支付密钥）：

branchNo=0755&date=20200905&dateTime=20201218162921&merchantNo=000054&orderNo=69579144761325

5.4 响应报文：

提示：

1）查询接口返回的结果中，rspCode=‘SUC0000’且orderStatus=‘020’，代表该笔订单处理成功且已经结账。

2）如果收到orderStatus=‘029’，请继续查询。若轮询时长超出“expireTimeSpan(订单过期时间跨度)+1分钟”，orderStatus仍返回‘029’，则联机可先判断订单支付失败。

3）商户侧应具备T+1对账的机制，来识别处理T日可能出现的差错交易。

• 响应示例

1）正常json报文组织:

{
    "version":"2.0",
    "charset":"UTF-8",
    "sign":"见签名处理章节",
    "signType":"SHA-256",
    "rspData":
    {
        "rspCode":"SUC0000",
        "rspMsg":"",
        "dateTime":"20201218162225",
        "branchNo":"0755",
        "merchantNo":"000054",
        "date":"20200905",
        "orderNo":"69579144761325",
        "bankSerialNo":"115TT09A030D5600000A",
        "currency":"10",
        "orderAmount":"5.6",
        "fee":"0.17",
        "bankDate":"20200905",
        "bankTime":"215626",
        "settleAmount":"5.6",
        "discountAmount":"0",
        "orderStatus":"020",
        "settleDate":"20200905",
        "settleTime":"215626",
        "cardType":"02",
        "merchantPara":"para1"
    }
}

2）异常json报文组织：

{
    "version":"2.0",
    "charset":"UTF-8",
    "sign":"见签名处理章节",
    "signType":"SHA-256",
    "rspData":
    {
        "rspCode":"MSS1068",
        "rspMsg":"NP1068.结束日期格式错误"
    }
}

5.5 错误码：