RevGlance
Polar
使用组织访问令牌连接 Polar，并添加 webhook 以实现即时同步。
RevGlance 使用组织访问令牌读取您 Polar 组织的客户、订阅和订单。它从不更改 Polar 中的任何内容。
连接
- 在 Polar 中，打开您组织的 Settings，创建一个 organization access token，将其命名为 RevGlance。
- 为其授予
customers:read、subscriptions:read和orders:read权限范围。如果您要发送挽回邮件，请再添加customer_sessions:write。 - 复制该令牌。它以
polar_oat_开头。 - 将其粘贴到 组织访问令牌 下，然后选择 连接 Polar。
表单需要填写的内容
| 字段 | 格式示例 |
|---|---|
| 组织访问令牌加密存储 | polar_oat_… |
添加 webhook
- 在 RevGlance 中，打开 设置 › 来源，打开 Polar 数据源的菜单并选择 Webhook。复制 URL。
- 在 Polar 中，打开您组织的 Settings › Webhooks，使用该 URL 添加一个端点。选择订单、订阅和退款事件。
- 复制该 webhook 的密钥（
whsec_…），在 RevGlance 中将其粘贴到 签名密钥 下并保存。
Polar 按照 Standard Webhooks 规范为其调用签名。Polar 从 whsec_ 密钥派生签名密钥的方式有旧版和新版两种，RevGlance 都接受，因此无论密钥是在 Polar 2026 年 9 月的变更之前还是之后创建的，都可以使用。
RevGlance 同步哪些数据
- 客户，包括其账单国家和元数据，可用于细分筛选。
- 订阅，用于计算 MRR、席位、折扣、试用和取消，并附带客户提供的原因和评论（如有）。
- 订单 及其退款。首次同步会读取所有订单；后续同步从上一次同步的三天前开始读取，并每周重新读取一次所有订单，因为退款只会显示在其订单上。
Polar 的计算方式
- 订单按税前计入，Polar 的平台费计为手续费。与订单货币不同的手续费显示为零。
- 退款与扣款一样按税前计入。Polar 不提供退款日期，因此退款以订单最后变更的日期为准。
- 较早订单的退款通过每周一次的完整读取捕获，因此最多可能延迟一周显示。
- 不读取拒付，因此输掉的拒付仍计为扣款，除非服务商也将其报告为退款。
- 失败的扣款不会被报告，因此该数字始终为零。
- MRR 为订阅金额，Polar 已从中扣除经常性折扣。一次性折扣不会降低 MRR。
- MRR 包含含税价格中的税费：Polar 未说明哪些订阅使用含税价格。扣款和退款按税前计入。
挽回邮件
挽回功能会将客户引导至 Polar 客户门户会话以更新银行卡。为此，令牌需要具有 customer_sessions:write 权限；没有该权限时，邮件会链接到您自己的更新银行卡页面。