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

従量課金モデルを作成した後、請求設定のさまざまな部分を変更できます。たとえば、請求期間中にサブスクリプション項目の価格を更新したり、サブスクリプションをさかのぼって次の請求書に使用量を含めたり、使用量に基づくサブスクリプションをキャンセルしたりできます。

数量の変換

transform_quantity オプションを使用すると、料金を適用する前に使用量を変換できます。これは、個々の製品ではなく、製品パッケージに価格を設定する必要がある場合に使用します。これにより、報告された使用量を特定の数値で除算し、結果を切り上げまたは切り捨てることができます。

たとえば、会社がレンタカーサービスを提供していて、顧客がレンタカーを借りた時間ごとに請求するとします。この場合、使用量を分単位で報告するように設定します。

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

レンタカーサービス商品の料金を作成します。料金は 1 時間あたり 10 USD と仮定します。顧客の利用時間が 1 時間未満でも、1 時間単位の請求になるように端数は切り上げられます。

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

顧客がレンタカーを 150 分借りる場合に、その顧客は 3 時間のレンタル (2 時間 30 分の切り上げ) に対して 30 USD を請求されます。

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

請求期間中にサブスクリプション項目の価格を更新できます。

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

たとえば、1 月 16 日に価格 A から価格 B に切り替える月次サブスクリプションがあるとします。1 月 16 日に、1 月 1 日から 1 月 16 日までの使用量に関する請求書項目を作成します。2 月 1 日にサブスクリプションが更新されると、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 に更新します。

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