Abonnements mit gemischten Intervallen

Sie können mehrere Abonnement Artikel mit unterschiedlichen Preisen und Rechnungsstellungszeiträumen in ein einziges Abonnement aufnehmen, und Stripe übernimmt automatisch die Erstellung von Rechnungen.

Beispielsweise können Sie, wenn Sie einen Service mit einem jährlichen Pauschalpreis und einer monatlichen nutzungsbasierten Gebühr anbieten, beide Preise als Positionen im selben Abo einfügen. Stripe erstellt eine einzelne, kombinierte Rechnung, wenn sich die Rechnungsstellungszeiträume der Positionen decken und separate Rechnungen, wenn sich die Rechnungsstellungszeiträume unterscheiden.

Ein Abonnement kündigen

Wenn Sie ein Abonnement oder einen Zeitplan mit gemischten Intervallen kündigen, werden alle Posten des Abonnements storniert, unabhängig von ihrem Intervall.

Subscriptions have a single behavior for dunning. If all retries for a payment fail, even if the failing payment is for an invoice related to only one of the items on the subscription, Stripe cancels the entire subscription and marks it as unpaid or past due, depending on your configured dunning settings.

Erfahren Sie mehr über das Kündigen oder Auflösen von Abonnements.

Abrechnungszeiträume für Abonnements mit gemischten Intervallen

Jeder Posten des Abonnements hat seinen eigenen current_period_start und current_period_end. Die Abonnementposten verfolgen ihre jeweiligen Rechnungsstellungszeiträume direkt und nicht als gemeinsamen Rechnungsstellungszeitraum auf oberster Ebene der Ressource Abonnement.

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:

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

You can configure a mixed interval subscription to pause at trial end when the payment method is missing through the trial_settings.end_behavior.missing_payment_method parameter as with regular subscriptions. You can resume paused subscriptions using stripe.subscription.resume, as with regular subscriptions. We only support the proration_behavior: 'none' and billing_cycle_anchor parameters with mixed interval subscriptions.

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 pausiert wurde und am 15. Februar mit proration_behavior: 'none' wieder aufgenommen wird:

Intervallausrichtung

Bei Abonnements mit gemischten Intervallen muss das Preisintervall eines jeden Postens (die Kombination aus price.recurring.interval und price.recurring.interval_count) ein Vielfaches des kürzesten Preisintervalls im Abonnement sein. Einige Preisintervallkombinationen werden bei Abonnements mit gemischten Intervallen nicht unterstützt.

• 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

Abonnements für gemischte Intervalle unterliegen den folgenden Einschränkungen:

• Das veraltete cancel_at_period_end kann nicht erkennen, welcher Posten des Abonnements current_period_end als Kündigungsdatum verwendet werden soll, daher wird standardmäßig min_period_end verwendet. Alternativ dazu:
  • Verwenden Sie den Parameter cancel_at, um ein Abonnement zu einem zukünftigen Datum zu kündigen.
  • Verwenden Sie die Hilfsfunktionen min_period_end oder max_period_end, um zu bestimmen, welcher Posten am Ende des Zeitraums die Kündigung des Abonnements auslöst.
• Bei Abonnements mit gemischten Intervallen kann die Gesamtzahl der Iterationen nicht genau berechnet werden. Verwenden Sie stattdessen duration zur Angabe des Abonnementplans.
• Sie können keinen Gutschein für gemischte Intervall-Abonnements über das Kundenportal anwenden.
• Sie können derzeit keine gemischten Intervall-Abonnements als Bezahlvorgang erstellen.