RevGlanceLemon Squeezy
API キーと署名付き Webhook で Lemon Squeezy を接続します。
RevGlance は API キーを使って、Lemon Squeezy ストアの商品、顧客、注文、サブスクリプション、サブスクリプションの請求書を読み込みます。
接続
- Lemon Squeezy で Settings › API を開き、新しい API キーを作成します。名前は RevGlance にします。
- キーはすぐにコピーしてください。Lemon Squeezy では一度しか表示されません。
- APIキーに貼り付け、Lemon Squeezyを接続を選びます。RevGlance は商品、顧客、注文、サブスクリプションとその請求書を読み込みます。
フォームで入力する項目
| 項目 | 形式の例 |
|---|---|
| APIキー暗号化して保存 | eyJ0eXAiOiJKV1Qi… |
Webhook を追加する
- RevGlance で 設定 › ソース を開き、Lemon Squeezy ソースのメニューを開いて Webhook を選びます。URL をコピーします。
- Lemon Squeezy で Settings › Webhooks を開き、その URL で Webhook を追加します。長いランダムな signing secret を考え、注文、サブスクリプション、サブスクリプション支払いのイベントを選択します。
- 同じシークレットを RevGlance の署名シークレットに貼り付けて保存します。
RevGlance が同期するもの
- バリアント。サブスクリプションと単発商品を区別し、各プランの間隔を読み取ります。
- サブスクリプション。毎回すべて読み込み、MRR、プラン、トライアル、解約に使います。
- 顧客、注文、サブスクリプションの請求書。 Lemon Squeezy はこれらを日付フィルターなしで新しい順に返すため、2 回目以降の同期では前回の同期の 60 日前までさかのぼって読み込み、古い注文の返金を検出するために週に 1 回すべてを読み込み直します。
Lemon Squeezy の集計方法
- 請求は、注文または請求書の合計から税を差し引いた額です。
- Lemon Squeezyは返金を税込みで報告するため、RevGlanceが税を按分して差し引きます。ときどき1セントの端数差が出ることがあります。
- 全額返金はLemon Squeezyが処理した日付になります。一部返金には日付がないため、請求書の日付で表示されます。
- 解約されたサブスクリプションは、支払い済み期間が終わるまで数え続けます。未払いのもの（再試行4回失敗）は解約として数え、支払いが回復すると戻ります。
- Lemon Squeezyは解約日や理由を送信しません：解約日はサブスクリプションが最後に変更された日です。
- Lemon Squeezyは手数料を報告しないため、手数料は0と表示されます。
- 割引は、更新に表示された時点でMRRから差し引かれます。Lemon Squeezyは割引が繰り返されるかどうかを示さないため、最初の請求書のみの割引は計上しません。
- 古い注文の返金は週1回の全件読み込みで検出するため、最大1週間遅れて表示されることがあります。
- 接続前に転換したトライアルは表示されません。Lemon Squeezyは実施中のトライアルしか示さないためです。
- チャージバックは読み込まないため、敗訴したものは、プロバイダーが返金としても報告しない限り請求として計上されたままになります。