签约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

请求报文

参数名称 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 客户协议号。支持的字符集: 数字、字母(大小字母)、-_ 两个特殊字符,-_ 注意是英文半角的。未签约(首次支付)客户,填写新协议号,用于协议开通;已签约(再次支付)客户,填写该客户已有的协议号。商户必须对协议号进行管理,确保客户与协议号一一对应。 201606238888888
分行号 branchNo String(4) M 商户分行号,4位数字 0755
商户号 merchantNo String(6) M 商户号,6位数字 123456
商户用户手机号 mobile String(30) O 商户用户的手机号 13888888888
商户用户ID userID String(20) O 用于标识商户用户的唯一ID。
商户系统内用户唯一标识,不超过20位,数字字母都可以,建议纯数字
12345678|ABCDEFG|HIJKLM
经度 lon String(20) O 经度,商户app获取的手机定位数据 30.949505
纬度 lat String(20) O 纬度,商户app获取的手机定位数据 50.949506
风险等级 riskLevel String(4) O 用户在商户系统内风险等级标识
成功签约结果通知参数 noticePara String(256) O 该参数在发送成功签约结果通知时,将原样返回商户
注意:该参数可为空,商户如果需要不止一个参数,可以自行把参数组合、拼装,但组合后的结果不能带有‘&’字符。
成功签约结果通知地址 noticeUrl String(256) M 商户接收成功签约结果通知的地址 http://www.xxx.com/xxx
返回商户地址 returnUrl String(256) O 签约成功页面上“返回商户”按钮跳转地址,默认值:http://CMBNPRM,采用默认值的需要商户app拦截该请求,自行决定跳转交互 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&noticePara=&noticeUrl=http://www.xxx.com/xxx&returnUrl=http://www.xxx.com/yyy&riskLevel=3&userID=2016062388888 

响应报文

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

错误码

关于网站迁移公告


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

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


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

2019年8月12日