本文档展示了如何从零开始,使用支付宝开放平台服务端 sdk 快速接入 iot设备绑定门店 功能。
注意:文档中的代码示例和 demo 是用来阐述 api 基本使用方法的,仅针对大众场景,供 isv(服务商) 参考,特殊情况还请 isv 自行扩展,确保符合自身业务需求。
要在您的应用中使用支付宝开放产品的接口能力,需要登录 ,创建应用 并提交审核,审核通过后生成应用唯一标识(appid),并且可以申请开通开放产品使用权限,需要通过 appid 调用开放产品的接口能力。开放平台创建应用详细步骤请参见 。
添加功能
应用创建完成后,系统会自动跳转到应用详情页面。您可以在 能力列表 中点击 添加能力 来添加 服务商代运营基础 和 蚂蚁门店管理 功能。
配置密钥
为了保证交易双方(商户和支付宝)的身份和数据安全,开发者在调用接口前,需要配置双方密钥,对交易数据进行双方校验。密钥包含应用私钥(app_private_key)和应用公钥(app_public_key)。生成密钥后,开发者需要在开放平台开发者中心进行密钥配置,配置完成后可以获取支付宝公钥(alipay_public_key),配置的详细步骤请参见 支付宝开放平台开发助手 的 密钥工具 文档。密钥的配置旨在对交易数据进行双方校验。具体流程如下图所示:

应用公钥(商户自身的 rsa/rsa2 公钥): 支付宝使用该公钥确认该交易是由商户发起。
支付宝公钥(支付宝的 rsa/rsa2 公钥):商户使用该公钥确认该结果是由支付宝返回。
说明:支付宝开放平台 sdk 封装了签名和验签过程,只需配置账号及密钥参数,建议开发者使用。开发者还可以通过 和 自助排查配置应用过程中遇到的问题。
服务端 sdk 需要商户集成在自己的服务端系统中,用于后续的服务端接口调用。
1. 下载服务端 sdk
为了帮助开发者调用开放接口,我们提供了 开放平台服务端 sdk,包含 java、php、nodejs、python 和 .net 五种语言,封装了签名&验签、http 接口请求等基础功能。
请先下载对应语言版本的 sdk 并引入您的开发工程。
2. 接口调用配置
在 sdk 调用前需要进行初始化,以 java 代码为例:
alipayclient alipayclient = new defaultalipayclient(url,app_id,app_private_key,format,charset,alipay_public_key,sign_type);
关键参数说明:
| 配置参数 | 示例值解释 | 获取方式/示例值 |
| url | 支付宝网关(固定)。 | 示例值:https://openapi.alipay.com/gateway.do |
| appid | 应用唯一标识。 | 创建应用后生成,获取见 。 |
| app_private_key | 开发者私钥,由开发者自己生成。 | 由开发者自行生成,获取见 。 |
| format | 参数返回格式,只支持 json。 | 固定值:json。 |
| charset | 编码集,支持 gbk/utf-8。 | 支持 gbk/utf-8,开发者根据实际工程编码配置。 |
| alipay_public_key | 支付宝公钥,由支付宝生成。 | 由支付宝生成,获取详见 。 |
| sign_type | 商户生成签名字符串所使用的签名算法类型。 | 目前支持 rsa2 和 rsa,推荐使用 rsa2。 |
接下来,即可使用 alipayclient 来调用具体的 api 。
alipayclient 只需要初始化一次,后续调用不同的 api 都可以使用同一个 alipayclient 对象。
说明:
如果您在调用 api 时出现报错:
欢迎前往 提问、留言。
在 中根据错误码的类型,查找相关错误码及凯发app官方网站的解决方案。
在 问答页面直接输入您遇到的错误码。
在 中排查遇到的问题。
您还可以在 直接搜索您要的答案。