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

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

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

You can update a subscription item’s price during a billing cycle.

However, limitations apply when switching from one meter price to another.

今後の請求書には、更新後に発生した使用量のみが反映されます。たとえば、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 で含まれます。

次のオプションのいずれかを選択して、以前に報告された使用量を料金変更時にキャプチャーできます。

• 集計された使用量を再度報告し、新しい価格の適用時にキャプチャーする。
• Reset the billing_cycle_anchor parameter to now, applying the old price to previously reported usage.

これらの回避策により、現在の制限に対処することが可能です。

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

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
:"

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

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

You can record usage for a customer even before creating a subscription for them. After recording usage for a customer, use the backdate_start_date to create a subscription before the first report.

This allows you to include usage in the next subscription invoice.

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 に更新します。

期間終了時にキャンセルされるサブスクリプションの場合、サイクルの終了時の最終請求書には、前回の請求サイクルからの従量制の使用量が含まれます。