欢迎使用 Alipay SDK for Java 。

Alipay SDK for Java让您不用复杂编程即可访支付宝开放平台开放的各项能力，SDK可以自动帮您满足能力调用过程中所需的证书校验、加签、验签、发送HTTP请求等非功能性要求。

这里向您介绍如何获取 Alipay SDK for Java 并开始调用。

如果您在使用 Alipay SDK for Java 的过程中遇到任何问题，欢迎在当前 GitHub 提交 Issues。

环境要求

Alipay SDK for Java 需要配合JKD 1.6或其以上版本。

使用 Alipay SDK for Java 之前 ，您需要先前往支付宝开发平台-开发者中心完成开发者接入的一些准备工作，包括创建应用、为应用添加功能包、设置应用的接口加签方式等。

准备工作完成后，注意保存如下信息，后续将作为使用SDK的输入。

加签模式为公钥证书模式时(推荐)

AppID、应用的私钥、应用的公钥证书文件、支付宝公钥证书文件、支付宝根证书文件

加签模式为公钥模式时

AppId、应用的私钥、应用的公钥、支付宝公钥

安装依赖

推荐通过Maven来管理项目依赖，您只需在项目的pom.xml文件中声明如下依赖

com.alipay.sdk

alipay-sdk-java

4.11.47.ALL

快速使用

以下这段代码示例向您展示了使用Alipay SDK for Java调用一个API的3个主要步骤：

创建DefaultAlipayClient实例并初始化。

创建API请求对象并设置Model参数。

发起请求并处理响应或异常。

import com.alipay.api.AlipayClient;

import com.alipay.api.CertAlipayRequest;

import com.alipay.api.DefaultAlipayClient;

import com.alipay.api.domain.AlipayOpenOperationOpenbizmockBizQueryModel;

import com.alipay.api.request.AlipayOpenOperationOpenbizmockBizQueryRequest;

import com.alipay.api.response.AlipayOpenOperationOpenbizmockBizQueryResponse;

public class Main {

public static void main(String[] args) {

try {

// 1. 创建AlipayClient实例

AlipayClient alipayClient = new DefaultAlipayClient(getClientParams());

// 2. 创建使用的Open API对应的Request请求对象

AlipayOpenOperationOpenbizmockBizQueryRequest request = getRequest();

// 3. 发起请求并处理响应

AlipayOpenOperationOpenbizmockBizQueryResponse response = alipayClient.certificateExecute(request);

if (response.isSuccess()) {

System.out.println("调用成功。");

} else {

System.out.println("调用失败，原因：" + response.getMsg() + "，" + response.getSubMsg());

}

} catch (Exception e) {

System.out.println("调用遭遇异常，原因：" + e.getMessage());

throw new RuntimeException(e.getMessage(), e);

}

}

private static CertAlipayRequest getClientParams() {

CertAlipayRequest certParams = new CertAlipayRequest();

certParams.setServerUrl("https://openapi.alipay.com/gateway.do");

//请更换为您的AppId

certParams.setAppId("2019091767145019");

//请更换为您的PKCS8格式的应用私钥

certParams.setPrivateKey("MIIEvQIBADANB ... ...");

//请更换为您使用的字符集编码，推荐采用utf-8

certParams.setCharset("utf-8");

certParams.setFormat("json");

certParams.setSignType("RSA2");

//请更换为您的应用公钥证书文件路径

certParams.setCertPath("/home/foo/appCertPublicKey_2019091767145019.crt");

//请更换您的支付宝公钥证书文件路径

certParams.setAlipayPublicCertPath("/home/foo/alipayCertPublicKey_RSA2.crt");

//更换为支付宝根证书文件路径

certParams.setRootCertPath("/home/foo/alipayRootCert.crt");

return certParams;

}

private static AlipayOpenOperationOpenbizmockBizQueryRequest getRequest() {

// 初始化Request，并填充Model属性。实际调用时请替换为您想要使用的API对应的Request对象。

AlipayOpenOperationOpenbizmockBizQueryRequest request = new AlipayOpenOperationOpenbizmockBizQueryRequest();

AlipayOpenOperationOpenbizmockBizQueryModel model = new AlipayOpenOperationOpenbizmockBizQueryModel();

model.setBizNo("test");

request.setBizModel(model);

return request;

}

}

文档

问题

提交 Issue，我们会定期查看Issue记录并尽快做出反馈。

变更日志

每个版本的详细更改记录在变更日志中。

注：版本号最末一位修订号的增加(比如从4.8.62.ALL升级为4.8.74.ALL)，意味着SDK的功能没有发生任何变化，仅仅是集成了更多的API的Request、Response、Model类，此类变更默认不记录在变更日志中。

相关

许可证