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 Abonnement über die API erstellen oder aktualisieren, hängt der Standardabrechnungsmodus von Ihrer API-Integrationsversion ab. Für die API-Version 2025-09-30.clover und höher ist der Standardmodus flexible. Bei früheren Versionen ist der Standardmodus classic. Wenn Sie Ihre API-Version upgraden, ändert sich der Standardabrechnungsmodus für neue Abonnements entsprechend.
• 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

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_Y17KokhC3SRYCQTLYiU5ZCD2
:" \
  -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
  },