RevGlanceソースの接続
どのプロバイダーを使っていても共通の、ソース、キー、Webhook、同期の仕組み。
ソースとは、決済プロバイダー上の 1 つのアカウントを 1 つのビジネスに接続したものです。1 つのビジネスに複数のソースを接続でき、同じプロバイダーのものでも構いません。たとえば Stripe アカウントと App Store のアプリ、あるいは 2 つの Stripe アカウントです。ソースを接続できるのはオーナーと管理者で、閲覧者は表示のみできます。
対応プロバイダー
ベータと表示されたプロバイダーは、プロバイダーのドキュメントに沿って構築・テストしたものの、まだ実際のアカウントでは動かしていません。数値がプロバイダー自身のレポートと異なる場合はお知らせください。
キー
すべてのソースは、プロバイダーで作成したキーで接続します。RevGlance は認証情報を暗号化して保存し、二度と表示せず、読み取りのみを行います。プロバイダーが用意している場合は、制限付きキーまたは読み取り専用キーを使ってください。
書き込みを行える機能は 2 つだけで、キーで許可した場合に限ります。
- 回収メールは、カード更新リンク（Stripe のポータルセッション、Polar のカスタマーセッション、Paddle の支払い方法更新トランザクション）を作成できます。
- プライバシーモードでは、回収メールやアンケートメールを送信する際に、送信時点で顧客のアドレスをプロバイダーに問い合わせます。
同期
- 最初の同期では、プロバイダーが保持しているすべてのデータを読み込みます。ただしプロバイダー側の制限がある場合は除きます（App Store が保持する日次レポートは 1 年分です）。
- 2 回目以降の同期では、前回の同期の 3 日前から読み込むため、後から入った変更も取りこぼしません。サブスクリプションなどの現在の状態は毎回すべて読み込みます。
- 誰かがそのビジネスを使っている間、ソースは1 時間ごとに同期します。30 日間誰もサインインしていない場合は 1 日 1 回の同期になり、戻ってくると 1 時間以上前のものが同期されます。
- 上部バーの同期ステータスにある今すぐ同期で、そのビジネスのすべてのソースを一度に同期できます。
プロバイダーがリクエストを拒否した場合、設定 › ソースでそのソース名の下にエラーが表示されます。途中で止まった同期は位置を保持するため、次回は同じ期間をもう一度読み込みます。
Webhook
Webhook を使うと、プロバイダーが変更を RevGlance に知らせ、RevGlance はそのソースの同期をすぐにキューに入れます。ソースの Webhook URL は、設定 › ソースでそのソースのメニューにある Webhook から確認できます。プロバイダーによる Webhook の検証方法は次の 3 通りです。
| 方法 | プロバイダー | 必要な作業 |
|---|---|---|
| 署名シークレット | Stripe, Polar, Lemon Squeezy, Paddle, Recurly | プロバイダーの署名シークレットを RevGlance に貼り付ける |
| URL 内のシークレット | Gumroad, App Store, Google Play, Chargebee | ランダムなシークレットを RevGlance に保存し、プロバイダーに渡す URL に ?token= とシークレットを付け加える |
| ソース自身のキー | Braintree, Shopify | 不要：プロバイダーはソースがすでに持っているキーで署名します |
集計
プロバイダーごとに金額の報告の仕方は少しずつ異なります。返金に税を含むかどうか、手数料の有無、解約日の有無などです。RevGlance はこれらをどこでも同じ方法でそろえ、そろえられない部分はその旨を示します。各連携ガイドにそのプロバイダーのルールを載せており、集計方法にはそのすべてを 1 ページにまとめています。
ソースの削除
ソースのメニューでソースを削除を選び、ボタンを長押しします。そのソースの支払いとサブスクリプションも一緒に削除されます。もう一度接続すれば元に戻ります。