Mehr Flexibilität für Abonnements ermöglichen
Verwenden Sie den flexiblen Abrechnungsmodus, um erweiterte Funktionen zu erhalten und auf zusätzliche Funktionen zuzugreifen.
Der flexible Abrechnungsmodus ist eine Abonnementeinstellung, die ein genaueres und vorhersehbareres Abrechnungsverhalten bietet und den Zugriff auf zusätzliche Funktionen freischaltet. Sie können den flexiblen Abrechnungsmodus aktivieren, indem Sie billing_ (mit der API oder im Dashboard) für ein Abonnement festlegen. Wenn der flexible Modus aktiviert ist, können Sie:
- Verbessern Sie die Art und Weise, wie anteilsmäßige Verrechnungen von Gutschriften ermittelt werden.
- Vereinfachen Sie die Rechnungsstellung für die gemessene Nutzung.
- Erhalten Sie erweiterte Testfunktionen.
- Erlangen Sie eine zuverlässigere Kontrolle über den Lebenszyklus eines Abonnements.
- Aktivieren Sie eine andere Logik für die anteilmäßige Verrechnung, die anteilige Verrechnungen von Gutschriften basierend auf dem ursprünglichen Betrag berechnet, der zuvor vom Konto eines Kunden/einer Kundin abgebucht wurde.
- Greifen Sie auf zusätzliche Funktionen zu, z. B. auf gemischte Intervalle innerhalb desselben Abonnements.
Um den flexiblen Abrechnungsmodus zu verwenden, muss sich Ihre Integration auf der Stripe-API-Version 2025-06-30.basil oder höher befinden. Erfahren Sie, wie Sie Ihre API-Version aktualisieren.
Es gibt einige Einschränkungen, die bei der Verwendung des flexiblen Abrechnungsmodus zu beachten sind:
- Sie können kein Downgrade vom flexiblen Abrechnungsmodus zum klassischen Abrechnungsmodus durchführen.
- Sie können den flexiblen Abrechnungsmodus nicht für ein Abonnement aktivieren, bei dem Abrechnungslimits verwendet werden.
- Sie können den flexiblen Abrechnungsmodus nicht für ein Abonnement aktivieren, für das die veraltete nutzungsbasierte Abrechnung verwendet wird.
Abrechnungsmodus konfigurieren
Neues Abonnement mit flexiblem Abrechnungsmodus erstellen
Bestehende Abonnements zum flexiblen Abrechnungsmodus migrieren
Sie können Ihre bestehenden Abonnements zum flexiblen Abrechnungsmodus migrieren.
Verbesserungen beim flexiblen Abrechnungsmodus
Wenn Sie billing_ für ein Abonnement festlegen, ändert sich das Verhalten von Abonnement-Objekten während ihres Lebenszyklus und als Reaktion auf Upgrades, Downgrades und Kündigungen.
Anteilsmäßige Verrechnung von Gutschriften
Der flexible Abrechnungsmodus berechnet anteilige Gutschriften auf der Grundlage des ursprünglichen Betrags, der zuvor von einem/einer Kund/in abgebucht wurde. Eine vollständige Übersicht über die anteilsmäßige Verrechnung von Gutschriften finden Sie unter Anteilsmäßige Verrechnung von Gutschriften.
| Klassisch | Flexibel |
|---|---|
| Wenn bei einer Aktualisierung eines Abonnements eine anteilmäßig verrechnete Gutschrift generiert wird, wurden zuvor die anteilig verrechneten Gutschriftsbeträge bisher auf der Grundlage des Wertes des aktuellen Preises, der Steuer, der Menge und der letzten verwendeten Rabatte des Abonnementartikels berechnet. | Wenn bei einer Aktualisierung eines Abonnements eine anteilmäßig verrechnete Gutschrift generiert wird, wird für diese anteilmäßigen Verrechnungen jetzt den ursprünglich abgebuchten Betrag anstelle der aktuellen Abonnementwerte verwendet. |
Anwendung von proportionalen Rabatten für anteilmäßige Verrechnungen
Bei der anteilmäßigen Verrechnung wenden wir Rabatte proportional auf jeden Abonnementartikel an, statt sie gleichmäßig zu verteilen. Dies führt zu mehr anteilmäßigen Verrechnungen, insbesondere bei der Rechnungsstellung pro Artikel oder bei der Stornierung von Artikeln mit ungleich verteilten Rabatten.
| Klassisch | Flexibel |
|---|---|
| Wir verteilen Rabatte gleichmäßig auf alle Abonnementartikel. | Bei der anteilmäßigen Verrechnung wenden wir Rabatte proportional auf jeden Abonnementartikel an. |
Preisgestaltung nach Verbrauchsmessung
Unterdrückt Einzelposten mit Nullbeträgen, wenn nutzungsbasierte Artikel hinzugefügt werden
Im flexiblen Abrechnungsmodus werden keine Einzelposten mit Nullbeträgen erstellt, wenn Sie nutzungsbasierte Artikel zu einem Abonnement hinzufügen. Wenn die Rechnung dadurch leer ist, generieren wir keine.
Wenn Sie beispielsweise während der Erstellung oder Aktualisierung eines Abonnements einen monatlichen nutzungsbasierten Artikel hinzufügen:
| Klassisch | Flexibel |
|---|---|
Auf der Rechnung wird ein 0 USD-Posten für den nutzungsbasierten Artikel generiert. Dies gilt auch, wenn Sie ein Abonnement ohne Zyklus aktualisieren, um mithilfe von proration_ einen nutzungsbasierten Artikel hinzuzufügen. | Ein 0 USD-Posten wird der Rechnung für den nutzungsbasierten Artikel nicht hinzugefügt. Wenn die Rechnung „leer“ ist, wird überhaupt keine Rechnung generiert |
Berechnet die gemessene Nutzung auf der Grundlage des Preises zum Zeitpunkt der Meldung
Beim flexiblen Abrechnungsmodus wird die Nutzung auf der Grundlage des Preises berechnet, der zum Zeitpunkt der Meldung der Nutzung galt, und nicht auf dem neuesten Preis.
Die Nutzung eines Kunden/einer Kundin wird beispielsweise wie folgt gemeldet:
- Nutzung am 5. Januar: 1000 API-Aufrufe zu 0.1 USD pro 100 Aufrufe (Preis A).
- Preisänderung am 15. Januar: Der Preis ändert sich in 0.15 USD pro 100 Aufrufe (Preis B).
Nutzung am 20. Januar: 500 API-Aufrufe.
| Klassisch | Flexibel |
|---|---|
| Die gesamte Nutzung, unabhängig davon, wann sie gemeldet wird, wird zu Preis B abgerechnet. Gesamtkosten: 1000 API-Aufrufe zu 0.15 USD = 150 USD 500 API-Aufrufe zu 0.15 USD = 75 USD Gesamtrechnungsbetrag = 225 USD. | Die Nutzung wird zu dem Preis abgerechnet, der zum Zeitpunkt der Meldung gültig ist. Zahlungen insgesamt: 1000 API-Aufrufe zu Preis A (0.1 USD) = 100 USD 500 API-Aufrufe zu Preis B (0.15 USD) = 75 USD Gesamtrechnungsbetrag = 175 USD. |
Nicht abgerechnete Nutzung wird in Rechnung gestellt, wenn nutzungsbasierte Artikel entfernt werden.
Beim flexiblen Abrechnungsmodus wird ein Rechnungsposten für nicht abgerechnete Nutzung generiert, wenn ein nutzungsbasierter Abonnementartikel entfernt wird. Dies gilt für Entfernungen mit der API oder während Zeitplanphasenübergängen.
| Klassisch | Flexibel |
|---|---|
| Es wird kein Rechnungsposten für nicht abgerechnete Nutzung erstellt, wenn ein nutzungsbasierter Abonnementartikel entfernt wird. | Ein Rechnungsposten wird für nicht abgerechnete Nutzung generiert, wenn ein nutzungsbasierter Abonnementartikel entfernt wird. |
Abrechnungszyklusanker wird zurückgesetzt
Beim flexiblen Abrechnungsmodus wird Ihr Abrechnungszyklusanker nur bei Abonnementaktualisierungen zurückgesetzt, wenn Sie billing_ explizit auf einen anderen Wert als unchanged setzen.
| Classic | Höchst flexibel |
|---|---|
Der billing_ wird automatisch auf das aktuelle Datum zurückgesetzt, wenn ein Abonnement auf einen anderen Preis mit einem anderen wiederkehrenden Intervall umgestellt wird (von einem Preis mit Nullbetrag auf einen Preis ungleich Null) oder wenn cancel_at auf ein Datum vor dem nächsten Abonnementzyklus verschoben wird. | Der billing_ wird nie automatisch zurückgesetzt. |
Konsolidierte Rechnungsstellung für Phasenübergänge von Abonnementplänen mit nutzungsbasierten Artikeln
Durch den flexiblen Abrechnungsmodus wird immer eine einzige Rechnung generiert, wenn ein Abonnement einen Abonnementzyklus hat. Durch diese Änderung entfallen separate Rechnungen für entfernte nutzungsbasierte Artikel und die Rechnungskonsistenz wird verbessert.
Wenn Ihr Abonnement mit nutzungsbasierten Artikeln zwischen Phasen wechselt:
| Klassisch | Flexibel |
|---|---|
| Es werden zwei Rechnungen generiert. | Es wird eine einzige konsolidierte Rechnung erzeugt. Diese Rechnung enthält sowohl nutzungsbasierte als auch lizenzierte Artikel, wendet Rabatte aus der vorherigen Phase auf die gemessene Nutzung an und verwendet Steuersätze aus der nächsten Phase. |
Geplante Kündigung
Sie können jetzt die anteilsmäßige Verrechnung für einen verkürzten ersten Abonnementzeitraum (wenn Sie bei der Erstellung cancel_ festlegen) mit dem Parameter proration_ deaktivieren.
| Klassisch | Flexibel |
|---|---|
| Anteilige Verrechnungen werden auf den ersten Abonnementzeitraum angewendet. | Anteilige Verrechnungen werden nicht auf den ersten Abonnementzeitraum angewendet. |
Rückdatieren
Die Rückdatierung entspricht der regulären Abrechnung
Beim flexiblen Abrechnungsmodus werden separate Rechnungsposten für jeden Abrechnungszeitraum innerhalb des rückdatierten Bereichs erstellt. Außerdem wird der Abrechnungszyklusanker automatisch auf das backdate_ ausgerichtet, wenn er nicht explizit festgelegt ist. Die Rückdatierung wird nicht unterstützt, wenn die resultierende Rechnung mehr als 250 Posten enthält.
Beispielsweise muss ein Abonnement aufgrund einer verpassten Rechnung für die letzten beiden Abrechnungszyklen rückdatiert werden. Der Kundin/dem Kunden wurden 2 verschiedene rückdatierte Zeiträume in Rechnung gestellt:
- Abrechnungszeitraum 1 (1. März bis 31. März):
- Gemeldete Nutzung: 100 GB Speicherplatz belegt.
- Preis: 10 USD pro 10 GB.
Abrechnungszeitraum 2 (1. April bis 30. April):
- Gemeldete Nutzung: 150 GB Speicherplatz belegt.
- Preis: 10 USD pro 10 GB.
Der Dienstleister entscheidet sich, die Rechnung so rückzudatieren, dass sie beide Abrechnungszeiträume abdeckt: 1. März bis 30. April.
| Classic | Höchst flexibel |
|---|---|
Zahlungen für den gesamten rückdatierten Zeitraum werden zusammengefasst als Einzelposten berechnet. Zahlungen insgesamt:
| Rückdatierte Zeitspannen werden entsprechend den Grenzen des Abonnementzeitraums in mehrere Rechnungsposten aufgeteilt. Zahlungen insgesamt:
|
Testzeiträume
Startdatum für nachfolgende Testversionen aktualisieren
Beim flexiblen Abrechnungsmodus wird das letzte Startdatum der Testversion für Abonnements mit nachfolgenden Testversionen verwendet.
Zum Beispiel, wenn Sie Folgendes haben:
- Testzeitraum vom 1. Januar bis 1. Februar
- Normaler Abrechnungszeitraum vom 1. Februar bis 1. März
- Testzeitraum vom 1. März bis 1. April
| Klassisch | Flexibel |
|---|---|
Das subscription.-Datum bezieht sich immer auf den ersten Testzeitraum eines Abonnements. | Das subscription.-Datum bezieht sich auf den Beginn der letzten Testphase eines Abonnements. |
Ursprüngliches Enddatum der Testversion beibehalten, wenn ein Abonnement gekündigt wird
Beim flexiblen Abrechnungsmodus wird das trial_-Datum beibehalten, wenn Sie das cancel_-Datum ändern.
| Classic | Höchst flexibel |
|---|---|
Wenn das trial_-Datum nach dem cancel_-Datum liegt, wird trial_ auf das Kündigungsdatum festgelegt. Wenn cancel_ später aktualisiert oder entfernt wird, wird trial_ nicht mehr auf seinen ursprünglichen Wert gesetzt. | Wenn Sie eine Abonnementkündigung mit cancel_ planen, bleibt das trial_-Datum davon unberührt. Dadurch wird sichergestellt, dass Testversionen unabhängig von der Aktualisierung des Kündigungsdatums für die vorgesehene Dauer ausgeführt werden. |
Postenbeschreibung für den Testzeitraum standardisieren
Beim Modus „Flexible Abrechnung“ wird während des Testzeitraums ein einheitliches Beschreibungsformat sowohl für nutzungsbasierte als auch für lizenzierte Artikel verwendet.
Wenn Sie beispielsweise ein monatliches Kaffee-Abonnement (lizenziert) und ein alpaca_-Abonnement (nutzungsbasiert) haben, wird die Abonnementbeschreibung wie folgt angezeigt:
| Klassisch | Flexibel |
|---|---|
Für lizenzierte Artikel wird die Vorlage
| Für alle Artikeltypen gilt das gleiche Format
|
Erneute Abrechnung für Testposten
Der flexible Abrechnungsmodus generiert nur Einzelposten für Änderungen, die während eines Testzeitraums vorgenommen werden. Bestehende Posten ohne Änderungen werden nicht erneut abgerechnet.
Wenn Sie beispielsweise eine Aktualisierung vornehmen, um einem Testabonnement mit price_ einen weiteren Testposten price_ hinzuzufügen:
| Classic | Höchst flexibel |
|---|---|
| Änderungen während eines Testzeitraums führen entweder zu keiner Rechnung oder zu einer Rechnung, die den gesamten Status des Abonnements wiedergibt. | Änderungen während eines Testzeitraums führen immer wieder zu Posten, die mit Änderungen außerhalb eines Testzeitraums vergleichbar sind. Wenn beispielsweise ein neuer Preis zu einem Abonnement hinzugefügt wird, wird auch ein Posten hinzugefügt, der diese Hinzufügung darstellt. |
Ausstehende Rechnungsposten
Ausstehende Rechnungsposten durchgängig einbeziehen
Der flexible Abrechnungsmodus umfasst alle verfügbaren ausstehenden Rechnungsposten in Rechnungen, die durch das Zurücksetzen des Abrechnungszyklusankers generiert wurden, wobei proration_.
| Klassisch | Flexibel |
|---|---|
Rechnungen zum Zurücksetzen des Abrechnungszyklusankers enthalten ausstehende Posten, Rechnungen mit Status always_ hingegen nicht. | Ausstehende Rechnungsposten sind immer in allen Rechnungen enthalten, die ein Abonnement generiert. |
Gemischte Intervalle für dasselbe Abonnement Private Vorschau
Der flexible Abrechnungsmodus ermöglicht Ihnen den Zugriff auf Abonnements mit gemischten Intervallen. Sie können mehrere wiederkehrende Preise mit unterschiedlichen Intervallen für ein einzelnes Abonnement in Rechnung stellen, indem Sie Abonnements mit gemischten Intervallen verwenden. So können Sie verschiedene Preisstrukturen innerhalb eines einzigen Abonnements kombinieren.
| Klassisch | Flexibel |
|---|---|
| Nicht unterstützt. Alle Posten in einem Abonnement müssen Preise mit dem gleichen Intervall und der gleichen Intervallanzahl haben. | Erstellen Sie Abonnements mit gemischten Intervallen, wobei die Posten eines Abonnements wiederkehrende Preise mit unterschiedlichen Intervallen oder Intervallzahlen haben können. Beispielsweise können ein monatlicher Preis und ein jährlicher Preis im selben Abonnement vorhanden sein. |
Beschränkungen
Der flexible Abrechnungsmodus ist nicht mit allen Funktionen von Stripe Billing kompatibel. Die folgenden Funktionen sind derzeit nicht kompatibel und geben beim Erstellen und Aktualisieren eines Abonnements den Fehlercode 400 zurück:
- Vorabrechnung Private Vorschau
- Kostenpflichtige Testversionen
- Ältere nutzungsbasierte Abrechnung
- Ältere Drittanbieter-Steuertax-Integrationen mit
pay_immediately=false - Die Verwendung des veralteten Parameters
max_occurences - Abonnementspezifische
retry_Private previewsettings - Abrechnungsschwellen