Recurly
使用私有 API 密钥连接 Recurly,支持美国或欧盟区域。
RevGlance 读取 Recurly 的 API 版本 2021-02-25:已付款的扣款发票、退款交易和订阅。
连接
- 在 Recurly 中,打开 Integrations › API Credentials 并添加一个私有 API 密钥,将其命名为 RevGlance。
- 复制该密钥,并记下您的站点子域名:
acme.recurly.com对应的是acme。 - 填写密钥、站点所在区域(
us或eu)以及子域名,然后选择 连接 Recurly。
表单需要填写的内容
| 字段 | 格式示例 |
|---|---|
| 私有 API 密钥加密存储 | 0123456789abcdef0123456789abcdef |
| 区域 | us 或 eu |
| 站点子域名 | acme(取自 acme.recurly.com) |
区域请输入 us 或 eu。托管在欧盟的站点使用 Recurly 的欧盟 API。
添加 webhook
- 在 RevGlance 中,打开 设置 › 来源,打开 Recurly 数据源的菜单并选择 Webhook。复制 URL。
- 在 Recurly 中,打开 Integrations › Webhooks,使用该 URL 添加一个 JSON 格式的端点。
- 复制该端点的签名密钥,在 RevGlance 中将其粘贴到 签名密钥 下并保存。
RevGlance 会校验 recurly-signature 请求头,并拒绝超过五分钟的调用。
RevGlance 同步哪些数据
- 已付款的扣款发票,按税前金额计算。
- 成功的退款交易,按与发票相同的比例扣除税费。
- 订阅,用于计算 MRR、方案、试用和取消。Recurly 的 API 不提供取消原因,也不报告网关手续费。
Recurly 的计算方式
- 已付款的扣款发票按税前计入。
- 退款为成功的退款交易。它们含税,因此 RevGlance 会按发票上的相同比例扣除税费。
- Recurly 不报告网关手续费,因此手续费显示为零。
- MRR 为 Recurly 中该订阅的小计(单价、数量和附加项,扣除优惠券后,税前)。
- 已取消的订阅在过期前继续计入;已过期、失败和已暂停的订阅计为流失。Recurly 不通过 API 提供取消原因。
- 未能收取的付款计为失败的扣款。不涉及资金变动。
- 不读取拒付,因此输掉的拒付仍计为扣款,除非服务商也将其报告为退款。
挽回邮件
挽回功能会将客户引导至您 Recurly 站点上其托管账户页面,这也是表单需要填写子域名的原因。

RevGlance