更新时间:2024-11-08 14:18:25收藏订阅更新我的文档设置返回文档alipay sdk(通用版)通用版服务端 sdk 适用于 java、php、c#、python、node.js 编程语言,可调用所有 openapi 接口。获取 alipay sdk开发语言资源下载环境要求java 版资源●●适用于 java 语言、jdk 版本 1.8 及以上的开发环境。.net 版资源●●●适用于符合.net standard 2.0规范的各类微软框架(如:.net framework >= 4.6.1、.net core >= 2.0 等)。●.net framework(3.5 ~ 4.6)的用户可以继续使用 。php 版资源●适用于 php 5.5 以上的开发环境。python 版资源●适用于 python 2.7 及以上版本的开发环境。nodejs 版资源●适用于 node.js v8.0.0 及以上版本的开发环境。说明:其它编程语言的 sdk(比如 go 语言 sdk 等),支付宝官方暂未支持,您可以前往开源社区寻找开源版本。另外,支付宝现已推出符合 oas3.0 规范的 api(v3版本),拥有更简洁的协议格式处理/签名/验签处理逻辑,推荐无法使用 sdk 的用户,直接对接 v3版本的openapi。alipay sdk 调用示例alipay sdk 集成说明●由于实例化 sdk 客户端时需要指定应用的私钥信息,请务必注意不要将私钥信息配置在源码中(例如配置为常量或储存在配置文件的某个字段中等),因为私钥的保密等级往往比源码高得多,将会增加私钥泄露的风险。推荐将私钥信息储存在专用的私钥文件中,将私钥文件通过安全的流程分发到服务器的安全储存区域上,仅供自己的应用运行时读取。●sdk 已经对加签验签逻辑做了封装,使用 sdk 时传入支付宝公钥等内容可直接通过 sdk 自动进行加验签。确定接口对应的类例如接口名为:alipay.offline.material.image.upload在 sdk 中对应的类为:每个单词首字母大写,并去掉分隔符(“.”),末尾加上 request(或 response)。如上接口名对应的类为alipayofflinematerialimageuploadrequest(请求类)alipayofflinematerialimageuploadresponse(响应类)具体调用方式见下方各语言集成示例。签名方法加签验签详情可查看 数据签名。alipay easy sdk easy 版服务端 sdk()适用于 java、c#、php 编程语言,对开放产品的 api 进行了更加贴近高频场景的精心设计与裁剪,简化了服务端调用方式,让开发者享受极简编程体验,快速访问支付宝开放平台开放的各项核心产品。同时,开发者不必担心面向高频场景提炼的 api 无法完全契合自身个性化场景的问题,alipay easy sdk 支持灵活的动态扩展方式,同样可以满足低频参数、低频 api 的使用需求。注意:alipay easy sdk 需使用 maven 依赖引入,请勿直接下载 jar 包导入项目。easy 版、通用版服务端 sdk 相关说明●通用版 sdk 中:○certificateexecute 和 execute 方法,可使用 easy 版服务端 sdk 提供的 factory.util.generic.execute 方法替换。○sdkexecute 方法,可以用 easy 版服务端 sdk 提供的 factory.util.generic.sdkexecute 方法替换。○文件上传场景,可以用 easy 版服务端 sdk factory.util.generic.fileexecute 方法替换。 ○更多场景查看下文对应语言 动态扩展 sdk 功能满足个性化需求。●通用版 sdk 中的门店照片和视频文件的上传,可使用easy版服务端 sdk 中的 factory.base.image.upload 和 factory.base.video.upload 覆盖。●通用版 sdk 中的支付类异步通知验签 alipaysignature.rsacertcheckv1 和 alipaysignature.rsacheckv1 方法,可使用easy版本服务端 sdk 提供的 factory.payment.common.verifynotify 方法替换。●两个版本 sdk 并无冲突,可以共存。获取 alipay easy sdk开发语言资源下载环境要求java适用于 jdk 1.8 及其以上版本注意:需使用 maven 依赖引入,请勿直接下载 jar 包导入项目。c#适用于 .net framework 4.6.1、.net core 2.0 及其以上版本php适用于 php 7.0 及其以上版本alipay easy sdk api 使用规范在 alipay easy sdk 中,api 的引用路径遵循如下命名规范:注意:不同语言连接符可能不一致,以各语言示例为准。alipay easy sdk api 总览能力类别场景类别接口方法名称base(基础能力)oauth(用户授权)gettoken(获取授权访问令牌和用户 user_id)base(基础能力)oauth(用户授权)refreshtoken(刷新授权访问令牌)base(基础能力)qrcode(小程序二维码)create(创建小程序二维码)base(基础能力)image(图片)upload(上传门店照片)base(基础能力)video(视频)upload(上传门店视频)member(会员能力)identification(支付宝身份认证)init(身份认证初始化)member(会员能力)identification(支付宝身份认证)certify(生成认证链接)member(会员能力)identification(支付宝身份认证)query(身份认证记录查询)payment(支付能力)common(通用)create(创建交易)payment(支付能力)common(通用)query(查询交易)payment(支付能力)common(通用)refund(交易退款)payment(支付能力)common(通用)close(关闭交易)payment(支付能力)common(通用)cancel(撤销交易)payment(支付能力)common(通用)queryrefund(交易退款查询)payment(支付能力)common(通用)downloadbill(查询对账单下载地址)payment(支付能力)common(通用)verifynotify(异步通知验签)payment(支付能力)huabei(花呗分期)create(创建花呗分期交易)payment(支付能力)facetoface(当面付)pay(扫用户出示的付款码,完成付款)payment(支付能力)facetoface(当面付)precreate(生成交易付款码,待用户扫码付款)payment(支付能力)app(手机app)pay(生成订单串,再使用客户端 sdk 凭此串唤起支付宝收银台)payment(支付能力)page(电脑网站)pay(生成交易表单,渲染后自动跳转支付宝网站引导用户完成支付)payment(支付能力)wap(手机网站)pay(生成交易表单,渲染后自动跳转支付宝网站引导用户完成支付)security(安全能力)textrisk(文本内容安全)detect(检测内容风险)marketing(营销能力)pass(支付宝卡包)createtemplate(卡券模板创建)marketing(营销能力)pass(支付宝卡包)updatetemplate(卡券模板更新)marketing(营销能力)pass(支付宝卡包)addinstance(卡券实例发放)marketing(营销能力)pass(支付宝卡包)updateinstance(卡券实例更新)marketing(营销能力)templatemessage(小程序模板消息)send(发送模板消息)marketing(营销能力)openlife(生活号)createimagetextcontent(创建图文消息内容)marketing(营销能力)openlife(生活号)modifyimagetextcontent(更新图文消息内容)marketing(营销能力)openlife(生活号)sendtext(群发本文消息)marketing(营销能力)openlife(生活号)sendimagetext(群发图文消息)marketing(营销能力)openlife(生活号)sendsinglemessage(单发模板消息)marketing(营销能力)openlife(生活号)recallmessage(生活号消息撤回)marketing(营销能力)openlife(生活号)setindustry(模板消息行业设置)marketing(营销能力)openlife(生活号)getindustry(生活号查询行业设置)util(辅助工具)aes(加解密)decrypt(解密,常用于会员手机号解密)util(辅助工具)aes(加解密)encrypt(加密)util(辅助工具)generic(通用接口)execute(自行拼接参数,执行openapi调用)util(辅助工具)generic(通用接口)sdkexecute(自行拼接参数,生成加签串,功能等同于通用版 sdk 中的 sdkexecute 方法)注意:各个api的详细参数说明可查看。