连接数据源
无论您使用哪家服务商,数据源、密钥、webhook 和同步是如何运作的。
数据源 是某个支付服务商上的一个账户,连接到一个业务。一个业务可以有多个数据源,也可以来自同一家服务商:例如一个 Stripe 账户加一个 App Store 应用,或两个 Stripe 账户。所有者和管理员可以连接数据源;查看者只能查看。
支持的服务商
Stripe订阅、扣款、退款和手续费。Polar来自 Polar 的订单和订阅。Lemon Squeezy订单、订阅和退款。App StoreBeta来自 App Store Connect 的 iOS 和 Mac 销售。Google PlayBetaPlay Console 的销售和订阅。GumroadBeta销售、退款和会员资格。PaddleBetaPaddle Billing 的交易和订阅。BraintreeBeta交易、退款和定期计费。RecurlyBeta发票、退款和订阅。ChargebeeBeta发票、贷项通知单和订阅。ShopifyBeta订单、退款、手续费和订阅合约。
标记为 beta 的服务商已根据其文档构建和测试,但尚未在真实账户上运行过。如果某个数字与服务商自己的报告不一致,请告诉我们。
密钥
每个数据源都通过您在服务商处创建的密钥连接。RevGlance 会加密存储凭据,之后不再显示,并且只读取数据。只要服务商提供,请优先使用受限密钥或只读密钥。
有两项功能可以写入,且仅在您为密钥授予相应权限时才会写入:
同步
- 首次同步 会读取服务商保留的所有数据,除非服务商有所限制(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 在所有地方都以相同方式统一这些差异,并在无法统一时加以说明。每篇集成指南都列出了对应服务商的规则,我们如何计算则在一个页面上汇总了全部规则。
移除数据源
在其菜单中选择 移除数据源 并按住按钮。其付款和订阅会随之移除;重新连接后会恢复。

RevGlance