RevGlance文档

Chargebee

使用只读 API 密钥和携带密钥的 webhook URL 连接 Chargebee。

RevGlance 读取 Chargebee 的 API v2:已付款发票、贷项通知单和订阅。使用 Product Catalog 2.0 和旧版目录的站点均可使用。

连接

  1. 在 Chargebee 中,打开 Settings › Configure Chargebee › API Keys,为站点的全部数据添加一个 read-only 密钥。
  2. 复制该密钥(以 live_ 开头),并记下您的站点名称:acme.chargebee.com 对应的是 acme。
  3. 填写站点和密钥,然后选择 连接 Chargebee。

表单需要填写的内容

字段格式示例
站点acme(取自 acme.chargebee.com)
API 密钥加密存储live_…

添加 webhook

Chargebee 不为其 webhook 签名,因此密钥随 URL 一起传递。

  1. 在 RevGlance 中,打开 设置 › 来源,打开 Chargebee 数据源的菜单并选择 Webhook。在 签名密钥 下保存一个较长的随机密钥。
  2. 复制 webhook URL,并在末尾加上 ?token= 和您的密钥。
  3. 在 Chargebee 中,打开 Settings › Configure Chargebee › Webhooks,使用该地址添加一个 webhook。除了使用 ?token=,您也可以开启基本身份验证,并将该密钥用作其密码。

RevGlance 同步哪些数据

  • 已付款发票,按税前金额计算。
  • 可退款的贷项通知单 计为退款,并按与贷项通知单相同的比例扣除税费。
  • 订阅,用于计算 MRR、方案、试用和取消,并附带您在 Chargebee 中设置的取消原因代码。

Chargebee 不报告网关手续费,因此手续费显示为零。

Chargebee 的计算方式

  • 已付款发票按税前计入。
  • 退款来自可退款的贷记单,按贷记单上的相同比例扣除税费。
  • Chargebee 不报告网关手续费,因此手续费显示为零。
  • MRR 为方案和附加项,减去整张发票上持续适用的优惠券。一次性费用不计入。
  • 不续订的订阅在其期限结束前继续计入。已暂停的订阅计为流失。您在 Chargebee 中设置的取消原因代码会显示为原因。
  • 未能收取的付款计为失败的扣款。不涉及资金变动。
  • 拒付只有在可退款的贷记单记录时才计入。