粘贴一个只读的 Paddle API 密钥，即可按产品和国家导入软件与 SaaS 销售、退款和税额。

Paddle 是您在应用商店之外销售的软件（桌面应用、Web 应用、SaaS 套餐和许可证）的 merchant of record。它通过一个只读 API 密钥连接，而不是 OAuth。您在 Paddle 后台创建密钥，粘贴到 Revenue Sensor，然后选择要同步的 Paddle 产品即可。密钥加密存储，绝不会离开我们的服务器；也绝不会用到您的 Paddle 登录信息。

开始之前

拥有您要追踪销售的卖家账户的 Paddle 后台访问权限，并有权在 Developer tools 中创建 API 密钥。
确定您要用正式（live）账户还是沙盒。Paddle 为两者分别签发密钥，读取哪一个由密钥决定；除此之外无需再做选择。

创建只读 API 密钥

1
打开 Developer tools
在 Paddle 后台进入 Developer tools → Authentication，创建一个新的 API 密钥。起一个以后能认出的名字，例如“Revenue Sensor”。
2
只授予读取权限
勾选 Transactions、Adjustments、Products 和 Addresses 的读取权限。Addresses 位于 Customers 之下，用于获取买家所在国家，所以即使看起来无关也请保留。不需要任何写入权限。
3
只复制一次密钥
Paddle 只在创建时显示密钥一次。请立即复制；如果丢失，请吊销并重新创建。

连接账户

1
粘贴密钥
在 Revenue Sensor 控制台进入 Integrations → Paddle → Connect，粘贴 API 密钥。Revenue Sensor 会根据密钥前缀区分正式密钥和沙盒密钥，并在您继续之前确认将使用哪一个。
2
选择您的产品
同步的单位是 Paddle 产品，而不是商店应用。选择您想放进账本的产品；每个产品在收入中单独成行，如果它属于某个应用，也可以映射到该应用。只拉取您选择的内容，也只有您选择的内容计入套餐额度。
3
等待首次同步完成
Paddle 保留您的全部历史记录，因此首次同步会回填最多一年的已支付交易和退款。通常只需几分钟，运行期间您可以离开页面。

会导入什么

字段	说明
收入	已支付的交易，按款项实际收到的日期记账，而不是开具发票的日期。按产品、按天、按买家国家展示，不含税。不扣除 Paddle 自身的费用，正如 Google Play 按扣除 Google 费用前的毛额展示一样。
税	Paddle 作为 merchant of record 代收销售税和增值税，并在每个行项目上列明，因此税额会单独导入，此来源可使用含税视图。
退款与拒付	已批准的退款和拒付（chargeback）在批准当天减少收入，同时金额也作为退款数字保留以供参考。被撤销的拒付会把款项加回。信用额和拒付预警不视为退款。
国家	取自客户的账单地址。只使用国家代码。

支持 Paddle 的所有货币

交易按其计费货币导入，并像其他来源一样进行换算。JPY、KRW 等无小数位货币会被正确读取，因此日本的一笔销售不会被记为实际价值的百分之一。

实时更新（可选）

Revenue Sensor 每 30 分钟同步一次 Paddle。如果您希望在一两分钟内就看到新的销售或退款，可以把 Paddle 的通知目标（notification destination）指向我们。数据仍然来自 Paddle 的 API；webhook 只是告诉我们提前同步。

1
复制 webhook URL
在 Revenue Sensor 控制台打开 Paddle 连接。“Real-time updates”面板会显示一个仅属于此连接的 URL，复制它。
2
创建通知目标
在 Paddle 中进入 Developer tools → Notifications → New destination。粘贴 URL，类型选择 Webhook，并订阅 transaction、adjustment 和 subscription 事件。
3
保存密钥
创建通知目标时，Paddle 会显示一个签名密钥。把它粘贴到“Real-time updates”面板并保存。我们用它验证每一次推送，并丢弃任何未签名的内容；它加密存储，不会再次显示。

故障排查

密钥被拒绝：检查它是否对 Transactions、Adjustments、Products 和 Addresses 四项都有读取权限。缺少 Addresses 的密钥能通过基本检查，但同步会失败。
没有列出任何产品：密钥属于另一个账户，或者您以为是正式环境但它其实是沙盒密钥（或反过来）。密钥前缀会告诉您是哪一个。
缺少某笔销售：只导入已支付、已完成的交易。草稿、未支付的发票和已取消的交易还不算收入。
收入看起来高于您的到账金额：这是正常的。税额单独保留，Paddle 的费用也未扣除，因此该数字是扣除 Paddle 分成之前的总收入。
退款显示的日期与销售不同：退款按批准当天记账，不会回溯到原始购买日。

连接 Paddle