RevGlancePaddle
使用可读取交易、调整、订阅和客户的 API 密钥连接 Paddle Billing。
连接
- 在 Paddle 中，打开 Developer tools › Authentication 并创建一个 API 密钥。仅支持 Paddle Billing，不支持 Paddle Classic。
- 允许它读取 transactions、adjustments、subscriptions 和 customers。如果您要发送挽回邮件，请再添加
transaction.write。 - 复制该密钥。正式密钥以
pdl_live_apikey_开头；沙盒密钥同样可用，会从 Paddle 的沙盒同步数据。 - 将其粘贴到 API 密钥 下，然后选择 连接 Paddle。
表单需要填写的内容
| 字段 | 格式示例 |
|---|---|
| API 密钥加密存储 | pdl_live_apikey_… |
添加 webhook
- 在 RevGlance 中，打开 设置 › 来源，打开 Paddle 数据源的菜单并选择 Webhook。复制 URL。
- 在 Paddle 中，打开 Developer tools › Notifications，使用该 URL 添加一个目标。选择交易、调整和订阅事件。
- 复制该目标的 secret key，在 RevGlance 中将其粘贴到 签名密钥 下并保存。
RevGlance 同步哪些数据
- 已付款或已完成的 交易，包括其客户和地址。
- 调整：已批准的退款和拒付计为退款，被撤销时会再次扣除。
- 订阅，用于计算 MRR、方案、试用和取消，定期折扣会从 MRR 中扣除。
- 客户，包括活跃和已归档的客户。
Paddle 不保留取消原因，因此取消记录不带原因。
Paddle 的计算方式
- 金额来自 Paddle 的结算总额，按税前计，Paddle 的费用计为手续费。
- 退款和拒付按税前计入。Paddle 赢得的拒付或 Paddle 撤销的退款不再计入。
- Paddle 收取的拒付手续费计为手续费。
- 含税价格按下一期账单上的税费比例，以税前金额计入 MRR。
- 经常性折扣会从 MRR 中扣除，即使该折扣后来被归档。
- 未能收取的付款计为失败的扣款。不涉及资金变动。
挽回邮件
挽回功能会将每笔失败的付款链接到 Paddle 的更新付款方式结账页面。这需要密钥具有 transaction.write 权限；没有该权限时，邮件会链接到您自己的更新银行卡页面。