支付宝-观远数据连接器接入与接口授权说明

1. 适用范围

本文适用于需要将支付宝商家账户的买入交易、卖出交易和账务明细同步至观远数据的客户。对接前，请使用客户自己的支付宝开放平台账号创建正式应用，并准备该应用对应的密钥材料。

请勿在文档、聊天记录或截图中明文传播应用私钥。支付宝不会保存应用私钥；若私钥遗失或泄露，需要重新配置密钥。

2. 在支付宝开放平台准备对接资质

2.1 创建应用并查看 APPID

使用已实名认证的支付宝账号登录支付宝开放平台控制台，创建用于对接的应用。应用创建后，进入开放平台控制台可查看该应用的 APPID。

公开资料脱敏示例：在应用列表的 APPID 列复制与本次对接应用对应的值。

官方操作入口：创建应用与查看 APPID。完成应用创建后，在开放平台控制台的应用列表或应用详情中复制 APPID。

请确认填写的是当前正式对接应用的 APPID，不要混用测试应用、历史应用或其他账号下的 APPID。

2.2 配置密钥并保存应用私钥

进入应用详情页，按“开发设置 > 开发信息 > 接口加签方式（密钥/证书）”进入设置页，选择密钥模式，并使用支付宝开放平台密钥工具生成密钥。

公开资料脱敏示例：在开发助手“生成密钥”页复制应用私钥；密钥工具不会代为长期保存该值。

官方操作入口：设置密钥加签方式。在应用详情页的“开发设置 > 开发信息 > 接口加签方式（密钥/证书）”进入配置，并使用密钥工具生成、保存应用私钥。

请保存生成的应用私钥。它对应连接器中的 appPrivateKey；上传到支付宝开放平台的是应用公钥，不能将应用公钥误填为应用私钥。

2.3 获取支付宝公钥

完成接口加签方式配置后，在同一设置页的查看或下载位置获取支付宝公钥。它对应连接器中的 alipayPublicKey；不要误填“应用公钥”。

公开资料脱敏示例：在完成加签配置后的下载页，复制标注为支付宝公钥的字段。

官方操作入口：查看密钥/证书。在已完成加签配置的应用中打开设置或查看页面，复制“支付宝公钥”；不要复制“应用公钥”。

2.4 需要保存的字段

3. 创建观远连接器数据账户

进入观远连接器的“数据账户管理”，点击“新增数据账户”，所属平台选择“支付宝”。

3.1 字段映射关系

3.2 测试并保存

1. 填写账户名称，用于在观远连接器中区分该数据账户。
2. 按上表填写 appId、appPrivateKey 和 alipayPublicKey。
3. 点击“测试连接”；测试成功后点击“确定”保存。

4. 常见问题