RevGlanceRecurly
US または EU リージョンのプライベート API キーで Recurly を接続します。
RevGlance は Recurly の API バージョン 2021-02-25 から、支払い済みの請求書、返金トランザクション、サブスクリプションを読み込みます。
接続
- Recurly で Integrations › API Credentials を開き、プライベート API キーを追加します。名前は RevGlance にします。
- キーをコピーし、サイトのサブドメインを控えます。
acme.recurly.comならacmeです。 - キー、サイトがホストされているリージョン（
usまたはeu）、サブドメインを入力し、Recurlyを接続を選びます。
フォームで入力する項目
| 項目 | 形式の例 |
|---|---|
| プライベートAPIキー暗号化して保存 | 0123456789abcdef0123456789abcdef |
| リージョン | usまたはeu |
| サイトのサブドメイン | acme（acme.recurly.comの場合） |
リージョンには us または eu を入力します。EU でホストされているサイトは Recurly の EU API を使います。
Webhook を追加する
- RevGlance で 設定 › ソース を開き、Recurly ソースのメニューを開いて Webhook を選びます。URL をコピーします。
- Recurly で Integrations › Webhooks を開き、その URL で JSON 形式のエンドポイントを追加します。
- エンドポイントの署名シークレットをコピーし、RevGlance の署名シークレットに貼り付けて保存します。
RevGlance は recurly-signature ヘッダーを確認し、5 分以上前の呼び出しは拒否します。
RevGlance が同期するもの
- 支払い済みの請求書（税抜き）。
- 成功した返金トランザクション。税は請求書と同じ割合で差し引きます。
- サブスクリプション。MRR、プラン、トライアル、解約に使います。Recurly は API で解約理由を提供せず、ゲートウェイ手数料も報告しません。
Recurly の集計方法
- 支払い済みの請求書を税抜きで計上します。
- 返金は成功した返金取引です。税込みのため、RevGlanceが請求書と同じ割合で税を差し引きます。
- Recurlyはゲートウェイ手数料を報告しないため、手数料は0と表示されます。
- MRRはRecurlyのサブスクリプション小計です（単価、数量、アドオン。クーポン適用後、税抜き）。
- 解約されたサブスクリプションは期限切れになるまで数え続けます。期限切れ、失敗、一時停止中のものは解約として数えます。RecurlyはAPIで解約理由を提供しません。
- 回収できなかった支払いは失敗した請求として計上します。資金の移動はありません。
- チャージバックは読み込まないため、敗訴したものは、プロバイダーが返金としても報告しない限り請求として計上されたままになります。
回収メール
回収は、顧客をあなたの Recurly サイト上のホスト型アカウントページにリンクします。フォームでサブドメインを入力するのはそのためです。