• 简体中文
  • 签名方法

    加签

    商户后端调用palmpay开放接口需要对参数加签,签名过程如下:

    1. 假设 body 的数据为集合 M,将 M 中非空参数值的参数,去除前后空格,按照参数名 ASCII 码从小到大排序(字典序),使用URL键值对的格式(即key1=value1&key2=value2…)拼接成字符串strA
    2. 对strA进行MD5运算,再将得到的字符串所有字符转换为大写得到字符串md5Str
    3. 对md5Str使用商户的私钥(Base64编码)进行SHA1WithRSA签名,得到字符串sign,将sign字符串放入请求头信息里面的Signature字段

    签名参数

    假设需要签名的的参数如下:

    requestTime: 1546857549088
    version: V2.0
    nonceStr: tXIUBaQUUip97xhymcgvndYo6oSAvQXP
    orderId: e7c3784d5e2242fc00afe89ac12399

    第一步

    对参数按照key=value的格式,并按照参数名 ASCII 字典序排序如下:

    strA = "nonceStr=tXIUBaQUUip97xhymcgvndYo6oSAvQXP&orderId=e7c3784d5e2242fc00afe89ac12399&requestTime=1546857549088&version=V2.0";

    第二步

    MD5(strA),转大写:

    md5Str = Md5Util.MD5(strA) = "B43F98EC214118A136077FD49CD70804";

    第三步

    商户私钥生成签名:

    RsaUtil.sign(md5Str,privateKey):
    sign = RsaUtil.sign(md5Str,privateKey) = "gqJkWR5SCvAdzu5ISXckYOXkttKb5LXarOItoSPSJizfS";

    加签例子

    使用商户保存的私钥对请求加签。
    为了方便接入,我们提供了一个生成签名的demo工程,可以使用附件 📎PalmpaySdkDemoNew 中的 PalmPayUtil.generateSig() 方法来生成签名。这个签名方法已经实现了上述签名的三个步骤,直接拷贝代码集成到工程中即可。
    示例代码:

    public class Demo {
    
    	 @Test
        public void test() throws Exception {
            // 1.生成密钥对
            Map<String, String> keyPair = RsaUtil.generateKeyPair();
            String privateKey = keyPair.get(Constants.PRIVATE_KEY);
            String publicKey = keyPair.get(Constants.PUBLIC_KEY);
    
            System.out.println("privateKey:");
            System.out.println(privateKey);
            System.out.println("publicKey:");
            System.out.println(publicKey);
         // 2.加签
            HashMap<String, Object> newHashMap = new HashMap<>();
            newHashMap.put("requestTime",1662171389940L);
            newHashMap.put("version","V1.1");
            newHashMap.put("nonceStr","IBJGAeTa4ZJQv4Z2qufomVo9eI1YnJ9Y");
            newHashMap.put("amount", 200);
            newHashMap.put("currency", "NGN");
            newHashMap.put("notifyUrl", "https://xx.cn/callback/payment");
            newHashMap.put("orderId", "testc9ffae997fc4");
            newHashMap.put("title", "pay");
            newHashMap.put("transType", "24");
            newHashMap.put("userId", "110");
            newHashMap.put("country", "NG");
            newHashMap.put("orderType", "1");
    
            String sign = PalmPayUtil.generateSign(newHashMap, privateKey, SignType.RSA);
            System.out.println("sign: "+sign);
            // 3.验签
            boolean result = PalmPayUtil.verifySign(newHashMap, publicKey, sign, SignType.RSA);
    
            Assert.assertTrue(result);
        }
    }

    验签

    为了保证数据安全,商户后端需要对palmpay回调商户的请求做验签。

    第一步

    对参数按照key=value的格式,并按照参数名 ASCII 字典序排序如下:

    strA = "nonceStr=tXIUBaQUUip97xhymcgvndYo6oSAvQXP&orderId=e7c3784d5e2242fc00afe89ac12399&requestTime=1546857549088&version=V2.0";

    第二步

    MD5(strA),转大写:

    md5Str = Md5Util.MD5(strA) = "B43F98EC214118A136077FD49CD70804";

    验签例子

    使用PalmPay提供的公钥验证PalmPay回调商户接口的签名。
    PalmPay通知回调请求,@RequestBody 中的请求参数除了sign以外的非空参数按第一步、第二步规则得到md5Str。使用附件 📎PalmpaySdkDemoNew 中的 PalmPayUtil.verifySignForCallback 方法来验证签名。
    示例代码:

     public void testCallbackVerify() throws Exception {
            String paramBody = "{\"orderId\":\"P23101802543812274\",\"orderNo\":\"2424231018025438544222\",\"appId\":\"L10378191362\",\"transType\":\"24\",\"orderType\":\"01\",\"amount\":999,\"couponAmount\":0,\"status\":1,\"completeTime\":1697597698516,\"orderStatus\":2,\"sign\":\"Dj9ycTD91W9ti4n%2FK6GbtVu2qNDE83tB6C7ToKrVe9tSM2aIhMrk%2Fqy9CgQ9fwXJhH6QQ1kg8kx2AV7O4tOIpSXs%2BnZ7aHXjricn8pUx06yQ%2BIqBXWSY9Hrhb6qkPXAzcskQ1MI%2B7SOieBVJTMf4vxIoxLOhMSYHeQB5jyfgZBA%3D\"}";
            //PalmPay public key in test env (not  the keys generate by merchant)
            String publicKey = "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCVT+pLc1nkz9z803SOmF48bMFn0GYF4ng6nxj0ojUeu4KeNKkkw/nfureTtL77j9RpMjquJzzKdOZfHRvQyuAbaLoaSD1uU47npNiAL05bLYZEoZWvFOar9gNbIesea8MX0DeYncA2Tkr3kUo8K6XBrZ+TcV2Q8NEvm1T536LOGwIDAQAB";
            boolean res = PalmPayUtil.verifySignForCallback(paramBody,publicKey,SignType.RSA);
            Assert.assertTrue(res);
        }

    验签注意事项

    1. 回调接口验签 a. 回调接口的验签需要进行全字段验签(移除sign后的所有字段),先将Palmpay callback的请求参数解析为map进行验签,验签完成后根据需要再正常反序列化成Java对象