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.

Wenn eine Kundin/ein Kunde beispielsweise eine Dienstleistung mit einer jährlichen Pauschalgebühr von 500 USD und einer monatlichen nutzungsbasierten Gebühr abonniert, können Sie beide Preise als Posten in dasselbe Abonnement aufnehmen. Stripe generiert kombinierte Rechnungen, wenn die Abrechnungszyklen auf Postenebene übereinstimmen, und separate Rechnungen, wenn nur ein Posten fällig ist.

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:

• Bei allen Preisen für Abonnementposten muss recurring.usage_type: licensed and billing_scheme: per_unit angegeben werden. Wir unterstützen keine nutzungsbasierten Preise.
• Abonnements mit gemischten Intervallen sind derzeit nur in der Stripe API und nicht im Kundenportal verfügbar.
• 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.