レートカードのサブスクリプションの仕組み非公開プレビュー

レートカードを使用して従量課金を設定する場合、これらのレートカードを顧客のサブスクリプションの請求根拠として使用できます。

レートカードのサブスクリプションのコンセプト

ここでは、レートカードのサブスクリプションの仕組みを理解するための重要な概念について説明します。

請求頻度とサービス期間

請求頻度は、請求書が生成されるタイミングを定義します。生成された請求書は、1 つ以上の_サービス期間_中に発生した支払いをまとめます。ビジネスモデルや料金体系に合わせて、さまざまな請求頻度を設定することが可能です。

サービス期間が終了すると、Stripe はその期間中の使用量 (たとえば、過去 1 週間の顧客の使用量) に基づいて請求額を計算します。これらの請求額は顧客のアカウントに追加されますが、必ずしもすぐに請求されるわけではありません。

請求サイクルが終了すると、最後の請求サイクル以降に発生したすべての未払い料金が請求書にまとめられ、顧客に送信されます。

この分離により、月次サービス使用量に基づく四半期請求や、日次サービス使用量に基づく週次請求など、柔軟な請求方法が利用可能になります。

例

顧客は、完了したサービス期間に対してのみ請求されます。サービス期間の使用量が発生している間に顧客に請求された場合、レートカードのサブスクリプションには、前のサービス期間の使用量のみが含まれます。新しい使用量は、次回の請求サイクルの請求書に追加されます。

毎月のサービス期間と四半期ごとの請求サイクル

この例では、ビジネスに次の設定があります。

• サービス期間: 毎月
• 請求サイクル: 3 か月ごと

Stripe は使用量に基づいて毎月末に料金を計算します。3 か月目の終わりに請求サイクルが終了し、Stripe は 3 か月の使用を含む請求書を生成します。

サービス期間は 5 か月で、毎年請求されます

この例では、ビジネスに次の設定があります。

• サービス期間: 5 か月ごと
• 請求サイクル: 毎年 3 月 31 日

顧客は、年間請求サイクル内の完了したサービス期間に対してのみ請求されます。この例では、請求書は 10 か月の使用に対するもので、完了した 2 つのサービス期間を表しています。

サービス期間が 5 か月で、年間請求サイクルの場合、顧客は完了したサービス間隔に対してのみ請求されます。

ライフサイクル

レートカードのサブスクリプションのライフサイクルは次のようになります。

1. サブスクリプションを作成し、レートカードを参照します。
2. 使用量は、サービス期間ごとに記録・集計されます。
3. サブスクリプションの請求書は、請求頻度に基づいて作成されます。
4. 顧客の決済手段に請求されます。

回収ステータスとサービスステータス

レートカードのサブスクリプションには、次の 2 つのステータスがあります。

• サービスのステータス: これはサービス期間に関連付けられており、サービスをプロビジョニングまたはプロビジョニング解除するタイミングを示します。レートカードのサブスクリプションのサービスのステータスは、次のいずれかになります。
  • 要対応
  • 一時停止中
  • キャンセル
• 回収のステータス: これは請求頻度に関連付けられており、レートカードのサブスクリプションの支払いステータスを定義します。回収のステータスは、次のいずれかになります。
  • 現在
  • 期日経過
  • 未払い

顧客の決済手段に自動的に請求するサブスクリプションについて、ステータスがどのように連携するかを次に示します。

請求書を送信するサブスクリプションについて、ステータスがどのように連携するかを次に示します。

レートカードのサブスクリプションでの支払いの仕組み

レートカードのサブスクリプションを作成する際に、顧客の使用量に対する支払いの回収方法 (顧客の決済手段に自動的に請求するか、各請求サイクルの終了時に請求書を送信するか) を定義します。顧客のサブスクリプションを作成する際に支払い情報を収集できます。請求サイクルの終了時に、Stripe は請求書を生成します。

自動請求する場合、Stripe は請求書を生成しますが、請求書について顧客に通知することはしません。顧客へのメールを有効にしている場合、支払いが成功すると Stripe から領収書が送信されます。

請求書を送信すると、Stripe が請求書を生成して顧客に送信します。これは、有効にしたサポート対象の決済手段で支払うことができます。

レートカードのサブスクリプションの請求書のライフサイクル

レートカードのサブスクリプションによって作成される請求書の基本的なライフサイクルは、次のようになります。

1. レートカードのサブスクリプションは、draft ステータスの新しい請求書を生成します。
2. 請求書はすぐに確定されます。請求書の確定後に変更を行うことはできません。
3. ステータスは open に設定され、Stripe は顧客のデフォルトの決済手段を使用して自動的に支払いを試みるか、顧客に請求書を送信します。
4. 支払いが成功すると、請求書のステータスは paid に更新されます。
5. 支払いに失敗した場合、請求書は open のままで、レートカードのサブスクリプションは past_due になります。

レートカードのサブスクリプションの回収設定

レートカードのサブスクリプションの支払いに失敗した場合、Stripe のデフォルトの回収動作は収益の回収に役立ちます。

自動再試行

レートカードのサブスクリプションを作成した後、支払いの失敗は発生する可能性がある最も重要なイベントです。障害はさまざまな理由で発生します。

• 顧客に支払い方法がない
• 期限切れの決済手段
• 拒否された支払い

レートカードのサブスクリプションの場合、Stripe は、設定されたサブスクリプション設定に基づいて、失敗した支払いを自動的に再試行します。次のいずれかを使用できます。

• Smart Retries では、機械学習によって最適な再試行時間が選択されます
• スケジュール済み再試行では、ユーザーがダッシュボードで再試行ポリシーを設定します

invoice.payment_failed イベントを使用して、サブスクリプションの支払い失敗イベントをモニタリングし、更新を再試行します。請求書の支払いが試行されると、その next_payment_attempt 値はデフォルトの再試行設定を使用して設定されます。

すべての再試行後に回収に失敗した場合、レートカードのサブスクリプションは「Unpaid」の回収状態に移行し、回収ステータスとサービスステータスの表に示すように、サービスのステータスが「Paused」に設定されます。

顧客のメールアドレス

Stripe は、Customer オブジェクトに関連付けらているメールアドレスを使用して、さまざまなメールを顧客に送信します。

• 決済試行が失敗した場合に、支払い情報を更新するよう顧客に促す支払い失敗通知。
• 顧客のデフォルト決済手段の有効期限が近づいているときに送信する、カード有効期限通知。

ダッシュボードのブランディング設定を変更することで、メールやオンライン請求書の支払いページで顧客に表示されるロゴや色彩をカスタマイズできます。

レートカードのサブスクリプションのイベント

v2 イベント は、サブスクリプションが有効化またはキャンセルされたときにトリガーされます。イベントの送信先でイベントをリッスンできます。

次の表は、レートカードのサブスクリプションに関連する最も一般的なイベントについて説明したものです。イベント通知を使用して、プロビジョニングロジックを構築します。

これらの v2 イベントを処理するには、イベントの送信先を設定して、それを Webhook エンドポイントに指定します。このとき、次のいずれかを実行できます。

• Workbench で Event Destination を作成します。
• Stripe API を経由して Event Destination を作成します。

これらのイベントを処理するように Webhook エンドポイントを設定する方法の例をご覧ください。

レートカードサブスクリプションと税金徴収

Stripe Tax を使用して、レートカードサブスクリプションの継続支払いの税額を計算できます。顧客の支払い準備が整ったときに税金の計算を自動的に処理するには、レートカードサブスクリプションを作成する際に顧客の場所の詳細を設定します。詳細は従量課金ベースのレートカードのサブスクリプションに対する税金の徴収をご覧ください。