RevGlanceドキュメント

Stripe

読み取り専用の制限付きキーで Stripe を接続し、Webhook を追加して新しい支払いをすぐに表示します。

RevGlance は、あなたが作成したキーを使い、Stripe の API を通じて Stripe アカウントを読み込みます。請求、返金、手数料、異議申し立て、サブスクリプションを読み込み、請求、返金、その他の変更を行うことは決してありません。

始める前に

  • RevGlance でそのビジネスのオーナーまたは管理者である必要があります。閲覧者はソースを追加できません。
  • シークレットキーではなく制限付きキーを使ってください。RevGlance はどちら（rk_… または sk_…）も受け付けますが、制限付きキーは許可したものしか読み取れません。
  • テストモードのキーも使えるので、まずは試してみるのに便利です。準備ができたら、本番用キーで 2 つ目のソースを接続してください。

接続

  1. Stripe ダッシュボードで Developers › API keys を開き、Create restricted key を選びます。名前は RevGlance にします。
  2. Balance、Charges、Customers、Disputes、Invoices、Checkout Sessions、Subscriptions、Coupons に Read アクセスを付与します。それ以外はすべて None のままにします。
  3. キーを作成してコピーします。rk_live_ で始まります。
  4. 制限付きキーに貼り付け、Stripeを接続を選びます。最初の同期で履歴全体を読み込みます。

フォームで入力する項目

項目形式の例
制限付きキー暗号化して保存rk_live_…

名前は任意です。1 つのビジネス内の 2 つの Stripe アカウントを区別するのに使います。

Webhook を追加する

Webhook がない場合、RevGlance は Stripe を 1 時間ごとに同期します。Webhook があれば、新しい支払い、返金、解約があると数秒以内に同期がキューに入ります。

  1. RevGlance で 設定 › ソース を開き、Stripe ソースを見つけてメニューを開き、Webhook を選びます。URL をコピーします。
  2. Stripe で Developers › Webhooks を開き、その URL でエンドポイントを追加します。
  3. 数値に影響するイベントを選択します：charge.succeeded、charge.failed、charge.refunded、charge.dispute.closed、customer.subscription.created、customer.subscription.updated、customer.subscription.deleted、invoice.paid。どのイベントでも構いません。それぞれが同期を開始するだけです。
  4. エンドポイントの signing secret（whsec_…）をコピーし、RevGlance の署名シークレットに貼り付けて保存します。

RevGlance が同期するもの

  • 残高トランザクション：すべての請求、返金、異議申し立て、Stripe の手数料を、Stripe が決済した通貨で。
  • 失敗した請求。失敗した請求の指標と回収に使います。
  • すべてのステータスのサブスクリプション。顧客、アイテム、割引、最新の請求書を含み、MRR、プラン、トライアル、解約に使います。Stripe に解約理由と顧客のコメントがあれば、それも取り込みます。

最初の同期では履歴全体を読み込みます。その後の同期では前回の同期の 3 日前から読み込むため、後から入った変更も取りこぼしません。サブスクリプションは毎回すべて読み込みます。

Stripe の集計方法

  • 請求、返金、Stripeの手数料は、Stripeが決済した通貨での残高取引から取得します。
  • カードの返金はStripeが記録した日に計上します。銀行決済（ACH、SEPA、その他の現地決済手段）も含まれます。銀行から返送された返金は、返金額を再び減らします。
  • 異議申し立ては、Stripeが資金を引き戻したときに返金として計上し、勝訴した場合は返金が取り消されます。Stripeの異議申し立て手数料は手数料として残ります。
  • サブスクリプションと個別アイテムのクーポンはMRRから差し引かれます。定額クーポンは、その通貨でのみ計上されます。
  • 一時停止中と未払いのサブスクリプションは解約として数えます。支払い期限切れのものは、Stripeがカードを再試行している間は数え続けます。
  • 請求、返金、異議申し立ては、請求書またはCheckout Sessionの税の割合で、税引き前で計上します。Checkout Sessionsへの読み取りアクセスがない場合、請求書を伴わない販売の税は含まれたままになります。
  • 税込み価格は、最新の請求書の税の割合で、税引き前でMRRに計上します。
  • 支払い回収の一時停止は、Stripeが日付を示さないため、RevGlanceが最初に確認した日から解約として数えます。

すべてのプロバイダーに共通するルールは集計方法をご覧ください。

回収メール

回収は、失敗したサブスクリプションの支払いを Stripe 上の未払い請求書ページにリンクし、顧客はそこで新しいカードで支払えます。未払いの請求書がない場合は、代わりに Stripe のカスタマーポータルセッションを開きます。このフォールバックには、Stripe でポータルを有効にし、キーに Customer portal セッションの書き込みを許可する必要があります。ない場合、メールはあなた自身のカード更新ページにリンクします。

トラブルシューティング

  • 「Stripeのシークレットキーまたは制限付きキーを貼り付けてください。」 キーは rk_ または sk_ で始まる必要があります。公開可能キー（pk_）では何も読み取れません。
  • "Stripe refused that key." キーが無効化されたか、Balance の読み取りアクセスがありません。
  • "Stripe refused the failed-charge request" または "the subscription request"：キーで Charges または Subscriptions を読み取れません。支払いは引き続き同期されます。不足している権限を追加して、もう一度同期してください。