请求参数命名采用小驼峰格式。多个单词拼接而成的参数名,第一个单词的首字母小写,后续每个单词的首字母大写。如将wallet和version拼接为一个参数时,命名为walletVersion。
错误码 | 描述 | 说明 |
|---|---|---|
0 | 成功 | - |
1 | 参数错误 | 进一步的信息可以查看响应中的返回描述。 |
2 | 签名错误 | - |
3 | 内部错误,一般是无具体原因的错误,比如异常。 | 加解密失败、数据缺失、各种无具体原因的处理异常等。 |
6 | 外部依赖错误 | 服务器所依赖的其他系统出错,或者其返回不符合预期。 |
为了钱包服务更好地演进,华为钱包服务器使用版本号来区分不同回调请求的版本。开发者可以使用回调请求头中的Version字段来判断自己接收到的请求的版本,无Version字段则为V1版本。开发者在AGC网站申请钱包服务号时(passTypeIdentifier),默认使用当前最新的回调版本。开发者可以通过在AGC网站上更新钱包卡券事件回调地址或NFC相关事件回调地址,将回调接口更新为最新版本。
V2版本已于2020年10月27日上线。
对请求参数里的每一个key以ASCII码的增序排序。若遇到相同首字母,则以第二个字母排序,以此类推。排序完成之后,再以“&”字符连接起来。值为空的参数不会被拼接。
string[] parameters = {
"bankId"= "JUNNET-NET",
"orderId" = "918370122485714G",
"notifyTime" = "1353317037173",
"payType" = "2",
"productName" = "珍珠项链",
"requestId" = "1352286825177",
"result" = "0",
"userName" = "lilan",
"addition" = null
}; 待签名字符串为:
bankId=JUNNET-NET¬ifyTime=1353317037173&orderId=918370122485714G&payType=2&productName=珍珠项链&requestId=1352286825177&result=0&userName=lilan
钱包服务器对代签名字符串进行【SHA256WithRSA/PSS】签名(V1版本签名方式为SHA256WithRSA)。接收方服务器使用公共的RSA公钥进行验签。公共的RSA验签公钥为:
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA1+b2/q6KEJfvI65xJLXhPMT8YRUO618zsgaW4pNGZ+r/mwfFC1EOZbcBp7sV0IaxSWeMy0WNyJPSh/JltuiC1R93hfA0Kh3DlaRWaDgJz9VC1b+aPjUOx+uqndOEFiZcKGGnM60YPXfyo7xCDH76/WsWR0G4Ov6MoYQ76RAUT0t+G0oumYGgdLYwx5hJ1ywDKPXszj7A/mKHtWJKiylPIhUK2mLwKR8Y/+3dLNuNomvb7miVgeBFiriwGS1FolQMu433zEugAqRgsiasZAKfVK1BChPmiC812IMS1UPhz1wwpXzzkjQ1YQUGjnbHpooKobeCyctKKgF27F84egpzsQIDAQAB
待签名字符串:
eventId=469283774166292993&eventTime=2020-10-09T03:41:55.694Z&eventType=DELETE_CARD¬iceToken=1e4dda10e4590dcd66d1c14bfe1505424091f693996d2db885e54ad040723d7c&passNumber=passNumber1234&passTypeIdentifier=hwpass.com.xxx&pushToken=asdfghjkl&sceneType=THIRD_PARTY_DELETE_CARD
SHA256WithRSA/PSS签名:
g6Ylid2v13ibrGCDITYkms7rOxM9Qmpn2nTQy+MDneCvs8n2AznhdH1BOdZxAFEeNvIqaBejupJJNnHweDixxwQub34pt7Kv0wuW3LI0gtut5jsjEJuF9kfPj/f6W6ZfUgZB8R9j6jGMzqWoa7IRkXpIxpdJgral8aE+QwMG51hrzH8j/7EbPxpQgFyxuxiZimaeKDbgJ2yWIDtnaEVs+6NxLMhz+Vgo0vxEiyo+TEdcpkl0ahMA8XCXGs6lqlbl+G8imlU4+pMvM+IL9ygCbDWgwj6pmfrkDnD/tYVqElE9SIZ79+ShWLNwUgtWFfzo1ckMRWGSdMfwVd+f6boVIQ==
请用上面提供的公钥进行验签测试。可参考服务端“网页、短信、Email、App应用内方式领取卡劵”示例代码中的验签测试用例。