従量課金の設定を管理する

従量課金モデルを作成したら、請求設定のさまざまな部分を変更できます。たとえば、請求サイクルの途中にサブスクリプションアイテムの料金を更新したり、サブスクリプションをさかのぼって適用して次回の請求書に使用量を含めたり、使用量ベースのサブスクリプションをキャンセルしたりできます。

サイクルの途中で料金を更新する

サブスクリプションアイテムの価格は、請求サイクルの途中で更新できます。ただし、あるメーターの価格から別の価格に切り替える場合は制限が適用されます。

今後の請求書には、更新後に発生した使用量のみが反映されます。たとえば、1 月 16 日に料金 A から料金 B に切り替える月次サブスクリプションがあるとします。月末の請求書には、1 月 16 日から 1 月 31 日までの使用量が料金 B で含まれます。1 月 1 日から 1 月 16 日までの使用量は請求されません。

請求しきい値を使用していて、古い料金で請求書がすでに生成されている場合は例外です。たとえば、料金 A を適用して 1 月 10 日に請求書を生成するとします。その請求書は、引き続き顧客に請求されます。月末の請求書には、1 月 16 日から 1 月 31 日までの使用量が料金 B で記載されます。それまでの請求書によってこの月末の請求書の使用量が相殺されることはありません。

同様の制限は、請求メーター料金を設定した新しいサブスクリプションアイテムをサブスクリプションサイクルの途中で追加する場合にも適用されます。たとえば、1 月 16 日に料金 C の新しいサブスクリプションアイテムを追加するとします。月末の請求書には、そのサブスクリプションアイテムの 1 月 16 日から 1 月 31 日までの使用量が料金 C で含まれます。

サブスクリプションアイテムの料金を更新するには、以下のようにします。

curl https://api.stripe.com/v1/subscription_items/{{SUBSCRIPTION_ITEM_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d price={{NEW_PRICE_ID}}

サブスクリプションアイテムを削除するには、以下のようにします。

curl -X DELETE https://api.stripe.com/v1/subscription_items/{{SUBSCRIPTION_ITEM_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

削除すると、請求書にはそのアイテムの使用量は反映されません。

遡及適用するサブスクリプションを作成する

顧客のサブスクリプションを作成する前でも、顧客の使用量を記録できます。顧客の使用量を記録した後、backdate_start_date を使用して、初回報告の前にサブスクリプションを作成します。そうすることで、次回のサブスクリプションの請求書に使用量を含めることができます。

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer={{CUSTOMER_ID}} \
  -d "items[0][price]"={{PRICE_ID}} \
  -d backdate_start_date=1710000000

使用量ベースのサブスクリプションをキャンセルする

従量課金を使用する場合、請求サイクル中の使用量に基づいて顧客が支払う料金が変わります。請求サイクルを変えると、サブスクリプション期間の終了が早まり、顧客は短縮された請求サイクル中に発生した使用量に対して請求されます。

キャンセルしたサブスクリプションを再度有効にすることはできません。代わりに、顧客から最新の請求情報を収集して、顧客のデフォルトの決済手段を更新し、既存の顧客の記録を使用して新しいサブスクリプションを作成できます。

cancel_at_period_end を使用してサブスクリプションのキャンセル日のスケジュールを設定している場合、期間の終了前ならいつでもサブスクリプションを再度有効にすることができます。これを行うには、cancel_at_period_end を false に更新します。

期間末にキャンセルされるサブスクリプションの場合、サイクル終了時の最終請求書には、最後の請求サイクルの従量制の使用量が含まれます。この場合、Stripe はサイクル終了請求書の自動回収も無効にし、auto_advance を false に設定します。auto_advance を true に設定することで、請求書の自動回収を手動で再開できます。