README.md 16 KB
欢迎使用 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 :smiley:
Factory.Payment.Common().create("Iphone6 16G", "202003019443", "0.10", "2088002656718920");
- Alipay SDK :confused:
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编程语言，更多编程语言支持正在积极新增中，敬请期待。
各语言具体的使用说明和详细介绍请点击如下链接进入各语言主目录查看。
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 提交 Issues。
您也可以使用钉钉扫描下方二维码，与更多开发者和支付宝工程师共同交流。
