RevGlance
Polar
組織アクセストークンで Polar を接続し、Webhook を追加して即時に同期します。
RevGlance は組織アクセストークンを使って、Polar 組織の顧客、サブスクリプション、注文を読み込みます。Polar 上で何かを変更することはありません。
接続
- Polar で組織の Settings を開き、organization access token を作成します。名前は RevGlance にします。
customers:read、subscriptions:read、orders:readのスコープを付与します。回収メールを送信する場合はcustomer_sessions:writeも追加します。- トークンをコピーします。
polar_oat_で始まります。 - 組織アクセストークンに貼り付け、Polarを接続を選びます。
フォームで入力する項目
| 項目 | 形式の例 |
|---|---|
| 組織アクセストークン暗号化して保存 | polar_oat_… |
Webhook を追加する
- RevGlance で 設定 › ソース を開き、Polar ソースのメニューを開いて Webhook を選びます。URL をコピーします。
- Polar で組織の Settings › Webhooks を開き、その URL でエンドポイントを追加します。注文、サブスクリプション、返金のイベントを選びます。
- Webhook のシークレット（
whsec_…）をコピーし、RevGlance の署名シークレットに貼り付けて保存します。
Polar は Standard Webhooks の方式で呼び出しに署名します。RevGlance は Polar が whsec_ シークレットからキーを導出する旧方式と現行方式の両方を受け付けるため、2026 年 9 月の Polar の変更前に作ったシークレットでも変更後のものでも使えます。
RevGlance が同期するもの
- 顧客。請求先の国とメタデータを含み、セグメントのフィルターに使えます。
- サブスクリプション。MRR、シート数、割引、トライアル、解約に使い、顧客が理由とコメントを残した場合はそれも含みます。
- 注文とその返金。最初の同期ではすべての注文を読み込み、2 回目以降は前回の同期の 3 日前から読み込み、週に 1 回はすべての注文を読み込み直します。返金は注文にしか表示されないためです。
Polar の集計方法
- 注文は税抜きで計上し、Polarのプラットフォーム手数料を手数料とします。注文と異なる通貨の手数料は0と表示されます。
- 返金は請求と同様に税抜きで計上します。Polarは返金日を提供しないため、返金の日付は注文が最後に変更された日になります。
- 古い注文の返金は週1回の全件読み込みで検出するため、最大1週間遅れて表示されることがあります。
- チャージバックは読み込まないため、敗訴したものは、プロバイダーが返金としても報告しない限り請求として計上されたままになります。
- 失敗した請求は報告されないため、その数値は0のままです。
- MRRはサブスクリプション金額で、Polarによってすでに定期割引が差し引かれています。1回限りの割引はMRRを下げません。
- 税込み価格ではMRRに税が含まれます。どのサブスクリプションが税込み価格かをPolarが示さないためです。請求と返金は税抜きで計上します。
回収メール
回収は、顧客を Polar のカスタマーポータルセッションに案内してカードを更新してもらいます。そのためにはトークンに customer_sessions:write が必要です。ない場合、メールはあなた自身のカード更新ページにリンクします。