更新时间：2024-12-03 14:59: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 自动进行加验签。●集成调试说明：通用版 4.40.0.all 及以上版本支持通过diagnosisutils.gettraceid(response); 方法获取 openapi 接口请求的 trace_id，便于集成接入过程中的问题排查。确定接口对应的类例如接口名为：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的详细参数说明可查看。
