签约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、签约成功后有异步结果通知，失败无通知，详见签约成功通知接口。

错误码

无