RevGlanceLemon Squeezy
使用 API 密钥和已签名的 webhook 连接 Lemon Squeezy。
RevGlance 使用 API 密钥读取您 Lemon Squeezy 商店的产品、客户、订单、订阅和订阅发票。
连接
- 在 Lemon Squeezy 中，打开 Settings › API 并创建一个新的 API 密钥，将其命名为 RevGlance。
- 立即复制该密钥：Lemon Squeezy 只显示一次。
- 将其粘贴到 API 密钥 下，然后选择 连接 Lemon Squeezy。RevGlance 会读取产品、客户、订单、订阅及其发票。
表单需要填写的内容
| 字段 | 格式示例 |
|---|---|
| API 密钥加密存储 | eyJ0eXAiOiJKV1Qi… |
添加 webhook
- 在 RevGlance 中，打开 设置 › 来源，打开 Lemon Squeezy 数据源的菜单并选择 Webhook。复制 URL。
- 在 Lemon Squeezy 中，打开 Settings › Webhooks，使用该 URL 添加一个 webhook。自行生成一个较长的随机 signing secret，并选择订单、订阅和订阅付款事件。
- 在 RevGlance 中将同一个密钥粘贴到 签名密钥 下并保存。
RevGlance 同步哪些数据
- 变体，用于区分订阅和一次性产品，并读取每个方案的计费周期。
- 订阅，每次都完整读取，用于计算 MRR、方案、试用和取消。
- 客户、订单和订阅发票。 Lemon Squeezy 按从新到旧的顺序列出这些数据，且不支持日期筛选，因此后续同步会一直往回读取到上次同步的 60 天前，并每周重新读取一次全部数据，以捕获较早订单的退款。
Lemon Squeezy 的计算方式
- 扣款为订单或发票总额减去税费。
- Lemon Squeezy 报告的退款含税，因此 RevGlance 会按比例扣除税费。偶尔会有一分钱的取整误差。
- 全额退款按 Lemon Squeezy 退款的日期计。部分退款没有日期，因此显示在发票日期。
- 已取消的订阅在其已付费期间结束前继续计入。未付款的订阅（四次重试失败）计为流失，付款恢复后会重新计入。
- Lemon Squeezy 不发送取消日期或原因：取消日期为订阅最后变更的日期。
- Lemon Squeezy 不报告手续费，因此手续费显示为零。
- 折扣在续订显示后才会从 MRR 中扣除。Lemon Squeezy 不说明折扣是否重复，因此仅出现在第一张发票上的折扣不计入。
- 较早订单的退款通过每周一次的完整读取捕获，因此最多可能延迟一周显示。
- 在您连接之前已转化的试用不会显示，因为 Lemon Squeezy 只在试用进行期间标明试用。
- 不读取拒付，因此输掉的拒付仍计为扣款，除非服务商也将其报告为退款。