签约API

请求地址

生产环境
https://mobile.cmbchina.com/mobilehtml/DebitCard/M_NetPay/OneNetRegister/NP_BindCard.aspx

测试环境
http://121.15.180.66:801/mobilehtml/DebitCard/M_NetPay/OneNetRegister/NP_BindCard.aspx

请求报文

报文的参数名:jsonRequestData,参数值JSON格式见下表

参数 类型(长度) 必填 描述 示例
version String(3) M 接口版本号,固定为”1.0” 1.0
charset String(8) M 参数编码,固定为“UTF-8” UTF-8
sign String M 报文签名,对reqData内的数据进行签名
signType String M 签名算法,固定为“SHA-256” SHA-256
reqData 请求数据
dateTime String(14) M 请求时间,商户发起该请求的当前时间,精确到秒。
格式:yyyyMMddHHmmss
20160623101430
merchantSerialNo String(20) M 协议开通请求流水号,商户生成,同一交易日期唯一,长度不超过20位,数字字母都可以,建议纯数字 2016062310143088
agrNo String(32) M 客户协议号。不超过32位的数字字母组合。未签约(首次支付)客户,填写新协议号,用于协议开通;已签约(再次支付)客户,填写该客户已有的协议号。商户必须对协议号进行管理,确保客户与协议号一一对应。 201606238888888
branchNo String(4) M 商户分行号,4位数字 0755
merchantNo String(6) M 商户号,6位数字 123456
mobile String(30) O 商户用户的手机号 13888888888
userID String(20) O 用于标识商户用户的唯一ID。
商户系统内用户唯一标识,不超过20位,数字字母都可以,建议纯数字
lon String(20) O 经度,商户app获取的手机定位数据 30.949505
lat String(20) O 纬度,商户app获取的手机定位数据 50.949506
riskLevel String(4) O 用户在商户系统内风险等级标识
noticeUrl String(256) M 商户接收成功签约结果通知的地址。 http://www.xxx.com/xxx
noticePara String(256) O 该参数在发送成功签约结果通知时,将原样返回商户
注意:该参数可为空,商户如果需要不止一个参数,可以自行把参数组合、拼装,但组合后的结果不能带有‘&’字符。
returnUrl String(256) O 返回商户地址,签约成功页面、签约失败页面上“返回商户”按钮跳转地址。如客户多次输入支付密码错误后提示“改日再试”按钮也会跳转该地址。
为空则不显示返回商户按钮。
原生APP可传入一个特定地址(例如:Http://CMBNPRM),并拦截处理自行决定跳转交互。
http://www.xxx.com/yyy

请求示例

1.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"
    }
}

2.表单组织:

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

3.待签名字符串示例(未包含支付密钥):

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

响应报文

1、网页端直接展示签约成功或失败结果,无响应报文。
2、签约成功后有异步结果通知,失败无通知,详见签约成功通知接口。

备注

1、秘钥及表单提交地址,商户需通过配置管理,方便后续调整。
2、该接口采用招行网页嵌入商户app的方式来实现功能,商户app头部导航由商户自行实现。

关于网站迁移公告


为提供更优质的开发技术支持,本网站已于2019年8月12日正式迁移至新域名http://openhome.cmbchina.com/paynew/pay/Home,敬请访问并收藏。原网站域名已停止更新维护,请以新网站提供的文档信息为准。

由此给您带来的不便,敬请谅解。


招商银行一网通支付技术支持小组

2019年8月12日