java

欢迎使用 Alipay Easy SDK for Java 。

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

下面向您介绍Alipay Easy SDK for Java 的基本设计理念和使用方法。

设计理念

不同于原有的Alipay SDK通用而全面的设计理念，Alipay Easy SDK对开放能力的API进行了更加贴近高频场景的精心设计与裁剪，简化了服务端调用方式，让调用API像使用语言内置的函数一样简便。

Alipay Easy SDK提供了与能力地图相对应的代码组织结构，让开发者可以快速找到不同能力对应的API。

Alipay Easy SDK主要目标是提升开发者在服务端集成支付宝开放平台开放的各类核心能力的效率。

环境要求

1. Alipay Easy SDK for Java 需要配合JDK 1.7或其以上版本。

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

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

• 加签模式为公钥证书模式时（推荐）

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

• 加签模式为公钥模式时

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

安装依赖

通过Maven来管理项目依赖（推荐）

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

<dependency>
    <groupId>com.alipay.sdk</groupId>
    <artifactId>alipay-easysdk</artifactId>
    <version>Use the version shown in the maven badge</version>
</dependency>

本地手动集成依赖（适用于自己修改源码后的本地重新打包安装）

1. 本机安装配置Maven工具。
2. 在本README.md所在目录下，执行mvn package -DskipTests，将SDK源码编译打包。
3. target目录下生成的alipay-easysdk-java-[version].jar文件（大小在15MB左右）即为打包SDK得到的Jar文件。
4. 将打包SDK得到的Jar文件拷贝到需要集成本SDK的Java服务端应用的CLASS_PATH路径下。

使用Intellij IDEA的用户可以在自己服务端Java应用的项目根节点处点击右键 -> Open Module Settings -> Libraries -> 点击+号 -> 选择Java -> 从弹出的资源管理器中浏览选中打包SDK得到的Jar文件 -> 点击确定即可完成SDK的依赖安装。

快速使用

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

1. 设置参数（全局只需设置一次）。
2. 发起API调用。
3. 处理响应或异常。

package com.alipay;

import com.alipay.easysdk.factory.Factory;
import com.alipay.easysdk.kernel.BaseClient.Config;
import com.alipay.easysdk.payment.models.AlipayTradeCreateResponse;

public class Main {
    public static void main(String[] args) {
        // 1. 设置参数（全局只需设置一次）
        Factory.setOptions(getOptions());
        try {
            // 2. 发起API调用（以支付能力下的统一收单交易创建接口为例）
            AlipayTradeCreateResponse response = Factory.Payment().create("Apple iPhone11 128G",
                    "2234567890", "5799.00", "2088002656718920");
            // 3. 处理响应或异常
            if ("10000".equals(response.code)) {
                System.out.println("调用成功");
            } else {
                System.err.println("调用失败，原因：" + response.msg + "，" + response.subMsg);
            }
        } catch (Exception e) {
            System.err.println("调用遭遇异常，原因：" + e.getMessage());
            throw new RuntimeException(e.getMessage(), e);
        }
    }

    private static Config getOptions() {
        Config config = new Config();
        config.protocol = "https";
        config.gatewayHost = "openapi.alipay.com";
        config.signType = "RSA2";

        // 请更换为您的AppId
        config.appId = "2019091767145019";
        
        // 请更换为您的PKCS8格式的应用私钥
        config.merchantPrivateKey = "MIIEvQIBADANB ... ...";
        
        //注：证书文件路径支持设置为文件系统中的路径或CLASS_PATH中的路径，优先从文件系统中加载，加载失败后会继续尝试从CLASS_PATH中加载
        // 请更换为您的应用公钥证书文件路径
        config.merchantCertPath = "/home/foo/appCertPublicKey_2019051064521003.crt";
        // 请更换为您的支付宝公钥证书文件路径
        config.alipayCertPath = "/home/foo/alipayCertPublicKey_RSA2.crt";
        // 请更换为您的支付宝根证书文件路径
        config.alipayRootCertPath = "/home/foo/alipayRootCert.crt";

        //注：如果采用非证书模式，则无需赋值上面的三个证书路径，改为赋值如下的支付宝公钥字符串即可
        // config.alipayPublicKey = "MIIBIjANBg...";
        
        return config;
    }
}

API组织规范

在Alipay Easy SDK中，API的引用路径与能力地图的组织层次一致，遵循如下规范

Factory.能力名称.[场景名称.]接口方法名称( ... )

比如，如果您想要使用能力地图中营销能力下的模板消息场景中的小程序发送模板消息，只需调用Factory.Marketing.TemplateMessage().send( ... )API即可。

接口方法名称通常是对其依赖的OpenAPI功能的一个最简概况，接口方法的出入参数通常与OpenAPI中同名参数含义一致，参照OpenAPI相关参数的使用说明即可。Alipay Easy SDK将致力于保持良好的API命名，以符合开发者的编程直觉。

已支持的API列表

能力类别	场景类别	接口方法名称	调用的OpenAPI名称
Base	OAuth	getToken	alipay.system.oauth.token
Base	OAuth	refreshToken	alipay.system.oauth.token
Base	Qrcode	create	alipay.open.app.qrcode.create
Base	Image	upload	alipay.offline.material.image.upload
Base	Video	upload	alipay.offline.material.image.upload
Member	Identification	init	alipay.user.certify.open.initialize
Member	Identification	certify	alipay.user.certify.open.certify
Member	Identification	query	alipay.user.certify.open.query
Payment	Common	create	alipay.trade.create
Payment	Common	query	alipay.trade.query
Payment	Common	refund	alipay.trade.refund
Payment	Common	close	alipay.trade.close
Payment	Common	cancel	alipay.trade.close
Payment	Huabei	create	alipay.trade.create
Payment	FaceToFace	pay	alipay.trade.pay
Security	TextRisk	detect	alipay.security.risk.content.detect
Marketing	Pass	createTemplate	alipay.pass.template.add
Marketing	Pass	updateTemplate	alipay.pass.template.update
Marketing	Pass	addInstance	alipay.pass.instance.add
Marketing	Pass	updateInstance	alipay.pass.instance.update
Marketing	TemplateMessage	send	alipay.open.app.mini.templatemessage.send
Marketing	OpenLife	createImageTextContent	alipay.open.public.message.content.create
Marketing	OpenLife	modifyImageTextContent	alipay.open.public.message.content.modify
Marketing	OpenLife	sendText	alipay.open.public.message.total.send
Marketing	OpenLife	sendImageText	alipay.open.public.message.total.send
Marketing	OpenLife	sendSingleMessage	alipay.open.public.message.single.send
Marketing	OpenLife	recallMessage	alipay.open.public.life.msg.recall
Marketing	OpenLife	setIndustry	alipay.open.public.template.message.industry.modify
Marketing	OpenLife	getIndustry	alipay.open.public.setting.category.query

注：更多高频场景的API持续更新中，敬请期待。

文档

API Doc

Alipay Easy SDK