签订支付协议（生成PC页面签约二维码）

1. 接口介绍

功能简述：

商户调用接口生成PC网页端的签约二维码

应用场景：

1、 客户在招行侧未签订免密支付协议，商户调用该接口发起PC端的签约请求。
2、 调用该接口成功后，客户进入招行PC端免密签约页面，使用手机扫码进入签约流程，签约成功后商户侧收到“支付协议签订回调通知”。

约束条件：

1、秘钥及表单提交地址，商户需通过配置管理，方便后续调整。

正常流程：

1、用户在商户PC网页点击按钮，跳转到招行免密签约页面
2、用户使用招行APP，或微信/支付宝/手机浏览器扫码网页中的二维码，进入相应的手机端签约流程
3、用户信息校验通过后，正常签约成功

异常流程:

1、商户请求参数信息校验不通过，PC前端界面报错，签约流程停止
2、用户在二维码有效期内（20分钟），未使用手机扫码进入签约流程
3、30分钟后，招行仍未接收到用户提交签约，则该笔签约请求失效

2. 请求地址

测试环境URL：

http://netpay.netpay.bas.cmburl.cn:801/netpayment/BaseHttp.dll?PC_NPSign

生产环境URL：

https://netpay.cmbchina.com/netpayment/BaseHttp.dll?PC_NPSign

3. 请求报文

jsonRequestData参数定义

请求示例：

json报文组织：

{   
    "version":"1.0",   
    "charset":"UTF-8",   
    "sign":"见签名处理章节",   
    "signType":"SHA-256",   
    "reqData":{        
        "agrNo":"201606238888888",        
        "branchNo":"0755",        
        "dateTime":"20160623101430",        
        "lat":"30.949505",        
        "lon":"50.949506",        
        "merchantNo":"123456",        
        "merchantSerialNo":"2016062310143088",        
        "mobile":"13888888888",        
        "noticePara":"",        
        "noticeUrl":"http://www.xxx.com/xxx",        
        "returnUrl":"http://www.xxx.com/yyy",        
        "riskLevel":"3",        
        "userID":"2016062388888"        
        }   
}

表单组织：

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

待签名字符串(未包含支付密钥)：

agrNo=201606238888888&branchNo=0755&dateTime=20160623101430&lat=30.949505&lon=50.949506&merchantNo=123456&merchantSerialNo=2016062310143088&mobile=13888888888&noticePara=&noticeUrl=http://www.xxx.com/xxx&returnUrl=http://www.xxx.com/yyy&riskLevel=3&userID=2016062388888

4. 响应报文

1、前端直接展示请求参数和环境类的错误码，此时无响应报文和异步回调通知。商户可调用查询协议接口确认结果。
2、客户签约失败，商户后端收到签订协议失败的异步通知。
3、客户签约成功，PC网页端跳转成签约成功页面，商户后端收到签订协议成功的异步通知。

5. 错误码

以下错误码为前端的报错：

6. FAQ

Q1. 招商银行PC页面签约二维码的有效期有多久？
用户进入招行PC签约页面，二维码有效期开始倒计时，剩余有效时间为“商户发起该请求的时间(datetime)”+ 20分钟 -“招行接收商户请求时的系统时间”。

Q2. 商户如果一直没有接收到回调通知，应该怎么处理？
如果用户一直未扫码，或未确认提交签约请求给招行，即招行签约系统未处理该签约，则不会主动给商户发送回调通知。商户从datetime开始，可通过定时任务调用“查询协议API”确认协议状态，如果超过30分钟后仍未查询到协议成功，则可认为该笔签约失败。之后请使用相同的协议号重新发起签约。

Q3. 开通用户身份验证和银行卡校验是什么功能？
商户侧已收集客户的实名信息和银行卡号，如果需要校验招行侧签约客户与商户侧为同一个人，则需联系招行业务人员，在商户管理系统开通“实名认证”，并在请求报文中上送“merchantUserIdType、merchantUserIdNo、merchantUserName”；如果需要校验校验招行侧签约客户与商户侧为同一个人，且只能使用商户侧预留银行卡进行签约，则需联系招行业务人员，在商户管理系统开通“实名认证”，并在请求报文中上送“merchantUserIdType、merchantUserIdNo、merchantUserName、merchantCardType、merchantCardNo”。