Abonnements mit gemischten IntervallenPrivate Vorschau

Sie können mehrere wiederkehrende Preise mit unterschiedlichen Intervallen in einem einzelnen Abonnement abrechnen, indem Sie ein Abonnement mit gemischten Intervallen verwenden. So können Sie verschiedene Preisstrukturen innerhalb eines einzigen Abonnements kombinieren.

For example, if a customer subscribes to a service with an annual flat rate 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.

Erste Schritte mit Abonnements mit gemischten Intervallen

Um Abonnements mit gemischten Intervallen zu aktivieren, müssen Sie bei den folgenden API-Endpoints billing_mode=flexible festlegen und Ihre API Version auf 2025-04-30.preview oder neuer aktualisieren.

• Ein Abonnement erstellen
• Eine Rechnung mit Rechnungsvorschau erstellen
• Checkout-Sitzung erstellen

Ein Abonnement mit gemischten Intervallen erstellen

Erstellen Sie ein Abonnement mit Preisen verschiedener wiederkehrender Intervallwerte, um Abonnementposten in Rechnung zu stellen, die zu unzusammenhängenden Zeitpunkten verlängert werden.

Erstellen Sie für das Beispiel eines Abonnements über 100 USD pro Quartal und eines Abonnements über 15 USD pro Monat, das am 1. Januar 2024 beginnt, das folgende Abonnement:

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[type]"=flexible \
  -d "expand[0]"=latest_invoice

Die Antwort enthält ein Abonnement mit beiden Posten und Rechnungen auf der ersten Rechnung (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",

Am 1. Februar und 1. März verlängert sich das Abonnement und es wird eine neue Rechnung über den monatlichen Preis erstellt. Am 1. April wird im Rahmen der Abonnementverlängerung eine Rechnung sowohl für den monatlichen als auch für den vierteljährlichen Preis erstellt.

Ein Abonnement kündigen

• Wenn Sie ein Abonnement oder einen Zeitplan mit gemischten Intervallen kündigen, wird Stripe alle Abonnementposten unabhängig von ihrem Intervall kündigen.
• Für Abonnements gibt es ein einziges Dunning-Verhalten (Mahnverhalten). Dies gilt auch, wenn eine Rechnung nur einen der Abonnementposten abrechnet. Schlagen alle Wiederholungsversuche für eine Zahlung fehl, wird je nach den konfigurierten Mahneinstellungen das gesamte Abonnement gekündigt und als unbezahlt oder als überfällig markiert.

Abrechnungszeiträume für Abonnements mit gemischten Intervallen

Jeder Abonnementposten hat sein eigenes current_period_start und current_period_end.

Stripe legt den aktuellen Zeitraum des Abonnements basierend auf den Abrechnungszeiträumen des Abonnementpostens fest, wobei Folgendes gilt:

• current_period_start ist das Maximum der current_period_start-Daten des Postens.
• current_period_end ist das Minimum der current_period_end-Daten des Postens.

Das subscription.current_period_end gibt immer das nächste Datum an, an dem ein Posten einen Zyklus durchlaufen wird.

Beispiel: Ein am 1. Januar erstelltes Abonnement mit einem monatlichen, zweimonatlichen und vierteljährlichen Posten hat die folgenden Zeiträume:

Nach der Verlängerung am 1. Februar (subscription.current_period_end wird der aktuelle Zeitraum des Abonnements so angepasst, dass er mit dem spätesten current_period_start und frühesten current_period_end aller Elemente übereinstimmt:

Nach einem dritten Zyklus:

Anpassung der Abrechnungszeiträume

Kostenloser Testzeitraum

Die Daten der Abrechnungszeiträume auf Postenebene sind, ähnlich wie bei regulären Abonnements, von den Enddaten der kostenlosen Testversion betroffen. Wenn das trial_end-Datum eines Abonnements in der Zukunft hat, werden alle current_period_end-Daten (Abonnement und Posten) auf das trial_end-Datum festgelegt.

Nach Ablauf der Testphase unterbrechen und fortsetzen

Sie können ein Abonnement mit unterschiedlichen Intervallen so konfigurieren, dass es am Ende des Testzeitraums unterbrochen wird, wenn die Zahlungsmethode fehlt, und zwar über den Parameter trial_settings.end_behavior.missing_payment_method wie bei regulären Abonnements. Sie können unterbrochene Abonnements mit stripe.subscription.resume wie bei regulären Abonnements wieder aufnehmen. Wir unterstützen die Parameter proration_behavior: none und billing_cycle_anchor nur bei Abonnements mit gemischten Intervallen.

Bei einem Abonnement mit unterschiedlichen Intervallen mit einem monatlichen und einem zweimonatlichen Posten mit

• billing_cycle_anchor = 1. Januar
• trial_end = 1. Februar
• trial_settings.end_behavior.missing_payment_method = „Unterbrechen“

In diesem Beispiel wird davon ausgegangen, dass dieses Abonnement am 1. Februar aufgrund einer fehlenden Zahlungsmethode unterbrochen wird und am 15. Februar mit proration_behavior: none fortgesetzt wird:

Überlegungen zu gemischten Intervallen

Für Abonnements mit gemischten Intervallen gelten einige Einschränkungen.

Ausrichtung des Zyklus

Der Preiszyklus jedes Abonnementartikels muss ein Vielfaches des kürzesten Preiszyklus des Abonnements sein. Das Intervall für einen Preis ist eine Kombination aus den Feldern price.recurring.interval und price.recurring.interval_count.

• Beispiele für unterstützte Intervallkombinationen:

  • 1 Monat, 3 Monate
  • 1 Monat, 1 Jahr
  • 1 Tag, 1 Woche
  • 1 Tag, 3 Monate
  • 1 Tag, 2 Jahre
  • 2 Wochen, 4 Wochen
  • 2 Monate, 4 Monate, 6 Monate

• Beispiele für nicht unterstützte Intervallkombinationen:

  • 2 Monate, 3 Monate
  • 4 Monate, 6 Monate
  • 1 Woche, 1 Monat
  • 2 Tage, 1 Woche
  • 5 Monate, 1 Jahr

Beschränkungen

In der privaten Vorschau unterliegen Abonnements mit gemischten Intervallen den folgenden Einschränkungen, die sich während der Entwicklung ändern können:

• Sie können cancel_at_period_end nicht für ein Abonnement mit gemischten Intervallen verwenden, da unklar ist, welches current_period_end des Abonnementpostens zur Bestimmung des Kündigungsdatums verwendet werden soll.
• Retention coupon isn’t supported