RevGlance文档

连接数据源

无论您使用哪家服务商,数据源、密钥、webhook 和同步是如何运作的。

数据源 是某个支付服务商上的一个账户,连接到一个业务。一个业务可以有多个数据源,也可以来自同一家服务商:例如一个 Stripe 账户加一个 App Store 应用,或两个 Stripe 账户。所有者和管理员可以连接数据源;查看者只能查看。

支持的服务商

标记为 beta 的服务商已根据其文档构建和测试,但尚未在真实账户上运行过。如果某个数字与服务商自己的报告不一致,请告诉我们。

密钥

每个数据源都通过您在服务商处创建的密钥连接。RevGlance 会加密存储凭据,之后不再显示,并且只读取数据。只要服务商提供,请优先使用受限密钥或只读密钥。

有两项功能可以写入,且仅在您为密钥授予相应权限时才会写入:

  • 挽回邮件可以创建更新银行卡链接(Stripe 门户会话、Polar 客户会话、Paddle 更新付款的交易)。
  • 在隐私模式下,发送挽回邮件或调查邮件时会在发送时向服务商获取客户地址。

同步

  • 首次同步 会读取服务商保留的所有数据,除非服务商有所限制(App Store 只保留一年的每日报告)。
  • 后续同步 从上一次同步的三天前开始读取,因此不会漏掉延迟的变更。订阅等当前状态会完整读取。
  • 只要有人在使用该业务,数据源就会 每小时 同步一次。如果 30 天内无人登录,则每天同步一次;有人回来时,会同步超过一小时未更新的数据。
  • 顶栏同步状态中的 立即同步 会同时同步该业务的所有数据源。

当服务商拒绝请求时,数据源会在 设置 › 来源 中其名称下方显示错误。部分同步会保留进度,因此下一次运行会再次读取同一时间窗口。

Webhook

webhook 可以让服务商通知 RevGlance 有内容发生了变化,RevGlance 会立即为该数据源排队同步。在 设置 › 来源 中,打开某个数据源的菜单并选择 Webhook,即可找到其 webhook URL。服务商通过以下三种方式之一验证 webhook:

方式服务商您需要做什么
签名密钥Stripe, Polar, Lemon Squeezy, Paddle, Recurly将服务商的签名密钥粘贴到 RevGlance 中
URL 中的密钥Gumroad, App Store, Google Play, Chargebee在 RevGlance 中保存一个随机密钥,然后在提供给服务商的 URL 后加上 ?token= 和该密钥
数据源自身的密钥Braintree, Shopify无需操作:服务商使用数据源已有的密钥签名

计算方式

每家服务商报告金额的方式都略有不同:退款含税或不含税、有无手续费、有无取消日期。RevGlance 在所有地方都以相同方式统一这些差异,并在无法统一时加以说明。每篇集成指南都列出了对应服务商的规则,我们如何计算则在一个页面上汇总了全部规则。

移除数据源

在其菜单中选择 移除数据源 并按住按钮。其付款和订阅会随之移除;重新连接后会恢复。