本文展示了如何从零开始，使用支付宝开放平台服务端 SDK 快速接入 小程序产品。

**注意：**文中的示例代码和 Demo 仅适用大众场景，仅供开发者参考。特殊情况还请开发者自行扩展，确保符合自身业务需求。

商家自研接入

创建小程序

登录支付宝开放平台，创建小程序，详情可查看创建小程序。

**说明：**生成的应用唯一标识 APPID 可用于调用产品接口。

配置小程序

产品绑定

创建小程序后，需要进行产品绑定，否则无权调用支付宝产品的接口。

创建应用后，在开发 > 产品绑定 > 绑定产品 > 找到 小程序，点击修改。

在权限集中勾选需要添加的产品，点击确定。

在选择产品页面，点击确定，完成产品绑定。

开通产品

在产品绑定页面，找到 小程序 权限集下 开通状态 为 未开通 的产品。

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

按照悬浮框的指引，点击 去开通。

跳转到商家平台，点击 权限集。

找到需要开通的产品，点击开通。

根据页面提示填写相关信息，完成后点击提交。

**说明：**完成开通后，需要一个工作日左右的时间审核（审批结果会以短信和邮件形式告知），待审核完毕后，产品的状态将切换为 已生效，才可使用。

开发设置

在开发 > 开发设置 中配置应用信息。

接口加签方式

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

服务器 IP 白名单

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

支付宝网关

**必填。**开发者调用 OpenAPI 发送 http(s) 请求至支付宝的目标地址（gateway），固定为 https://openapi.alipay.com/gateway.do。

应用网关

**必填。**用于接收支付宝异步通知消息，需要传入 http(s) 公网可访问网页地址，可查看应用网关。

接口内容加密方式

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

服务器域名白名单

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

H5域名

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

服务商代开发模式接入

1. 创建应用

服务商登录支付宝开放平台，创建 第三方应用 并提交审核。详情可查看创建&配置第三方应用。

**说明：**生成的第三方应用唯一标识 APPID 可用于调用开放产品接口。

2. 开通产品

服务商可以通过以下方式，协助商家开通 小程序 产品：

服务商在开放平台为第三方应用绑定此产品。

通过以下方式协助商家开通：

请商家登录商家平台开通此产品。

收集商家资料，登录服务商平台协助商家开通此产品。

收集商家资料，通过 OpenAPI 协助商家开通此产品。

3. 获取代开发授权

服务商需根据第三方应用授权指引，获取商家代开发授权，以此获取 app_auth_token（商家授权令牌）用于调用商家券相关接口。

4. 接口调用

服务商代商家调用服务端接口时：

需传入第三方应用授权得到商家授权令牌（app_auth_token）作为请求参数传入；

使用第三方应用的支付宝公钥、应用公钥、应用私钥、APPID（证书模式使用第三方应用证书）构造 AlipayClient，其余入参与接口文档相同。

更多详情可查看代商家调用接口说明。

集成并配置 SDK

开发者需要在自己的服务端系统中集成 SDK ，用于后续调用服务端接口。

下载服务端 SDK

为了帮助调用开放接口，支付宝提供了开放平台服务端 SDK，包含 Java、PHP、NodeJS、Python 和 .NET 五种语言，封装了签名 & 验签、HTTP 接口请求等基础功能。

**说明：**请先下载对应语言最新版本的 SDK 并引入开发工程。

接口调用配置

在 SDK 调用具体的 API（接口）前需要进行 alipayClient 对象初始化。alipayClient 对象只需要初始化一次，后续调用不同的 API 都可以使用同一个 alipayClient 对象。

公钥模式加签

接口加签方式为公钥模式加签时，alipayClient 对象初始化的 Java 语言示例代码见下：

ApiClient apiClient = Configuration.getDefaultApiClient();
//设置网关地址
apiClient.setBasePath(URL);
//设置alipayConfig参数（全局设置一次）
AlipayConfig alipayConfig = new AlipayConfig();
//设置应用ID
alipayConfig.setAppId(APPID);
//设置应用私钥
alipayConfig.setPrivateKey(PRIVATE_KEY);
//设置支付宝公钥
alipayConfig.setAlipayPublicKey(ALIPAY_PUBLIC_KEY);
apiClient.setAlipayConfig(alipayConfig);

defaultClient.setAlipayConfig(alipayConfig);
AlipayOpenSearchAppkeywordquotaApi api = new AlipayOpenSearchAppkeywordquotaApi();
AlipayOpenSearchAppkeywordquotaQueryResponseModel response = api.query(targetAppid);

关键参数说明

配置参数	示例值解释	获取方式/示例值
URL	支付宝网关（固定）。	`https://openapi.alipay.com/gateway.do`
APPID	APPID 即创建小程序后生成。	获取详情可查看获取 APPID。
PRIVATE_KEY	开发者私钥，由开发者自己生成。	获取详情可查看接口加签方式。
FORMAT	参数返回格式，只支持 JSON（固定）。	JSON
CHARSET	编码集，支持 GBK/UTF-8。	开发者根据实际工程编码配置。
ALIPAY_PUBLIC_KEY	支付宝公钥，由支付宝生成。	获取详情可查看接口加签方式。
SIGN_TYPE	生成签名字符串所使用的签名算法类型，目前支持 RSA2 和 RSA，推荐使用 RSA2。	RSA2

公钥证书模式加签

接口加签方式为 公钥证书 模式加签时，alipayClient 对象初始化的 Java 语言示例代码见下：

**注意：**若使用 公钥证书 模式进行加签，需额外引入如下 JAR 包：

bcprov-jdk15on

commons-logging

fastjson

ApiClient apiClient = Configuration.getDefaultApiClient();
//设置网关地址
apiClient.setBasePath(URL);
//设置alipayConfig参数（全局设置一次）
AlipayConfig alipayConfig = new AlipayConfig();
//设置应用ID
alipayConfig.setAppId(APPID);
//设置应用私钥
alipayConfig.setPrivateKey(PRIVATE_KEY);
//设置应用公钥证书路径
alipayConfig.setAppCertPath(app_cert_path);
//设置支付宝公钥证书路径
alipayConfig.setAlipayPublicCertPath(alipay_cert_path);
//设置支付宝根证书路径
alipayConfig.setRootCertPath(alipay_root_cert_path);
apiClient.setAlipayConfig(alipayConfig);

defaultClient.setAlipayConfig(alipayConfig);
AlipayOpenSearchAppkeywordquotaApi api = new AlipayOpenSearchAppkeywordquotaApi();
AlipayOpenSearchAppkeywordquotaQueryResponseModel response = api.query(targetAppid);

关键参数说明

配置参数	示例值解释	获取方式/示例值
URL	支付宝网关（固定）。	https://openapi.alipay.com
APPID	APPID 即创建小程序后生成。	获取详情可查看获取 APPID。
PRIVATE_KEY	开发者私钥，由开发者自己生成。	获取详情可查看接口加签方式。
app_cert_path	应用公钥证书文件本地路径。	获取详情可查看接口加签方式。
alipay_cert_path	支付宝公钥证书文件本地路径。	获取详情可查看接口加签方式。
alipay_root_cert_path	支付宝根证书文件本地路径。	获取详情可查看接口加签方式。

集成说明

商家自研接入#

创建小程序#

配置小程序#

产品绑定#

开通产品#

开发设置#

接口加签方式#

服务器 IP 白名单#

支付宝网关#

应用网关#

接口内容加密方式#

服务器域名白名单#

H5域名#

服务商代开发模式接入#

1. 创建应用#

2. 开通产品#

3. 获取代开发授权#

4. 接口调用#

集成并配置 SDK#

下载服务端 SDK#

接口调用配置#

公钥模式加签#

关键参数说明#

公钥证书模式加签#

关键参数说明#

商家自研接入

创建小程序

配置小程序

产品绑定

开通产品

开发设置

接口加签方式

服务器 IP 白名单

支付宝网关

应用网关

接口内容加密方式

服务器域名白名单

H5域名

服务商代开发模式接入

1. 创建应用

2. 开通产品

3. 获取代开发授权

4. 接口调用

集成并配置 SDK

下载服务端 SDK

接口调用配置

公钥模式加签

关键参数说明

公钥证书模式加签

关键参数说明