Mehr Flexibilität für Abonnements ermöglichen

Sie können Ihren bevorzugten Abrechnungsmodus festlegen, um Ihre Rechnungen und Abos entsprechend Ihren geschäftlichen Anforderungen zu organisieren. Sie können jedes Abo so konfigurieren, dass es einen der beiden folgenden Abrechnungsmodi verwendet:

• Flexibel Recommended: Bietet präzises und vorhersehbares Abrechnungsverhalten sowie neue Funktionen. Um auf diese Verbesserungen zugreifen zu können, die nur im flexiblen Abrechnungsmodus verfügbar sind, müssen Sie neue Abonnements mit flexiblem Abrechnungsmodus erstellen oder Ihre bestehenden Abonnements migrieren.
• Klassisch: Verwendet das bestehende Stripe-Abonnementverhalten. Diese Einstellung wird aus Gründen der Abwärtskompatibilität mit älteren Integrationen beibehalten.

Erfahren Sie mehr über die detaillierten Unterschiede zwischen dem klassischen und dem flexiblen Abrechnungsmodus und finden Sie heraus, welcher Abrechnungsmodus am besten für Sie geeignet ist.

Warum den flexiblen Abrechnungsmodus wählen

Der flexible Abrechnungsmodus ermöglicht eine genauere Abrechnung für anteilmäßig verrechnete Preise, nutzungsbasierte Preise, flexible Rechnungsstellung und Testzeiträume. Er schaltet auch neue Funktionen frei, wie gemischte Intervalle für dasselbe Abo. Diese Verbesserungen sind nur im flexiblen Abrechnungsmodus verfügbar. Deshalb empfehlen wir Ihnen, neue Abos mit flexiblem Abrechnungsmodus zu erstellen und Ihre bestehenden Abos zu migrieren.

Wir empfehlen neuen Billing-Nutzerinnen und -Nutzern, für Abonnements und Rechnungen den flexiblen Abrechnungsmodus zu verwenden, auch wenn dies nicht verpflichtend ist.

Für bestehende Nutzer/innen bleibt der Standardabrechnungsmodus als „klassisch“ erhalten, um die Abwärtskompatibilität mit Ihrer aktuellen Integration zu wahren. Wir empfehlen jedoch die Umstellung auf den flexiblen Abrechnungsmodus, um die neuesten Abrechnungsfunktionen und Verbesserungen nutzen zu können. Erfahren Sie mehr über die Unterschiede zwischen dem klassischen und dem flexiblen Abrechnungsmodus.

Starten Sie mit dem flexiblen Abrechnungsmodus

Sie können den Abrechnungsmodus über die API oder das Dashboard festlegen oder aktualisieren, wenn Sie Abonnements erstellen oder migrieren. Wenn Sie keinen Modus angeben, wenden wir einen Standard-Abrechnungsmodus an.

• Wenn Sie ein Abo über die API erstellen oder aktualisieren, hängt der Standardwert für den Abrechnungsmodus von Ihrer API-Integrationsversion ab.
• Wenn Sie Abos über das Dashboard (einschließlich Zahlungslinks und Preistabellen) erstellen oder aktualisieren, hängt der Standardwert von der Standardeinstellung für den Abrechnungsmodus ab, die Sie unter Einstellungen > Abrechnung > Abos und E-Mails konfigurieren.

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.

Neues Abonnement mit flexiblem Abrechnungsmodus erstellen

Dashboard

API

Unabhängig von der API-Version Ihrer Integration können Sie über das Dashboard ein Abo mit flexiblem Abrechnungsmodus erstellen oder ein Abo mit klassischem Abrechnungsmodus auf einen flexiblen Modus umstellen. Um diese Abos in der Stripe-API vollständig zu ändern, muss Ihre Integration auf Version 2025-06-30.basil oder höher sein. Um zu sehen, welche Version Sie verwenden, gehen Sie zur Workbench-Übersicht und sehen Sie sich den Abschnitt „API-Versionen“ an. Klicken Sie dort auf Upgrade, um ein Upgrade auf eine neuere Version durchzuführen.

Führen Sie die folgenden Schritte aus, um ein Abo mit flexiblem Abrechnungsmodus über den Abonnement-Editor zu erstellen:

1. Gehen Sie im Dashboard zur Seite Abonnements.
2. Wählen Sie +Abonnement erstellen aus.
3. Scrollen Sie herunter zum Abschnitt Erweiterte Einstellungen.
4. Legen Sie Abrechnungsmodus auf Flexibel fest.

Der Standardwert für den Abrechnungsmodus hängt von Ihren Kontoeinstellungen ab. Sie können die angezeigten Abrechnungsmodusoptionen und die Standardauswahl in den Erweiterten Einstellungen anpassen, indem Sie die Einstellung für den Standard-Abrechnungsmodus unter Einstellungen > Abrechnung > Abos und E-Mails konfigurieren. Im Abonnement-Editor können Sie festlegen, welche Optionen für den Abrechnungsmodus angezeigt werden sollen:

• Klassisch: Sowohl der flexible als auch der klassische Abrechnungsmodus werden angezeigt, wobei standardmäßig der klassische Modus ausgewählt ist. Diese Option wird empfohlen, wenn Ihre Integration vom klassischen Abrechnungsmodus abhängt und Sie noch nicht auf den flexiblen Modus umstellen können.
• Flexibel: Es werden sowohl der flexible als auch der klassische Abrechnungsmodus angezeigt, wobei flexibel standardmäßig ausgewählt ist. Diese Option wird empfohlen, wenn Sie aktiv auf den flexiblen Abrechnungsmodus umstellen.
• Flexibel – klassisch ausblenden: Nur der flexible Abrechnungsmodus wird im Abonnement-Editor angezeigt. Diese Option empfiehlt sich für neue Nutzer/innen von Stripe Billing sowie für bestehende Nutzer/innen, die ausschließlich den flexiblen Abrechnungsmodus verwenden.

Einstellungen des Dashboard-Abrechnungsmodus

Die Standardeinstellung des Abrechnungsmodus bestimmt auch den Abrechnungsmodus für Abos, die über vom Dashboard generierte Zahlungslinks und Preistabellen erstellt werden. Wenn Sie etwa den Abrechnungsmodus standardmäßig auf „flexibel“ einstellen und anschließend einen Zahlungslink im Dashboard erstellen, verwenden alle über diesen Zahlungslink generierten Abos den flexiblen Abrechnungsmodus.

Die Standardeinstellung für den Abrechnungsmodus gilt nur für neue Abos, die über das Dashboard erstellt wurden. Sie hat keine Auswirkungen auf Abos, die über die API erstellt oder in den flexiblen Modus migriert wurden.

Bestehende Abonnements zum flexiblen Abrechnungsmodus migrieren

Sie können Ihre bestehenden Abonnements in den flexiblen Abrechnungsmodus migrieren. Die flexiblen Verhaltensweisen gelten für alle neuen Aktivitäten im Abonnement nach der Migration. Stripe berechnet jedoch keine Ressourcen neu, die vor der Migration erstellt wurden, einschließlich ausstehender anteilmäßig verrechneter Invoice Items.

Abrechnungsmodus und Abonnementpläne

Wenn Sie einen Abonnementplan aus einem bestehenden Abo erstellen, setzen Sie billing_mode nicht, wenn das Abo bereits über einen solchen verfügt. Der Plan übernimmt automatisch den billing_mode aus dem ursprünglichen Abo. Wenn Sie bei Verwendung von from_subscription einen billing_mode festlegen, gibt Stripe eine Fehlermeldung aus. Falls Sie einen anderen billing_mode benötigen, erstellen Sie bitte ein neues Abo.

Anteilmäßig verrechnete Rabatte aufschlüsseln

Bei der Verwendung flexibler Abonnements können Sie Ihr bevorzugtes Verhalten für anteilmäßig verrechnete Rabatte auf Rechnungen und Rechnungsposten festlegen:

• Aufgeschlüsselt Recommended: Ermöglicht die Anzeige von anteilmäßig verrechneten Beträgen mit Bruttobeträgen und genauen Rabattbeträgen in Rechnungen und Rechnungsposten, entsprechend den nicht anteilmäßig verrechneten Beträgen.
• Enthalten: Verwendet das vorhandene Anzeigeverhalten von Stripe für anteilige Berechnungen mit Nettobeträgen und monetären Rabattbeträgen von Null. Diese Einstellung wird aus Gründen der Abwärtskompatibilität mit älteren Integrationen beibehalten.

Erfahren Sie mehr über die Unterschiede zwischen „Aufgeschlüsselt“ und „Enthalten“.

Um detaillierte anteilige Rabatte zu aktivieren, müssen Sie Ihre API-Version aktualisieren: entweder auf 2025-06-30.basil oder höher.

Erstellen oder migrieren Sie ein Abonnement, um proration_discounts auf itemized festzulegen.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-06-30.basil" \
  -d "items[0][price]"=
"{{PRICE_ID}}" \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d "billing_mode[type]"=flexible \
  -d "billing_mode[flexible][proration_discounts]"=itemized \
  -d payment_behavior=default_incomplete \
  -d "payment_settings[save_default_payment_method]"=on_subscription

Das obige Codebeispiel gibt die folgende Antwort zurück:

{
  "id": "sub_JgRjFjhKbtD2qz",
  "object": "subscription",
  "billing_mode": {
    "flexible": {
      "proration_discounts": "itemized"
    },
    "type": "flexible",
    "updated_at": 1751071020
  },