RevGlance文档

Recurly

使用私有 API 密钥连接 Recurly,支持美国或欧盟区域。

RevGlance 读取 Recurly 的 API 版本 2021-02-25:已付款的扣款发票、退款交易和订阅。

连接

  1. 在 Recurly 中,打开 Integrations › API Credentials 并添加一个私有 API 密钥,将其命名为 RevGlance。
  2. 复制该密钥,并记下您的站点子域名:acme.recurly.com 对应的是 acme。
  3. 填写密钥、站点所在区域(us 或 eu)以及子域名,然后选择 连接 Recurly。

表单需要填写的内容

字段格式示例
私有 API 密钥加密存储0123456789abcdef0123456789abcdef
区域us 或 eu
站点子域名acme(取自 acme.recurly.com)

区域请输入 us 或 eu。托管在欧盟的站点使用 Recurly 的欧盟 API。

添加 webhook

  1. 在 RevGlance 中,打开 设置 › 来源,打开 Recurly 数据源的菜单并选择 Webhook。复制 URL。
  2. 在 Recurly 中,打开 Integrations › Webhooks,使用该 URL 添加一个 JSON 格式的端点。
  3. 复制该端点的签名密钥,在 RevGlance 中将其粘贴到 签名密钥 下并保存。

RevGlance 会校验 recurly-signature 请求头,并拒绝超过五分钟的调用。

RevGlance 同步哪些数据

  • 已付款的扣款发票,按税前金额计算。
  • 成功的退款交易,按与发票相同的比例扣除税费。
  • 订阅,用于计算 MRR、方案、试用和取消。Recurly 的 API 不提供取消原因,也不报告网关手续费。

Recurly 的计算方式

  • 已付款的扣款发票按税前计入。
  • 退款为成功的退款交易。它们含税,因此 RevGlance 会按发票上的相同比例扣除税费。
  • Recurly 不报告网关手续费,因此手续费显示为零。
  • MRR 为 Recurly 中该订阅的小计(单价、数量和附加项,扣除优惠券后,税前)。
  • 已取消的订阅在过期前继续计入;已过期、失败和已暂停的订阅计为流失。Recurly 不通过 API 提供取消原因。
  • 未能收取的付款计为失败的扣款。不涉及资金变动。
  • 不读取拒付,因此输掉的拒付仍计为扣款,除非服务商也将其报告为退款。

挽回邮件

挽回功能会将客户引导至您 Recurly 站点上其托管账户页面,这也是表单需要填写子域名的原因。