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

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

Transform quantities

You can use the transform_quantity option to transform usage before applying the price, which you can use when you want pricing on packages of a product instead of individual units. This allows you to divide the reported usage by a specific number and round the result up or down.

For example, say you have a car rental service and you want to charge customers for each hour they rent a car. In this case, you report usage as a number of minutes.

curl https://api.stripe.com/v1/products \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d name="Car Rental Service"

Create a price for the car rental service product. Charge 10 USD per hour, and round up to charge for a full hour, even if the customer uses only part of the hour.

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d nickname="Car Rental Per Hour Rate" \
  -d unit_amount=1000 \
  -d currency=usd \
  -d "recurring[interval]"=month \
  -d "recurring[usage_type]"=metered \
  -d product={{CAR_RENTAL_SERVICE_PRODUCT_ID}} \
  -d "transform_quantity[divide_by]"=60 \
  -d "transform_quantity[round]"=up

If a customer rents the car for 150 minutes, that customer is charged 30 USD for 3 hours of rental (2 hours and 30 minutes, rounded up).

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

サブスクリプションアイテムの料金は、請求サイクルの途中で更新できます。

billing_mode=flexible サブスクリプションでは、サブスクリプションから従量制料金が削除されたときに、以前に報告された従量制の使用量に対して請求する請求書項目が作成されます。

たとえば、1 月 16 日に料金 A から料金 B に切り替える月次サブスクリプションがあるとします。1 月 16 日に、1 月 1 日から 1 月 16 日までの使用量を請求する請求書項目を作成します。サブスクリプションの期間が 2 月 1 日の場合、Stripe は 1 月 16 日から 2 月 1 日までの料金 B で請求します。

従量制料金を削除する際に指定した proration_behavior は、これらの従量制請求書項目に影響します。請求せずに従量制料金を削除するにはproration_behavior を none に設定します。

billing_mode=classic サブスクリプションで、あるメーター料金から別の請求メーター料金に切り替える場合は制限が適用されます。

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

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

• 集計された使用量を再度報告し、新しい価格の適用時にキャプチャーする。
• billing_cycle_anchor パラメーターを now にリセットして、以前報告された使用量に以前の料金を適用します。

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

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 を使用して、初回報告の前にサブスクリプションを作成します。

billing_mode=flexible のサブスクリプションでは、サブスクリプションの最初の請求書にこの遡及適用された使用量が含まれます。

billing_mode=classic のサブスクリプションでは、サブスクリプションの次回の請求書 (サイクル時に生成) に、この遡及適用された使用量が含まれます。

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

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