混合期間のサブスクリプション非公開プレビュー

You can bill for multiple recurring prices with different intervals on a single subscription using mixed interval subscription. This allows you to combine different pricing structures within a single subscription.

For example, if a customer subscribes to a service with an annual flat fee of 500 USD and a monthly usage-based fee, you can include both prices as items on the same subscription. Stripe generates combined invoices when item-level billing cycles align and generates separate invoices when only one item is due.

Get started with mixed interval subscriptions

To enable mixed interval subscriptions, you must set billing_mode=flexible on the following API endpoints and upgrade your API version to 2025-04-30.preview or later.

• Create a subscription
• Create a preview invoice
• Create a Checkout Session

期間が混在するサブスクリプションを作成する

異なる継続期間値を持つ価格を使用してサブスクリプションを作成し、ばらばらのタイミングで更新されるサブスクリプションアイテムに対して請求します。

2024 年 1 月 1 日に開始される四半期あたり 100 USD、月額 15 USD のサブスクリプションの例では、以下のサブスクリプションを作成します:

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price_data][currency]"=usd \
  -d "items[0][price_data][product]"=
{{PRODUCT_ID}} \
  -d "items[0][price_data][recurring][interval]"=month \
  -d "items[0][price_data][recurring][interval_count]"=1 \
  -d "items[0][price_data][unit_amount]"=1500 \
  -d "items[0][quantity]"=1 \
  -d "items[1][price_data][currency]"=usd \
  -d "items[1][price_data][product]"=
{{PRODUCT_ID}} \
  -d "items[1][price_data][recurring][interval]"=month \
  -d "items[1][price_data][recurring][interval_count]"=3 \
  -d "items[1][price_data][unit_amount]"=10000 \
  -d "items[1][quantity]"=1 \
  -d collection_method=send_invoice \
  -d days_until_due=5 \
  -d proration_behavior=none \
  -d billing_mode=flexible \
  -d "expand[0]"=latest_invoice

応答には、最初のインボイス (latest_invoice) に両方のアイテムと請求書を含むサブスクリプションが含まれます。

{
  "object": "subscription",
  "id": 
'{{SUBSCRIPTION_ID}}',
  "current_period_start": 1704067200, // Jan 1 2024
  "current_period_end": 1706745600, // Feb 1 2024
  "items": {
    "data": [
      {
        "id": "si_A",
        "price": "price_id_monthly",

2 月 1 日と 3 月 1 日に、サブスクリプションが更新され、月額料金の新しいインボイスが生成される。 4 月 1 日に、サブスクリプションの更新で月次と四半期の両方の料金のインボイスが作成されます。

サブスクリプションをキャンセルする

• 期間が混在するサブスクリプションまたはスケジュールをキャンセルすると、Stripe は、期間に関係なく、すべてのサブスクリプションアイテムをキャンセルします。
• Subscriptions have a single behavior for dunning, even if an invoice only bills for one of the items on the subscription. If all retries for a payment fail, Stripe cancels the entire subscription and marks it as unpaid or past due, depending on your configured dunning settings.

混合期間のサブスクリプションの請求期間

各サブスクリプションアイテムには、独自のcurrent_period_start と current_period_end があります。

Stripe はサブスクリプションアイテムの請求期間に基づいて、サブスクリプションの現在の期間を設定します。

• current_period_start は、アイテムの current_period_start の日付の最大値 (最も遅い日付) です。
• current_period_end は、アイテムの current_period_end の日付の最小値 (最も早い日付) です。

subscription.current_period_end は、常にアイテムの現在のサイクルが終了する次の日付を示します。

たとえば、月次、隔月、四半期ごとのアイテムを含むサブスクリプションを 1 月 1 日に作成した場合、次の期間が含まれます。

2 月 1 日 (subscription.current_period_end) の更新後、サブスクリプションの現在の期間は、すべてのアイテムの最も遅い current_period_start と最も早い current_period_end に合わせて調整されます。

3 回目のサイクル後:

請求期間の調整

無料トライアル

アイテムレベルの請求期間の日付は、通常のサブスクリプションと同様に、無料トライアルの終了日の影響を受けます。サブスクリプションに将来の日付の trial_end が設定されている場合、すべての current_period_end の日付 (サブスクリプションとアイテム) も trial_end の日付に設定されます。

トライアル期間の終了時に一時停止して再開する

混合間隔のサブスクリプションは、通常のサブスクリプションと同様に、trial_settings.end_behavior.missing_payment_method パラメーターで決済手段を指定しないことで、トライアル終了時に一時停止するように設定できます。一時停止されたサブスクリプションは、通常のサブスクリプションと同様に stripe.subscription.resume を使用して再開することができます。現在、proration_behavior: none パラメーターと billing_cycle_anchor パラメーターのみがサポートされています。

月次項目と隔月項目の混合間隔のサブスクリプションの場合

• billing_cycle_anchor = 1 月 1 日
• trial_end = 2 月 1 日
• trial_settings.end_behavior.missing_payment_method = 「一時停止」

この例では、決済手段が指定されていないことを理由にこのサブスクリプションが 2 月 1 日に一時停止され、2 月 15 日に proration_behavior: none で再開されるケースを想定しています。

期間が混在する場合の考慮事項

期間混在機能には、いくつかの制限があります。

サイクルの一致

すべてのサブスクリプションアイテムの価格サイクルは、サブスクリプションに存在する最短の価格サイクルの倍数である必要があります。価格の期間は、price.recurring.interval フィールドと price.recurring.interval_count フィールドの組み合わせです。

• サポートされている期間の組み合わせの例:

  • 1 カ月、3 カ月
  • 1 カ月、1 年
  • 1 日、1 週間
  • 1 日、3 カ月
  • 1 日、2 年
  • 2 週間、4 週間
  • 2 カ月、4 カ月、6 カ月

• サポートされていない期間の組み合わせの例:

  • 2 カ月、3 カ月
  • 4 カ月、6 カ月
  • 1 週間、1 カ月
  • 2 日、1 週間
  • 5 カ月、1 年

制限事項

プライベートプレビュー版の場合、期間が混在するサブスクリプションには、開発中に変更される可能性がある次の制限が適用されます。

• All subscription item prices must specify recurring.usage_type: licensed and billing_scheme: per_unit. We don’t support metered pricing.
• Mixed interval subscriptions are currently available in the Stripe API only, and not the customer portal.
• You can’t use cancel_at_period_end on a mixed interval subscription because it’s unclear which subscription item’s current_period_end to use to determine the cancellation date.