查询 AES 密钥

如果小程序模板或者商家小程序已经设置了 AES 密钥，服务商可通过调用 alipay.open.auth.app.aes.get（授权应用 AES 密钥查询）接口来查询应用的 AES 密钥。

示例代码如下（以 Java 语言为例）。

公钥方式

//encryptKey填入当前第三方应用的AES密钥，encryptType为"AES" 
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","第三方应用APPID","your private_key","json","GBK","alipay_public_key","RSA2","encryptKey","encryptType");
AlipayOpenAuthAppAesGetRequest request = new AlipayOpenAuthAppAesGetRequest();
request.setBizContent ("{"   + 
    "\"merchant_app_id\":\"20191223601234500\""   + //填写需查询密钥的应用APPID
  "}" );
AlipayOpenAuthAppAesGetResponse response = alipayClient.execute(request);
if (response.isSuccess ()){
  System.out.println(response.getAesKey());
  System.out.println( "调用成功" );
}  else  {
  System.out.println( "调用失败" );
}

公钥证书方式

        AlipayConfig alipayConfig = new AlipayConfig();
        alipayConfig.setServerUrl(AlipayServiceEnvConstants.ALIPAY_GATEWAY);
        alipayConfig.setAppId(AlipayServiceEnvConstants.app_id);
        alipayConfig.setPrivateKey(AlipayServiceEnvConstants.private_key);
        alipayConfig.setAppCertPath(AlipayServiceEnvConstants.app_cert_path);
        alipayConfig.setAlipayPublicCertPath(AlipayServiceEnvConstants.alipay_cert_path);
        alipayConfig.setRootCertPath(AlipayServiceEnvConstants.alipay_root_cert_path);
        alipayConfig.setFormat("json");
        alipayConfig.setCharset(AlipayServiceEnvConstants.CHARSET);
        alipayConfig.setSignType(AlipayServiceEnvConstants.SIGN_TYPE);
        alipayConfig.setEncryptType(AlipayServiceEnvConstants.encryptType);
        alipayConfig.setEncryptKey(AlipayServiceEnvConstants.encryptKey);
        AlipayClient alipayClient = new DefaultAlipayClient(alipayConfig);

        AlipayOpenAuthAppAesGetRequest request = new AlipayOpenAuthAppAesGetRequest();
        Map<String, String> map = new HashMap<>();
        map.put("merchant_app_id", "2021002114641105");// 查询模板AES密钥就填写小程序模板APPID，为商家小程序填写商家小程序APPID

        request.setBizContent(JSON.toJSONString(map));
        request.setNeedEncrypt(true);

        AlipayOpenAuthAppAesGetResponse response = alipayClient.certificateExecute(request);
        if (response.isSuccess ()){
            System.out.println(String.format("调用成功,aesKey=%s", response.getAesKey()));
        }  else  {
            System.out.println( "调用失败" );
        }

注意：

服务商在构造 alipayClient 时，构造方法中需传入 encryptKey 和 encryptType，encryptKey 为当前三方应用的 AES 密钥，encryptType 为固定值 AES。

服务商在调用接口前，必须先设置第三方应用的 AES 密钥，否则无法调用接口。

设置/更新 AES 密钥

如果小程序模板或者商家应用没有设置 AES 密钥，或者 AES 密钥需要更新，服务商可以通过调用 alipay.open.auth.app.aes.set（授权应用 AES 密钥设置）接口，来替小程序模板或者商家应用设置或者更新 AES 密钥。

注意：服务商请谨慎设置或更新商家应用密钥；若商家应用已上线，更新商家应用的密钥可能会影响商家的线上业务。服务商应该在商家应用没有密钥或者必须更换密钥时才去设置，若商家应用已有密钥，则调用上文中的密钥查询接口即可。

示例代码如下（以 Java 语言为例）。

公钥方式

//encryptKey填入当前第三方应用的AES密钥，encryptType为"AES" 
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","第三方应用APPID","your private_key","json","GBK","alipay_public_key","RSA2","encryptKey","encryptType");
AlipayOpenAuthAppAesSetRequest request = new AlipayOpenAuthAppAesSetRequest();
request.setBizContent ("{"   + 
          //为模板设置就填写小程序模板APPID，为商家设置就填写商家小程序APPID
        "\"merchant_app_id\":\"20191223601234500\""   + 
    "}");
AlipayOpenAuthAppAesSetResponse response = alipayClient.execute(request);
if (response.isSuccess ()){
      System.out.println ( response.getAesKey());
      System.out.println ("调用成功");
}  else  {
      System.out.println ("调用失败");
}

公钥证书方式

       AlipayConfig alipayConfig = new AlipayConfig();
        alipayConfig.setServerUrl(AlipayServiceEnvConstants.ALIPAY_GATEWAY);
        alipayConfig.setAppId(AlipayServiceEnvConstants.app_id);//第三方应用APPID
        alipayConfig.setPrivateKey(AlipayServiceEnvConstants.private_key);//第三方应用私钥
        alipayConfig.setAppCertPath(AlipayServiceEnvConstants.app_cert_path);//第三方应用公钥证书绝对路径
        alipayConfig.setAlipayPublicCertPath(AlipayServiceEnvConstants.alipay_cert_path);//支付宝公钥证书绝对路径
        alipayConfig.setRootCertPath(AlipayServiceEnvConstants.alipay_root_cert_path);//支付宝 CA 根证书文件路径
        alipayConfig.setFormat("json");
        alipayConfig.setCharset(AlipayServiceEnvConstants.CHARSET);
        alipayConfig.setSignType(AlipayServiceEnvConstants.SIGN_TYPE);
        alipayConfig.setEncryptType(AlipayServiceEnvConstants.encryptType);
        alipayConfig.setEncryptKey(AlipayServiceEnvConstants.encryptKey);

        AlipayClient alipayClient = new DefaultAlipayClient(alipayConfig);

        AlipayOpenAuthAppAesSetRequest request = new AlipayOpenAuthAppAesSetRequest();
        Map<String, String> map = new HashMap<>();
        map.put("merchant_app_id", "2021002114641105");// 为模板设置就填写小程序模板APPID，为商家设置就填写商家小程序APPID

        request.setBizContent(JSON.toJSONString(map));
        request.setNeedEncrypt(true);

        AlipayOpenAuthAppAesSetResponse response = alipayClient.certificateExecute(request);
        if (response.isSuccess()) {
            System.out.println(String.format("调用成功,aesKey=%s", response.getAesKey()));
        } else {
            System.out.println("调用失败");
        }

注意：

服务商在构造 alipayClient 时，构造方法中需传入 encryptKey 和 encryptType，encryptKey 为当前第三方应用的 AES 密钥，encryptType 为固定值 AES。

服务商在调用接口前，必须先设置第三方应用的 AES 密钥，否则无法调用接口。

接入指南

查询 AES 密钥#

设置/更新 AES 密钥#

查询 AES 密钥

设置/更新 AES 密钥