签名和验签

使用支付密钥的签名

一般情况下,商户需要使用支付密钥对请求报文进行签名。银行同步响应报文如果包含了签名数据,商户需要使用支付密钥进行验签。
验签的过程与签名过程基本相同,只是验签过程需要商户将计算出的签名数据和银行响应报文中的签名数据进行对比,以确认验签成功。
签名算法说明如下:
首先组成待签名字符串。待签名字符串组成规则为:对待验签的所有请求参数按从a到z的字典顺序排列,如果首字母相同,按第二个字母排列,以此类推。排序完成后按将所有键值对以“&”符号拼接:
param1=value1&param2=value2&……
将商户签名密钥增加“&”附加到待签名字符串后,按指定签名算法进行运算。假设待签名字符串为strToSign,商户密钥为merkey,算法为sha256,对strToSign&merkey进行sha256签名运算获得签名结果byte数组,将byte数组转换为16进制即为最终的签名结果。
注意:
1.所有reqData(或rspData)中参数,即便其值为空,也加入签名字符串
2.注意排序时按字典顺序排序,字母顺序与大小写无关。例如:sDate与sdateTime的顺序是sDate=XXX&sdateTime=XXX,sdate与sDateTime的顺序是sdate=XXX&sDateTime=XXX。
3.签名时,按指定的字符集将字符串转换为字节流
4.根据HTTP协议要求,如果请求参数值中有特殊字符和汉字,如&、@等,需进行URLEncoding处理。待签名数据为原生值而非encoding后的值。如:参数值为email=test@msn.com,则签名值是email=test@msn.com,而非email=test%40msn.com

样例报文:

{
    "version":"1.0",
    "charset":"UTF-8",
    "sign":"ABCDAEEDDDFA",
    "signType":"SHA-256",
    "reqData":{
        "param1":"value1",
        "param2":"value2",
        "dateTime":"20160622182921"
        }
}

待签名字符串(不包含支付密钥)为:
dateTime=20160622182921&param1=value1&param2=value2
注意:为了支持参数扩展,商户必须使用算法对待签名参数进行排序,不能使用程序写死的方法硬拼接参数顺序。
参见代码示例。

使用招行公钥验签(用于对“成功签约结果通知”和“成功支付结果通知”接收到的通知报文进行验签)

一般情况下,银行主动发送的通知报文使用招行私钥签名。商户接受到通知报文后需要使用招行公钥验签。
验签说明如下:
首先组成待签名字符串。待签名字符串组成规则为:对noticeData所有参数名按从a到z的字典顺序排列,如果首字母相同,按第二个字母排列,以此类推。排序完成后按将所有键值对以“&”符号拼接:
param1=value1&param2=value2&……
假设待签名字符串为strToSign,招行通知公钥为publicKey, 签名内容为strSign,算法为标准的RSA算法,加密算法为SHA1WithRSA,对strToSign进行签名校验。
招行通知公钥可以通过调用“查询招行公钥”接口获取,详见查询招行公钥API介绍。
注意:
1. 所有noticeData中请求参数,即便其值为空,也加入签名字符串
2. 验签字符串不需要拼接招行公钥。
3. 注意排序时按字典顺序排序,字母顺序与大小写无关。例如:sDate与sdateTime的顺序是sDate=XXX&sdateTime=XXX,sdate与sDateTime的顺序是sdate=XXX&sDateTime=XXX。
4. 签名时,按指定的字符集将字符串转换为字节流。
5. 根据HTTP协议要求,如果请求参数值中有特殊字符,如&、@等,需进行URLEncoding处理。待签名数据为原生值而非encoding后的值。如:参数值为email=test@msn.com,则签名值是email=test@msn.com,而非email=test%40msn.com

样例报文:

{
    "version":"1.0",
    "charset":"UTF-8",
    "sign":"签名结果(strSign)",
    "signType":"RSA",
    "noticeData":{
        "dateTime":"20160622182921",
        "noticeUrl":"https://... ",
        "httpMethod":"POST",
        "branchNo":"0755",
        “merchantNo”:”002346”,
        “noticeType”:”BKPAY”,
        “noticeSerialNo”:”201606238888888”,
        “param1”:”aaa”,
        “param2”:”bbb”
        }
}

待验证签名字符串strToSign为:
branchNo=0755&dateTime=20160622182921&httpMethod=POST&merchantNo=002346&noticeSerialNo=201606238888888&noticeType=BKPAY&noticeUrl=https://...&param1=aaa&param2=bbb

关于网站迁移公告


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

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


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

2019年8月12日