PHPackages                             gaoj87/easysdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. gaoj87/easysdk

ActiveLibrary[Payment Processing](/categories/payments)

gaoj87/easysdk
==============

支付宝官方 Alipay Easy SDK

1.2.1(6y ago)11.4kApache-2.0JavaPHP &gt;=7.0

Since Mar 27Pushed 5y agoCompare

[ Source](https://github.com/gaoj87/alipay-easysdk)[ Packagist](https://packagist.org/packages/gaoj87/easysdk)[ RSS](/packages/gaoj87-easysdk/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (11)Versions (5)Used By (0)

[![FOSSA Status](https://camo.githubusercontent.com/49a49bba56b5f8a56d800edb866b1a1d81aba9466ef3473049d2f226731929a2/68747470733a2f2f6170702e666f7373612e636f6d2f6170692f70726f6a656374732f6769742532426769746875622e636f6d253246616c69706179253246616c697061792d6561737973646b2e7376673f747970653d736869656c64)](https://app.fossa.com/projects/git%2Bgithub.com%2Falipay%2Falipay-easysdk?ref=badge_shield)[![Maven Central](https://camo.githubusercontent.com/4d72564f6fea7e10ad80627b94f202655d18f386c7be6c1a9f4a0f26a89b74b2/68747470733a2f2f696d672e736869656c64732e696f2f6d6176656e2d63656e7472616c2f762f636f6d2e616c697061792e73646b2f616c697061792d6561737973646b2e737667)](https://mvnrepository.com/artifact/com.alipay.sdk/alipay-easysdk)[![NuGet](https://camo.githubusercontent.com/62ae7d5f65c542706dd8261a3a2ae8d94fdcef21e8329381a56557a31db2bdbf/68747470733a2f2f62616467652e667572792e696f2f6e752f416c697061794561737953444b2e737667)](https://badge.fury.io/nu/AlipayEasySDK)[![Packagist](https://camo.githubusercontent.com/a4ab1e8657ce7ff9ca015240fa0ecf4ab50766b5227c6ec504b6885e3d745f3e/68747470733a2f2f706f7365722e707567782e6f72672f616c6970617973646b2f6561737973646b2f762f737461626c65)](https://packagist.org/packages/alipaysdk/easysdk)

欢迎使用 Alipay **Easy** SDK。

打造**最好用**的支付宝开放平台**服务端SDK**，Alipay Easy SDK让您享受**极简编程**体验，快速访问支付宝开放平台开放的各项**核心能力**。

设计理念
----

[](#设计理念)

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

同时，您也不必担心面向高频场景提炼的API可能无法完全契合自己的个性化场景，Alipay Easy SDK支持灵活的[动态扩展](#extension)方式，同样可以满足低频参数、低频API的使用需求。

Alipay Easy SDK提供了与[能力地图](https://opendocs.alipay.com/mini/00am3f)相对应的代码组织结构，让开发者可以快速找到不同能力对应的API。

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

### 化繁为简

[](#化繁为简)

Alipay Easy SDKAlipay SDK极简代码风格，更贴近自然语言阅读习惯传统代码风格，需要多行代码完成一个接口的调用Factory单例全局任何地方都可直接引用AlipayClient实例需自行创建并在上下文中传递API中只保留高频场景下的必备参数，同时提供低频可选参数的装配能力没有区分高低频参数，单API最多可达数十个入参，对普通开发者的干扰较大- Alipay Easy SDK 😃

```
Factory.Payment.Common().create("Iphone6 16G", "202003019443", "0.10", "2088002656718920");
```

- Alipay SDK 😕

```
AlipayTradeCreateRequest request = new AlipayTradeCreateRequest();

AlipayTradeCreateModel model = new AlipayTradeCreateModel();
model.setSubject("Iphone6 16G");
model.setOutTradeNo("202003019443");
model.setTotalAmount("0.10");
model.setBuyerId("2088002656718920");
...

request.setBizModel(model);
...

alipayClient.execute(request);
```

### 如何切换

[](#如何切换)

- 无论是Alipay Easy SDK还是Alipay SDK，本质都是发送HTTP请求访问Open API网关，所以只需将原来通过Alipay SDK调用Open API的代码，替换为Alipay Easy SDK中对应API的调用即可。Alipay Easy SDK和Alipay SDK并无冲突，可以共存。
- 如果您所需对接的开放平台能力，Alipay Easy SDK尚未提炼出API支持（[已支持的API列表](#apiList)），您可以通过[通用接口](./APIDoc.md#generic)完成调用。
- 我们会持续挖掘高频场景，不断丰富Alipay Easy SDK支持的API，让您在绝大多数常见场景下，都能享受Alipay Easy SDK带来的便捷。

技术特点
----

[](#技术特点)

### 纯语言开发

[](#纯语言开发)

所有Alipay Easy SDK的具体编程语言的实现，均只采用纯编程语言进行开发，不引入任何重量级框架，减少潜在的框架冲突，让SDK可以自由集成进任何代码环境中。

### 结构清晰

[](#结构清晰)

我们按照能力类别和场景类别对API进行了归类，结构更加清晰，一目了然。

> 更多信息请参见[API组织规范](#spec)。

### 参数精简

[](#参数精简)

Alipay Easy SDK对每个API都精心打磨，剔除了`Open API`中不常用的可选参数，减少普通用户的无效选择，提升开发效率。

### 灵活扩展

[](#灵活扩展)

开发者可以通过Fluent风格的API链式调用，在为高频场景打造的API基础上，不断扩展自己的个性化场景需求。

```
// 通过调用agent方法，扩展支持ISV代调用场景
Factory.Payment.FaceToFace().agent("ca34ea491e7146cc87d25fca24c4cD11").preCreate(...)

// 通过调用optional方法，扩展支持个性化可选参数
Factory.Payment.FaceToFace().optional("extend_params", extendParams).preCreate(...)

// 多种扩展可灵活搭配，不同扩展方法功能详细说明请前往各语言主页中的“快速开始-扩展调用”栏目中查看
Factory.Payment.FaceToFace()
	.agent(...)
	.optionalArgs(...)
	.auth(...)
	.asyncNotify(...)
	.preCreate(...)
```

### 测试/示例完备

[](#测试示例完备)

每个API都有对应的单元测试进行覆盖，良好的单元测试天生就是最好的示例。

同时您也可以前往[API Doc](./APIDoc.md)查看每个API的详细使用说明。

> 注：单元测试中使用到的私钥均进行了脱敏处理，会导致单元测试无法直接执行。您可以自行更改单元测试项目中的`TestAccout类`和`privateKey.json`文件中的相关账号与私钥配置后再执行单元测试。

### 多语言

[](#多语言)

Alipay Easy SDK基于阿里集团研发的`Tea DSL`工具链进行架构，通过DSL中间语言定义API模型，再基于DSL语言自动生成不同编程语言（Java、C#、PHP、TS等）实现的SDK，极大地提升了SDK能力的扩展效率和适用范围，同时也保证了相同的`Easy API`在不同语言生态中体验的一致性。

API模型的Tea DSL描述可以进入[tea](./tea)目录查看。

> Tea DSL相关介绍和编写规范正在筹划开放中，后续您也可以参与Tea DSL的编写贡献更多优秀的`Easy API`模型，而无需关心多语言问题。

### 快速集成

[](#快速集成)

各语言SDK均会在各自的中央仓库（Maven、NuGet、Composer、NPM etc.）中同步发布，让您使用各语言主流依赖管理工具即可一键安装集成SDK。

语言支持情况
------

[](#语言支持情况)

Alipay Easy SDK首发暂只支持`Java`、`C#`、`PHP`编程语言，更多编程语言支持正在积极新增中，敬请期待。

各语言具体的**使用说明**和**详细介绍**请点击如下链接进入各语言主目录查看。

[Java](./java)

[C#](./csharp)

[PHP](./php)

API组织规范
-------

[](#api组织规范)

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

> Factory.能力类别.场景类别.接口方法名称( ... )

比如，如果您想要使用[能力地图](https://opendocs.alipay.com/mini/00am3f)中`营销能力`下的`模板消息`场景中的`小程序发送模板消息`，只需按如下形式编写调用代码即可（不同编程语言的连接符号可能不同）。

`Factory.Marketing.TemplateMessage().send( ... )`

其中，接口方法名称通常是对其依赖的OpenAPI功能的一个最简概况，接口方法的出入参与OpenAPI中同名参数含义一致，可参照OpenAPI相关参数的使用说明。

Alipay Easy SDK将致力于保持良好的API命名，以符合开发者的编程直觉。

已支持的API列表
---------

[](#已支持的api列表)

能力类别场景类别接口方法名称调用的OpenAPI名称BaseOAuthgetTokenalipay.system.oauth.tokenBaseOAuthrefreshTokenalipay.system.oauth.tokenBaseQrcodecreatealipay.open.app.qrcode.createBaseImageuploadalipay.offline.material.image.uploadBaseVideouploadalipay.offline.material.image.uploadMemberIdentificationinitalipay.user.certify.open.initializeMemberIdentificationcertifyalipay.user.certify.open.certifyMemberIdentificationqueryalipay.user.certify.open.queryPaymentCommoncreatealipay.trade.createPaymentCommonqueryalipay.trade.queryPaymentCommonrefundalipay.trade.refundPaymentCommonclosealipay.trade.closePaymentCommoncancelalipay.trade.cancelPaymentCommonqueryRefundalipay.trade.fastpay.refund.queryPaymentCommondownloadBillalipay.data.dataservice.bill.downloadurl.queryPaymentCommonverifyNotify-PaymentHuabeicreatealipay.trade.createPaymentFaceToFacepayalipay.trade.payPaymentFaceToFaceprecreatealipay.trade.precreatePaymentApppayalipay.trade.app.payPaymentPagepayalipay.trade.page.payPaymentWappayalipay.trade.wap.paySecurityTextRiskdetectalipay.security.risk.content.detectMarketingPasscreateTemplatealipay.pass.template.addMarketingPassupdateTemplatealipay.pass.template.updateMarketingPassaddInstancealipay.pass.instance.addMarketingPassupdateInstancealipay.pass.instance.updateMarketingTemplateMessagesendalipay.open.app.mini.templatemessage.sendMarketingOpenLifecreateImageTextContentalipay.open.public.message.content.createMarketingOpenLifemodifyImageTextContentalipay.open.public.message.content.modifyMarketingOpenLifesendTextalipay.open.public.message.total.sendMarketingOpenLifesendImageTextalipay.open.public.message.total.sendMarketingOpenLifesendSingleMessagealipay.open.public.message.single.sendMarketingOpenLiferecallMessagealipay.open.public.life.msg.recallMarketingOpenLifesetIndustryalipay.open.public.template.message.industry.modifyMarketingOpenLifegetIndustryalipay.open.public.setting.category.queryUtilAESdecrypt-UtilAESencrypt-UtilGenericexecute-> 注：更多高频场景的API持续更新中，敬请期待。

您还可以前往[API Doc](./APIDoc.md)查看每个API的详细使用说明。

变更日志
====

[](#变更日志)

每个版本的详细更改记录在[变更日志](./CHANGELOG)中。

> 版本号最末一位修订号的增加（比如从`1.0.0`升级为`1.0.1`），意味着SDK的功能没有发生任何变化，仅仅是修复了部分Bug。该类升级可能不会记录在变更日志中。

> 版本号中间一位次版本号的增加（比如从`1.0.0`升级为`1.1.0`），意味着SDK的功能发生了可向下兼容的新增或修改。

> 版本号首位主版本号的增加（比如从`1.0.0`升级为`2.0.0`），意味着SDK的功能可能发生了不向下兼容的较大调整，升级主版本号后请注意做好相关的回归测试工作。

相关
==

[](#相关)

- [支付宝开放平台](https://open.alipay.com/platform/home.htm)
- [支付宝开放平台文档中心](https://docs.open.alipay.com/catalog)
- [最新源码](https://github.com/alipay/alipay-easysdk)

许可证
===

[](#许可证)

[![FOSSA Status](https://camo.githubusercontent.com/305e5f360cdbb697ee429eae4019d4e2b82271119623eea38bf1c4861c31029b/68747470733a2f2f6170702e666f7373612e636f6d2f6170692f70726f6a656374732f6769742532426769746875622e636f6d253246616c69706179253246616c697061792d6561737973646b2e7376673f747970653d6c61726765)](https://app.fossa.com/projects/git%2Bgithub.com%2Falipay%2Falipay-easysdk?ref=badge_large)

交流与技术支持
=======

[](#交流与技术支持)

不管您在使用Alipay Easy SDK的过程中遇到任何问题，欢迎在当前 GitHub [提交 Issues](https://github.com/alipay/alipay-easysdk/issues/new)。

您也可以使用钉钉扫描下方二维码，与更多开发者和支付宝工程师共同交流。

[![支付宝官方Alipay Easy SDK开源交流群](https://camo.githubusercontent.com/3cf7eab1efd66c4b4578612e62a62891526919c6495d08b191930845b559b199/68747470733a2f2f67772e616c697061796f626a656374732e636f6d2f6d646e2f726d735f3065313566612f616674732f696d672f412a66347572546f79684c55494141414141414141414141426b4152516e4151)](https://camo.githubusercontent.com/3cf7eab1efd66c4b4578612e62a62891526919c6495d08b191930845b559b199/68747470733a2f2f67772e616c697061796f626a656374732e636f6d2f6d646e2f726d735f3065313566612f616674732f696d672f412a66347572546f79684c55494141414141414141414141426b4152516e4151)

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 60.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~20 days

Total

3

Last Release

2194d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b401aa25d71931cbb4c72d46aae4aee9139e1d0d81398eb3b67c422392b2951a?d=identicon)[gaoj87](/maintainers/gaoj87)

---

Top Contributors

[![antopen](https://avatars.githubusercontent.com/u/34638345?v=4)](https://github.com/antopen "antopen (14 commits)")[![gaojiangaojian](https://avatars.githubusercontent.com/u/64852278?v=4)](https://github.com/gaojiangaojian "gaojiangaojian (5 commits)")[![wjunying](https://avatars.githubusercontent.com/u/49644108?v=4)](https://github.com/wjunying "wjunying (2 commits)")[![ujjboy](https://avatars.githubusercontent.com/u/1424920?v=4)](https://github.com/ujjboy "ujjboy (1 commits)")[![WeihanLi](https://avatars.githubusercontent.com/u/7604648?v=4)](https://github.com/WeihanLi "WeihanLi (1 commits)")

### Embed Badge

![Health badge](/badges/gaoj87-easysdk/health.svg)

```
[![Health](https://phpackages.com/badges/gaoj87-easysdk/health.svg)](https://phpackages.com/packages/gaoj87-easysdk)
```

###  Alternatives

[alipaysdk/easysdk

支付宝官方 Alipay Easy SDK

1.2k437.1k21](/packages/alipaysdk-easysdk)[dnetix/redirection

Library to connect with PlacetoPay Checkout service

17123.3k2](/packages/dnetix-redirection)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
