shangmenanmo/vendor/alipaysdk/easysdk

欢迎使用 Alipay Easy SDK。

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

设计理念

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

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

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

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

化繁为简

Alipay Easy SDK	Alipay 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列表），您可以通过通用接口完成调用。

• 我们会持续挖掘高频场景，不断丰富Alipay Easy SDK支持的API，让您在绝大多数常见场景下，都能享受Alipay Easy SDK带来的便捷。

技术特点

纯语言开发

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

结构清晰

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

更多信息请参见API组织规范。

参数精简

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查看每个API的详细使用说明。

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

多语言

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

API模型的DSL描述可以进入tea目录查看。

快速集成

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

语言支持情况

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

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

Java

C#

PHP

API组织规范

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

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

比如，如果您想要使用能力地图中营销能力下的模板消息场景中的小程序发送模板消息，只需按如下形式编写调用代码即可（不同编程语言的连接符号可能不同）。

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

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

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

已支持的API列表

能力类别	场景类别	接口方法名称	调用的OpenAPI名称
Base 基础能力	OAuth 用户授权	getToken 获取授权访问令牌和用户user_id	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.cancel
Payment 支付能力	Common 通用	queryRefund 交易退款查询	alipay.trade.fastpay.refund.query
Payment 支付能力	Common 通用	downloadBill 查询对账单下载地址	alipay.data.dataservice.bill.downloadurl.query
Payment 支付能力	Common 通用	verifyNotify 异步通知验签	-
Payment 支付能力	Huabei 花呗分期	create 创建花呗分期交易	alipay.trade.create
Payment 支付能力	FaceToFace 当面付	pay 扫用户出示的付款码，完成付款	alipay.trade.pay
Payment 支付能力	FaceToFace 当面付	precreate 生成交易付款码，待用户扫码付款	alipay.trade.precreate
Payment 支付能力	App 手机APP	pay 生成订单串，再使用客户端 SDK 凭此串唤起支付宝收银台	alipay.trade.app.pay
Payment 支付能力	Page 电脑网站	pay 生成交易表单，渲染后自动跳转支付宝网站引导用户完成支付	alipay.trade.page.pay
Payment 支付能力	Wap 手机网站	pay 生成交易表单，渲染后自动跳转支付宝网站引导用户完成支付	alipay.trade.wap.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
Util 辅助工具	AES 加解密	decrypt 解密，常用于会员手机号解密	-
Util 辅助工具	AES 加解密	encrypt 加密	-
Util 辅助工具	Generic 通用接口	execute 自行拼接参数，执行OpenAPI调用	-

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

您还可以前往API Doc查看每个API的详细使用说明。

变更日志

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

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

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

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

相关

• 支付宝开放平台
• 支付宝开放平台文档中心
• 最新源码

许可证

交流与技术支持

不管您在使用Alipay Easy SDK的过程中遇到任何问题，欢迎前往 支付宝开放社区 发帖与支付宝工作人员和其他开发者一起交流。

注：为了提高开发者问题的响应时效，github本身的issue功能已关闭，支付宝开放社区中发帖的问题，通常会在2小时内响应。