PC端生成扫码支付页面API

请求地址

生产环境
https://netpay.cmbchina.com/netpayment/BaseHttp.dll?PC_EUserPay

测试环境
http://netpay.netpay.bas.cmburl.cn:801/netpayment/BaseHttp.dll?PC_EUserPay

请求报文

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

请求示例

1.json报文组织:

{
    "version":"1.0",
    "charset":"UTF-8",
    "sign":"见签名处理章节",
    "signType":"SHA-256",
    "reqData":{
        "dateTime":"20161209112230",
        "branchNo":"0755",
        "merchantNo":"000054",
        "date":"20161209",
        "orderNo":"9999000001",
        "amount":"0.01",
        "expireTimeSpan":"30",
        "payNoticeUrl":"http://www.merchant.com/path/payNotice.do",
        "payNoticePara":"12345678|ABCDEFG|HIJKLM",
        "productDesc":"商品描述",
        "returnUrl":"http://www.merchant.com/path/return.do",
        "clientIP":"99.12.38.165",
        "cardType":"A",
        "agrNo":"12345678901234567890",
        "merchantSerialNo":"2016062014308888",
        "userID":"2016062388888",
        "mobile":"18202532653",
        "riskLevel":"",
        "signNoticeUrl":"http://www.merchant.com/path/signNotice.do",
        "signNoticePara":"12345678|ABCDEFG|HIJKLM",
        " encrypData":
        "FC7788996853803BB6981F406BA84939CE96B8D57FFB20B653078B181FA9691D7CFF00D1D3EF21E6B338A3FD33690CAF12078BE885BB49F6016CF5A0314D21BF49738629F8386CB437A76A8DBE1E7E932DBDB18B7C69A8D10900FB8A3C98CB48833B5800A541DD6B5A12F65508C3BCD1D51B32DD02CCE362BB5CE4D95E5D29921E603BBE3CA5B650652589011304CC2969E2A1046F91A1849B70001FE23EA8592560BE4FB7994D51BC7E7F5F5E08474F7090A44D635F2BFD7353B081DF80613817FD357CD472392A2EFEB1DA52D72DADD3BD5725FE42FA9D4B19",
        "encrypType":"RC4"
        "userAuthType":"A",
        "userAuthInfo":"111222333"
    }
}

2.表单组织：

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

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

agrNo=12345678901234567890&amount=0.01&branchNo=0755&cardType=A&clientIP=99.12.38.165&date=20161209&dateTime=20161209112230&encrypData=FC7788996853803BB6981F406BA84939CE96B8D57FFB20B653078B181FA9691D7CFF00D1D3EF21E6B338A3FD33690CAF12078BE885BB49F6016CF5A0314D21BF49738629F8386CB437A76A8DBE1E7E932DBDB18B7C69A8D10900FB8A3C98CB48833B5800A541DD6B5A12F65508C3BCD1D51B32DD02CCE362BB5CE4D95E5D29921E603BBE3CA5B650652589011304CC2969E2A1046F91A1849B70001FE23EA8592560BE4FB7994D51BC7E7F5F5E08474F7090A44D635F2BFD7353B081DF80613817FD357CD472392A2EFEB1DA52D72DADD3BD5725FE42FA9D4B19&encrypType=RC4&expireTimeSpan=30&merchantNo=000054&merchantSerialNo=20161209112230&mobile=18202532653&orderNo=9999000001&payNoticePara=12345678|ABCDEFG|HIJKLM&payNoticeUrl=http://www.merchant.com/path/WAPProcResult.dll&returnUrl=http://www.merchant.com/path/return.do&riskLevel=&signNoticePara=12345678|ABCDEFG|HIJKLM&signNoticeUrl=http://www.merchant.com/path/signNotice.do&userID=2016062388888

4.扩展信息

扩展信息（encrypData）用于商户上送一些订单信息、用户信息。 json格式写入扩展信息，并使用encrypType指定的算法加密

a)扩展信息字段可以传的参数

1)扩展信息字段的使用说明

json格式写入扩展信息，并使用encrypType指定的算法加密。加密算法如下：

首先将需传入的风控参数拼接成json，再使用RC4或DES加密生成16进制的字符串即为encrypData字段。encrypType取值为RC4时，密钥为商户支付密钥；取值为DES时，密钥为商户支付密钥的前8位，不足8位则右补0。RC4与DES算法参考附录中的RC4代码示例和DES代码示例。

响应报文

网页直接展示结果，无响应报文。
签约成功和支付成功后有异步结果通知，失败无通知。

错误码

FAQ

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

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