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

1 つのサブスクリプションに価格と請求期間の異なる複数のサブスクリプションアイテムを含めることができ、請求書の生成は Stripe が自動的に処理します。

たとえば、年間の 定額料金 と月額の 従量制料金 でサービスを提供する場合、両方の価格を同じサブスクリプションの項目として含めることができます。Stripe は、項目レベルの請求間隔が一致する場合は単一の統合請求書を生成し、間隔が異なる場合は別々の請求書を生成します。

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

異なる請求間隔を持つサブスクリプションまたはスケジュールをキャンセルすると、それらの期間に関係なく、すべてのサブスクリプションアイテムがキャンセルされます。

サブスクリプションの 督促 の動作は 1 つだけです。決済の再試行がすべて失敗すると、サブスクリプションの 1 つのアイテムのみに関連する請求書の決済が失敗した場合でも、Stripe はサブスクリプション全体をキャンセルし、設定されている督促の設定に応じて、未払いまたは期日経過としてマークします。

サブスクリプションのキャンセルまたは削除 の詳細をご確認ください。

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

各サブスクリプションアイテムには、独自の current_period_start と 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(トライアル期間終了後に決済手段が設定されていない場合の挙動を指定する設定) パラメータを使用して、通常のサブスクリプションと同様に、決済手段が見つからない場合にトライアル終了時に一時停止するように、混合期間サブスクリプションを設定できます。一時停止したサブスクリプションを再開するには、通常のサブスクリプションと同様に、resume(再開)ややstripe.subscription.resume(Stripe サブスクリプションを再開)を使用します。proration_behavior: 'none'(比例配分:「なし」) とbilling_cycle_anchor(請求サイクルの起点) パラメータは、混合期間のサブスクリプションでのみ対応しています。

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

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

proration_behavior: 'none'(比例配分:「なし」) この例では、このサブスクリプションが 2 月 1 日に決済手段の不備により一時停止され、2 月 15 日に再開されたと仮定しています：

間隔の調整

異なる請求間隔を持つサブスクリプションでは、すべての項目の価格間隔 (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 年

制限事項

異なる請求間隔を持つサブスクリプションには、次の制限が適用されます。

• The deprecated cancel_at_period_end can’t detect which subscription item’s current_period_end to use as the cancellation date, so defaults to min_period_end. Alternatively:
  • cancel_at パラメータを使用して、将来の日付でサブスクリプションをキャンセルします。
  • min_period_end または max_period_end ヘルパーを使用して、サブスクリプションのキャンセルをトリガーする項目の終了期間を決定します。
• 異なる請求間隔を持つサブスクリプションでは、合計 繰り返し を正確に計算できません。代わりに duration を使用してサブスクリプションスケジュールを指定してください。
• カスタマーポータルから異なる請求間隔を持つサブスクリプションに顧客維持クーポンを適用することはできません。
• 現在、Checkout セッション で異なる請求間隔を持つサブスクリプションを作成することはできません。