开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
文档中心
开发文档(v3版) 
支付
私域
小程序产品
权限集列表
支付有礼
小游戏
公域
营销
资金
会员
信用
安全
广告
小程序云
其他
api文档 > 私域 > 小程序产品 > 集成说明
收藏
订阅更新
我的文档
设置
本文展示了如何从零开始,使用支付宝开放平台服务端 sdk 快速接入 小程序产品
注意:文中的示例代码和 demo 仅适用大众场景,仅供开发者参考。特殊情况还请开发者自行扩展,确保符合自身业务需求。
商家自研接入
创建小程序
登录,创建小程序,详情可查看 创建小程序
说明:生成的应用唯一标识 appid 可用于调用产品接口。
配置小程序
产品绑定
创建小程序后,需要进行产品绑定,否则无权调用支付宝产品的接口。
1创建应用后,在 开发 > 产品绑定 > 绑定产品 > 找到 小程序,点击 修改
1.jpg

2在权限集中勾选需要添加的产品,点击 确定
2.jpg

3在选择产品页面,点击 确定,完成产品绑定。
3.jpg

开通产品
1在产品绑定页面,找到 小程序 权限集下 开通状态未开通 的产品。
2.jpg

2将鼠标放置于旁边的红色感叹号上。
3.jpg

3按照悬浮框的指引,点击 去开通
4.jpg

4跳转到商家平台,点击 权限集
5.jpg

5找到需要开通的产品,点击 开通
6-new.png

6根据页面提示填写相关信息,完成后点击 提交
7-new.png

说明:完成开通后,需要一个工作日左右的时间审核(审批结果会以短信和邮件形式告知),待审核完毕后,产品的状态将切换为 已生效,才可使用。
开发设置
开发 > 开发设置 中配置应用信息。
小程序开发设置.jpg

接口加签方式
必填。用于防止数据篡改,保障应用和支付宝交互的安全性,可查看 接口加签方式

服务器 ip 白名单
选填。用于提高应用访问开放平台的安全性,避免因应用私钥泄漏等原因导致业务受损,保障用户资金安全,可查看 服务器 ip 白名单
ip白名单.png

支付宝网关
必填。开发者调用 openapi 发送 http(s) 请求至支付宝的目标地址(gateway),固定为 https://openapi.alipay.com
应用网关
必填。用于接收支付宝异步通知消息,需要传入 http(s) 公网可访问网页地址,可查看

接口内容加密方式
选填。用于加 / 解密 openapi bizcontent 报文内容,可大幅提升接口内容传输的安全性。可查看 接口内容加密方式

服务器域名白名单
选填小程序 若需要获取客户端域外资源(例如获取图片、服务端数据等),需要配置服务器域名白名单。
服务器域名白名单.png

h5域名
选填。小程序 使用 web-view h5 页面承载组件 时需要配置 h5 页面中所有域名地址(含静态资源地址,如图片、.js 文件地址等),详情可查看 配置 h5 域名
h5域名.png

服务商代开发模式接入
创建应用
服务商登录 ,创建 第三方应用 并提交审核。详情可查看 创建&配置第三方应用
说明:生成的第三方应用唯一标识 appid 可用于调用开放产品接口。
开通产品
服务商可以通过以下方式,协助商家开通 小程序 产品:
服务商在开放平台为第三方应用绑定此产品。
通过以下方式协助商家开通:
请商家登录 开通此产品。
收集商家资料,登录 协助商家开通此产品。
收集商家资料,通过 协助商家开通此产品
获取代开发授权
服务商需根据 第三方应用授权 指引,获取商家代开发授权,以此获取 app_auth_token(商家授权令牌)用于调用商家券相关接口。
接口调用
服务商代商家调用服务端接口时:
1需传入第三方应用授权得到商家授权令牌(app_auth_token)作为请求参数传入;
2使用第三方应用的支付宝公钥、应用公钥、应用私钥、appid(证书模式使用第三方应用证书)构造 alipayclient,其余入参与接口文档相同。
更多详情可查看 代商家调用接口说明
集成并配置 sdk
开发者需要在自己的服务端系统中集成 sdk ,用于后续调用服务端接口。
下载服务端 sdk
为了帮助调用开放接口,支付宝提供了 开放平台服务端 sdk,包含 java、php、nodejs、python 和 .net 五种语言,封装了签名 & 验签、http 接口请求等基础功能。
说明:请先下载对应语言最新版本的 sdk 并引入开发工程。
接口调用配置
在 sdk 调用具体的 api(接口)前需要进行 alipayclient 对象初始化。alipayclient 对象只需要初始化一次,后续调用不同的 api 都可以使用同一个 alipayclient 对象。
公钥模式加签
接口加签方式为 公钥 模式加签时,alipayclient 对象初始化的 java 语言示例代码见下:
关键参数说明
配置参数
示例值解释
获取方式/示例值
url
支付宝网关(固定)。
https://openapi.alipay.com
appid
appid 即创建小程序后生成。
获取详情可查看 获取 appid
private_key
开发者私钥,由开发者自己生成。
获取详情可查看 接口加签方式
app_cert_path
应用公钥证书文件本地路径。
获取详情可查看 接口加签方式
alipay_cert_path
支付宝公钥证书文件本地路径。
获取详情可查看 接口加签方式
alipay_root_cert_path
支付宝根证书文件本地路径。
获取详情可查看 接口加签方式
公钥证书模式加签
接口加签方式为 公钥证书 模式加签时,alipayclient 对象初始化的 java 语言示例代码见下:
注意:若使用 公钥证书 模式进行加签,需额外引入如下 jar 包:



关键参数说明
配置参数
示例值解释
获取方式/示例值
url
支付宝网关(固定)。
https://openapi.alipay.com
appid
appid 即创建小程序后生成。
获取详情可查看 获取 appid
private_key
开发者私钥,由开发者自己生成。
获取详情可查看 接口加签方式
app_cert_path
应用公钥证书文件本地路径。
获取详情可查看 接口加签方式
alipay_cert_path
支付宝公钥证书文件本地路径。
获取详情可查看 接口加签方式
alipay_root_cert_path
支付宝根证书文件本地路径。
获取详情可查看 接口加签方式
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图