# Mehr Flexibilität für Abonnements ermöglichen Verwenden Sie den flexiblen Abrechnungsmodus, um erweiterte Funktionen zu erhalten und auf zusätzliche Funktionen zuzugreifen. Sie können Ihren bevorzugten [Abrechnungsmodus](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-billing_mode) 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. [Vergleichen Sie den klassischen mit dem flexiblen Abrechnungsmodus](https://docs.stripe.com/billing/subscriptions/billing-mode/compare.md). > Ein Abonnement kann nicht vom flexiblen Abrechnungsmodus in den klassischen Abrechnungsmodus migriert werden. ## 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](https://docs.stripe.com/billing/subscriptions/mixed-interval.md). 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](https://docs.stripe.com/billing/subscriptions/billing-mode.md#migrate-existing-subscriptions-to-flexible-billing-mode). 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](https://docs.stripe.com/billing/subscriptions/billing-mode/compare.md). ## 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](https://docs.stripe.com/changelog.md) 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](https://docs.stripe.com/upgrades.md#how-can-i-upgrade-my-api), ändert sich der Standardabrechnungsmodus für neue Abonnements entsprechend. - Wenn Sie Abos über das Dashboard (einschließlich [Zahlungslinks](https://docs.stripe.com/payment-links.md) und [Preistabellen](https://docs.stripe.com/payments/checkout/pricing-table.md)) erstellen oder aktualisieren, hängt der Standardwert von der [Standardeinstellung für den Abrechnungsmodus](https://dashboard.stripe.com/settings/billing/subscriptions) 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](https://docs.stripe.com/changelog/basil.md#2025-06-30.basil) oder höher befinden. Erfahren Sie, wie Sie [Ihre API-Version aktualisieren](https://docs.stripe.com/upgrades.md#how-can-i-upgrade-my-api). ### Neues Abonnement mit flexiblem Abrechnungsmodus erstellen #### Dashboard 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](https://docs.stripe.com/changelog/basil.md#2025-06-30.basil) oder höher sein. Um zu sehen, welche Version Sie verwenden, gehen Sie zur [Workbench-Übersicht](https://dashboard.stripe.com/workbench/overview) 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. Rufen Sie im Dashboard die Seite [Abonnements](https://dashboard.stripe.com/subscriptions) auf. 2. Klicken Sie auf **Abonnement erstellen**. 3. Erweitern Sie den Abschnitt **Abrechnung und Zahlungseinzug**. 4. Legen Sie den **Abrechnungsmodus** auf **Flexibel** fest. Der Standardwert für den Abrechnungsmodus hängt von Ihren Kontoeinstellungen ab. Sie können die angezeigten Abrechnungsmodus-Optionen und die Standardauswahl im Abonnement-Editor anpassen. Konfigurieren Sie dies unter **Einstellungen** > **Abrechnung** > **Abonnements und E-Mails** > [Standard-Abrechnungsmodus](https://dashboard.stripe.com/settings/billing/subscriptions). Im Abonnement-Editor können Sie festlegen, welche der folgenden 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 auf den klassischen Abrechnungsmodus angewiesen ist und Sie noch nicht auf den flexiblen Modus umstellen können. - **Flexibel:** Es werden sowohl der flexible als auch der klassische Abrechnungsmodus angezeigt, wobei standardmäßig der flexible Modus 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. 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. #### API Sie können den Parameter [billing_mode](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-billing_mode) als `flexible` bei API-Anfragen angeben, die ein Abo erstellen oder eine Vorschau einer Rechnung für ein Abo anzeigen. Wenn Sie diesen Parameter nicht angeben, hängt sein Standardwert von der von Ihnen verwendeten API-Version ab: - Für die API-Version `2025-08-27.preview` und alle späteren Preview-Versionen sowie für `2025-09-30.clover` (GA) und alle späteren GA-Versionen ist die Standardeinstellung „flexibel“. - Für alle anderen API-Versionen ist die Standardeinstellung `classic`. Diese API-Versionslogik bestimmt auch den Abrechnungsmodus für Abos, die von Payment Links und Preistabellen generiert werden. > Durch ein Upgrade Ihrer API-Version auf `2025-09-30.clover` oder höher wird der Standardabrechnungsmodus für neue Abonnements von `classic` auf `flexible` umgestellt. Der flexible Abrechnungsmodus verändert die Art und Weise, wie Abonnements anteilige Abrechnungen berechnen, Testphasen handhaben und Kündigungen bearbeiten. Um den klassischen Abrechnungsmodus nach dem Upgrade weiterhin zu verwenden, setzen Sie`billing_mode` bei der Erstellung von Abonnements ausdrücklich auf `classic`. [Informieren Sie sich vor dem Upgrade über die Unterschiede](https://docs.stripe.com/billing/subscriptions/billing-mode/compare.md). Hier ist ein Beispiel für die Verwendung der Subscriptions API: Hier ist die Anfrage: ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Version: 2025-06-30.basil" \ -d "items[0][price]={{PRICE_ID}}" \ -d "customer={{CUSTOMER_ID}}" \ -d "billing_mode[type]=flexible" \ -d payment_behavior=default_incomplete \ -d "payment_settings[save_default_payment_method]=on_subscription" ``` Hier ist die Antwort: ```json { "id": "sub_JgRjFjhKbtD2qz", "object": "subscription", "billing_mode": { "flexible": { "proration_discounts": "included" }, "type": "flexible", "updated_at": 1751071020 }, "application_fee_percent": null, "automatic_tax": { "disabled_reason": null, "enabled": false, "liability": "null" }, "billing_cycle_anchor": 1623873347, "billing_cycle_anchor_config": null, "cancel_at": null, "cancel_at_period_end": false, "canceled_at": null, "cancellation_details": { "comment": null, "feedback": null, "reason": null }, "collection_method": "charge_automatically", "created": 1623873347, "currency": "usd", "customer": "cus_CMqDWO2xODTZqt", "days_until_due": null, "default_payment_method": null, "default_source": null, "default_tax_rates": [ ], "discounts": [], "ended_at": null, "invoice_customer_balance_settings": { "account_tax_ids": null, "issuer": { "type": "self" } }, "items": { "object": "list", "data": [ { "id": "si_JgRjmS4Ur1khEx", "object": "subscription_item", "created": 1623873347, "current_period_end": 1626465347, "current_period_start": 1623873347, "discounts": [], "metadata": { }, "plan": { "id": "price_1J32RfGPZ1iASj5zHHp57z7C", "object": "plan", "active": true, "amount": 2000, "amount_decimal": "2000", "billing_scheme": "per_unit", "created": 1623864151, "currency": "usd", "interval": "month", "interval_count": 1, "livemode": false, "metadata": { }, "nickname": null, "product": "prod_JgPF5xnq7qBun3", "tiers": null, "tiers_mode": null, "transform_usage": null, "trial_period_days": null, "usage_type": "licensed" }, "price": { "id": "price_1J32RfGPZ1iASj5zHHp57z7C", "object": "price", "active": true, "billing_scheme": "per_unit", "created": 1623864151, "currency": "usd", "livemode": false, "lookup_key": null, "metadata": { }, "nickname": null, "product": "prod_JgPF5xnq7qBun3", "recurring": { "interval": "month", "interval_count": 1, "trial_period_days": null, "usage_type": "licensed" }, "tiers_mode": null, "transform_quantity": null, "type": "recurring", "unit_amount": 2000, "unit_amount_decimal": "2000" }, "quantity": 1, "subscription": "sub_JgRjFjhKbtD2qz", "tax_rates": [ ] } ], "has_more": false, "total_count": 1, "url": "/v1/subscription_items?subscription=sub_JgRjFjhKbtD2qz" }, "latest_invoice": { "id": "in_1J34pzGPZ1iASj5zB87qdBNZ", "object": "invoice", "account_country": "US", "account_name": "Angelina's Store", "account_tax_ids": null, "amount_due": 2000, "amount_overpaid": 0, "amount_paid": 0, "amount_remaining": 2000, "amount_shipping": 0, "attempt_count": 0, "attempted": false, "auto_advance": false, "automatic_tax": { "disabled_reason": null, "enabled": false, "liability": null, "status": null }, "automatically_finalizes_at": null, "billing_reason": "subscription_update", "collection_method": "charge_automatically", "created": 1623873347, "currency": "usd", "custom_fields": null, "customer": "cus_CMqDWO2xODTZqt", "customer_address": null, "customer_email": "angelina@stripe.com", "customer_name": null, "customer_phone": null, "customer_shipping": { "address": { "city": "", "country": "US", "line1": "Berry", "line2": "", "postal_code": "", "state": "" }, "name": "", "phone": null }, "customer_tax_exempt": "none", "customer_tax_ids": [ ], "default_payment_method": null, "default_source": null, "default_tax_rates": [ ], "description": null, "discounts": [], "due_date": null, "effective_at": "1623873347", "ending_balance": 0, "footer": null, "from_invoice": null, "hosted_invoice_url": "https://invoice.stripe.com/i/acct_1By64KGPZ1iASj5z/invst_JgRjzIOILGeq2MKC9T0KtyXnD5udsLp", "invoice_pdf": "https://pay.stripe.com/invoice/acct_1By64KGPZ1iASj5z/invst_JgRjzIOILGeq2MKC9T0KtyXnD5udsLp/pdf", "last_finalization_error": null, "latest_revision": null, "lines": { "object": "list", "data": [ { "id": "il_1N2CjMBwKQ696a5NeOawRQP2", "object": "line_item", "amount": 2000, "currency": "usd", "description": "1 × Gold Special (at $20.00 / month)", "discount_amounts": [ ], "discountable": true, "discounts": [ ], "invoice": "in_1J34pzGPZ1iASj5zB87qdBNZ", "livemode": false, "metadata": { }, "parent": { "invoice_item_details": null, "subscription_item_details": { "invoice_item": null, "proration": false, "proration_details": { "credited_items": null }, "subscription": "sub_JgRjFjhKbtD2qz", "subscription_item": "si_JgRjmS4Ur1khEx" }, "type": "subscription_item_details" }, "period": { "end": 1626465347, "start": 1623873347 }, "plan": { "id": "price_1J32RfGPZ1iASj5zHHp57z7C", "object": "plan", "active": true, "amount": 2000, "amount_decimal": "2000", "billing_scheme": "per_unit", "created": 1623864151, "currency": "usd", "interval": "month", "interval_count": 1, "livemode": false, "metadata": { }, "nickname": null, "product": "prod_JgPF5xnq7qBun3", "tiers": null, "tiers_mode": null, "transform_usage": null, "trial_period_days": null, "usage_type": "licensed" }, "price": { "id": "price_1J32RfGPZ1iASj5zHHp57z7C", "object": "price", "active": true, "billing_scheme": "per_unit", "created": 1623864151, "currency": "usd", "livemode": false, "lookup_key": null, "metadata": { }, "nickname": null, "product": "prod_JgPF5xnq7qBun3", "recurring": { "interval": "month", "interval_count": 1, "trial_period_days": null, "usage_type": "licensed" }, "tiers_mode": null, "transform_quantity": null, "type": "recurring", "unit_amount": 2000, "unit_amount_decimal": "2000" }, "quantity": 1, "taxes": [] } ], "has_more": false, "total_count": 1, "url": "/v1/invoices/in_1J34pzGPZ1iASj5zB87qdBNZ/lines" }, "livemode": false, "metadata": { }, "next_payment_attempt": null, "number": "C008FC2-0354", "on_behalf_of": null, "parent": { "quote_details": null, "subscription_details": { "metadata": {}, "pause_collection": null, "subscription": "sub_JgRjFjhKbtD2qz" } }, "payment_intent": { "id": "pi_1J34pzGPZ1iASj5zI2nOAaE6", "object": "payment_intent", "allowed_source_types": [ "card" ], "amount": 2000, "amount_capturable": 0, "amount_received": 0, "application": null, "application_fee_amount": null, "canceled_at": null, "cancellation_reason": null, "capture_method": "automatic", "charges": { "object": "list", "data": [ ], "has_more": false, "total_count": 0, "url": "/v1/charges?payment_intent=pi_1J34pzGPZ1iASj5zI2nOAaE6" }, "client_secret": "pi_1J34pzGPZ1iASj5zI2nOAaE6_secret_l7FN6ldFfXiFmJEumenJ2y2wu", "confirmation_method": "automatic", "created": 1623873347, "currency": "usd", "customer": "cus_CMqDWO2xODTZqt", "description": "Subscription creation", "invoice": "in_1J34pzGPZ1iASj5zB87qdBNZ", "last_payment_error": null, "livemode": false, "metadata": { }, "next_action": null, "next_source_action": null, "on_behalf_of": null, "payment_method": null, "payment_method_options": { "card": { "installments": null, "network": null, "request_three_d_secure": "automatic" } }, "payment_method_types": [ "card" ], "receipt_email": null, "review": null, "setup_future_usage": "off_session", "shipping": null, "source": "card_1By6iQGPZ1iASj5z7ijKBnXJ", "statement_descriptor": null, "statement_descriptor_suffix": null, "status": "requires_confirmation", "transfer_data": null, "transfer_group": null }, "payment_settings": { "payment_method_options": null, "payment_method_types": null, "save_default_payment_method": "on_subscription" }, "period_end": 1623873347, "period_start": 1623873347, "post_payment_credit_notes_amount": 0, "pre_payment_credit_notes_amount": 0, "receipt_number": null, "starting_balance": 0, "statement_descriptor": null, "status": "open", "status_transitions": { "finalized_at": 1623873347, "marked_uncollectible_at": null, "paid_at": null, "voided_at": null }, "subscription": "sub_JgRjFjhKbtD2qz", "subtotal": 2000, "tax": null, "tax_percent": null, "total": 2000, "total_discount_amounts": [], "total_tax_amounts": [], "transfer_data": null, "webhooks_delivered_at": 1623873347 }, "livemode": false, "metadata": { }, "next_pending_invoice_item_invoice": null, "pause_collection": null, "pending_invoice_item_interval": null, "pending_setup_intent": null, "pending_update": null, "plan": { "id": "price_1J32RfGPZ1iASj5zHHp57z7C", "object": "plan", "active": true, "amount": 2000, "amount_decimal": "2000", "billing_scheme": "per_unit", "created": 1623864151, "currency": "usd", "interval": "month", "interval_count": 1, "livemode": false, "metadata": { }, "nickname": null, "product": "prod_JgPF5xnq7qBun3", "tiers": null, "tiers_mode": null, "transform_usage": null, "trial_period_days": null, "usage_type": "licensed" }, "quantity": 1, "schedule": null, "start": 1623873347, "start_date": 1623873347, "status": "incomplete", "tax_percent": null, "transfer_data": null, "trial_end": null, "trial_start": null } ``` Auf ähnliche Weise können Sie `billing_mode` auf `flexible` einstellen, wenn Sie ein Abo aus den folgenden Quellen erstellen: - A [Checkout-Sitzung](https://docs.stripe.com/api/checkout/sessions/create.md?&rds=1#create_checkout_session-billing_mode) - A [Abonnementplan](https://docs.stripe.com/api/subscription_schedules/create.md?&rds=1#create_subscription_schedule-billing_mode) - A [Angebot](https://docs.stripe.com/api/quotes/create.md?&rds=1#create_quote-billing_mode) ### 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`. #### Dashboard Um den flexiblen Abrechnungsmodus zu verwenden, muss sich Ihre Integration auf der Stripe-API-Version [2025-06-30.basil](https://docs.stripe.com/changelog/basil.md#2025-06-30.basil) oder höher befinden. Um festzustellen, welche Version Sie verwenden, navigieren Sie zur Workbench-Übersicht und sehen Sie sich den Abschnitt **API-Versionen** an. Klicken Sie von dort aus auf **Upgrade**, um ein Upgrade auf eine neuere Version durchzuführen. 1. Wählen Sie auf der Seite [Abonnements](https://dashboard.stripe.com/subscriptions) im Dashboard das Abonnement aus, das Sie migrieren möchten. 2. Klicken Sie auf **Abonnement aktualisieren**. 3. Scrollen Sie herunter zum Abschnitt **Erweiterte Einstellungen**. 4. Legen Sie **Abrechnungsmodus** auf **Flexibel** fest und wählen Sie **Abonnement aktualisieren** aus. #### API Um den flexiblen Abrechnungsmodus zu verwenden, müssen Sie [Ihre API-Version](https://docs.stripe.com/upgrades.md#how-can-i-upgrade-my-api) auf [2025-06-30.basil](https://docs.stripe.com/changelog/basil.md#2025-06-30.basil) oder höher aktualisieren. Verwenden Sie die [API zum Migrieren](https://docs.stripe.com/api/subscriptions/migrate.md), um `billing_mode` für ein bestehendes Abonnement auf `flexible` zu setzen. Nachdem das Abonnement zum flexiblen Abrechnungsmodus migriert wurde, gibt der Zeitstempel `billing_mode.updated_at` an, wann die Migration stattgefunden hat. Nachfolgend finden Sie ein Beispiel für eine Anfrage und eine Antwort: Hier ist die Anfrage: ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}}/migrate \ -u "<>:" \ -d "billing_mode[type]=flexible" ``` Hier ist die Antwort: Die Antwort zeigt das aktualisierte Abonnement mit `billing_mode` auf `flexible` und dem Zeitstempel `billing_mode_details.updated_at`: ```json { "id": "sub_123", "billing_mode": "flexible", "billing_mode_details": { "updated_at": 1716883200 } } ``` ### Das ändert sich nach der Migration Die Migration in den flexiblen Abrechnungsmodus ändert für alle nach der Migration erfolgenden neuen Aktivitäten im Abonnement die Art und Weise, wie Stripe anteilmäßige Verrechnungen berechnet, die nutzungsbasierte Abrechnung handhabt und Stornierungen verarbeitet. Vor der Migration erstellte Ressourcen berechnet Stripe nicht neu. Das gilt auch für ausstehende Rechnungsposten für anteilmäßige Verrechnung. Wichtige Folgen der Migration: - Gutschriften aus anteilmäßiger Verrechnung verwenden den ursprünglich in Rechnung gestellten Betrag und nicht die aktuellen Abonnementwerte. - Die nutzungsbasierte Abrechnung erfolgt zu dem Preis, der zum Zeitpunkt der Meldung der Nutzung gültig war. - Der Abrechnungszyklusanker wird niemals automatisch zurückgesetzt. - Sie können ein Abonnement nicht vom flexiblen Abrechnungsmodus in den klassischen Abrechnungsmodus zurücksetzen. Wichtige Vorteile der Migration: - Zugriff auf neue Funktionen wie [Abonnements mit gemischten Intervallen](https://docs.stripe.com/billing/subscriptions/mixed-interval.md) und [Testangebote](https://docs.stripe.com/billing/subscriptions/trials.md). - Genauere und besser vorhersehbare Berechnungen der anteilmäßigen Verrechnung. - Konsistente Handhabung nutzungsbasierter Posten bei Abonnementänderungen während eines laufenden Zyklus. Eine vollständige Aufschlüsselung der Verhaltensunterschiede finden Sie unter [Vergleich von klassischem und flexiblem Abrechnungsmodus](https://docs.stripe.com/billing/subscriptions/billing-mode/compare.md). ### Abrechnungsmodus und Abonnementpläne Sie können ein Abonnement mit einem aktiven Abonnementplan über die [Migrate API](https://docs.stripe.com/api/subscriptions/migrate.md) in den flexiblen Abrechnungsmodus migrieren. Das Dashboard unterstützt die Migration des Abrechnungsmodus für Abonnements mit aktiven Plänen nicht. Wenn Sie über die API migrieren, aktualisiert Stripe automatisch auch den `billing_mode` des Abonnementplans. > Wenn ein Abonnementplan noch nicht gestartet wurde und kein aktives Abonnement hat, können Sie ihn nicht migrieren. Stornieren Sie den Plan, erstellen Sie ihn neu und setzen Sie dabei `billing_mode` auf `flexible`. Wenn Sie einen Abonnementplan aus einem bestehenden Abonnement erstellen, legen Sie keinen `billing_mode` fest, falls das Abonnement bereits einen hat. Der Plan übernimmt automatisch den `billing_mode` des ursprünglichen Abonnements. Wenn Sie den `billing_mode` festlegen und gleichzeitig `from_subscription` verwenden, gibt Stripe einen Fehler zurück. ### Anteilmäßig verrechnete Rabatte aufschlüsseln Bei der Verwendung flexibler Abonnements können Sie Ihr bevorzugtes Verhalten für [anteilmäßig verrechnete Rabatte](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-billing_mode-flexible-proration_discounts) auf Rechnungen und Rechnungsposten festlegen: - **Aufgeschlüsselt** (Empfohlen): 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“](https://docs.stripe.com/billing/subscriptions/billing-mode/compare.md). Um detaillierte anteilige Rabatte zu aktivieren, müssen Sie [Ihre API-Version aktualisieren](https://docs.stripe.com/upgrades.md#how-can-i-upgrade-my-api): entweder auf [2025-06-30.basil](https://docs.stripe.com/changelog/basil.md#2025-06-30.basil) oder höher. [Erstellen](https://docs.stripe.com/api/subscriptions/create.md) oder [migrieren Sie](https://docs.stripe.com/api/subscriptions/migrate.md) ein Abonnement, um `proration_discounts` auf `itemized` festzulegen. ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -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: ```json { "id": "sub_JgRjFjhKbtD2qz", "object": "subscription", "billing_mode": { "flexible": { "proration_discounts": "itemized" }, "type": "flexible", "updated_at": 1751071020 }, "application_fee_percent": null, "automatic_tax": { "disabled_reason": null, "enabled": false, "liability": "null" }, "billing_cycle_anchor": 1623873347, "billing_cycle_anchor_config": null, "cancel_at": null, "cancel_at_period_end": false, "canceled_at": null, "cancellation_details": { "comment": null, "feedback": null, "reason": null }, "collection_method": "charge_automatically", "created": 1623873347, "currency": "usd", "customer": "cus_CMqDWO2xODTZqt", "days_until_due": null, "default_payment_method": null, "default_source": null, "default_tax_rates": [ ], "discounts": [], "ended_at": null, "invoice_customer_balance_settings": { "account_tax_ids": null, "issuer": { "type": "self" } }, "items": { "object": "list", "data": [ { "id": "si_JgRjmS4Ur1khEx", "object": "subscription_item", "created": 1623873347, "current_period_end": 1626465347, "current_period_start": 1623873347, "discounts": [], "metadata": { }, "plan": { "id": "price_1J32RfGPZ1iASj5zHHp57z7C", "object": "plan", "active": true, "amount": 2000, "amount_decimal": "2000", "billing_scheme": "per_unit", "created": 1623864151, "currency": "usd", "interval": "month", "interval_count": 1, "livemode": false, "metadata": { }, "nickname": null, "product": "prod_JgPF5xnq7qBun3", "tiers": null, "tiers_mode": null, "transform_usage": null, "trial_period_days": null, "usage_type": "licensed" }, "price": { "id": "price_1J32RfGPZ1iASj5zHHp57z7C", "object": "price", "active": true, "billing_scheme": "per_unit", "created": 1623864151, "currency": "usd", "livemode": false, "lookup_key": null, "metadata": { }, "nickname": null, "product": "prod_JgPF5xnq7qBun3", "recurring": { "interval": "month", "interval_count": 1, "trial_period_days": null, "usage_type": "licensed" }, "tiers_mode": null, "transform_quantity": null, "type": "recurring", "unit_amount": 2000, "unit_amount_decimal": "2000" }, "quantity": 1, "subscription": "sub_JgRjFjhKbtD2qz", "tax_rates": [ ] } ], "has_more": false, "total_count": 1, "url": "/v1/subscription_items?subscription=sub_JgRjFjhKbtD2qz" }, "latest_invoice": { "id": "in_1J34pzGPZ1iASj5zB87qdBNZ", "object": "invoice", "account_country": "US", "account_name": "Angelina's Store", "account_tax_ids": null, "amount_due": 2000, "amount_overpaid": 0, "amount_paid": 0, "amount_remaining": 2000, "amount_shipping": 0, "attempt_count": 0, "attempted": false, "auto_advance": false, "automatic_tax": { "disabled_reason": null, "enabled": false, "liability": null, "status": null }, "automatically_finalizes_at": null, "billing_reason": "subscription_update", "collection_method": "charge_automatically", "created": 1623873347, "currency": "usd", "custom_fields": null, "customer": "cus_CMqDWO2xODTZqt", "customer_address": null, "customer_email": "angelina@stripe.com", "customer_name": null, "customer_phone": null, "customer_shipping": { "address": { "city": "", "country": "US", "line1": "Berry", "line2": "", "postal_code": "", "state": "" }, "name": "", "phone": null }, "customer_tax_exempt": "none", "customer_tax_ids": [ ], "default_payment_method": null, "default_source": null, "default_tax_rates": [ ], "description": null, "discounts": [], "due_date": null, "effective_at": "1623873347", "ending_balance": 0, "footer": null, "from_invoice": null, "hosted_invoice_url": "https://invoice.stripe.com/i/acct_1By64KGPZ1iASj5z/invst_JgRjzIOILGeq2MKC9T0KtyXnD5udsLp", "invoice_pdf": "https://pay.stripe.com/invoice/acct_1By64KGPZ1iASj5z/invst_JgRjzIOILGeq2MKC9T0KtyXnD5udsLp/pdf", "last_finalization_error": null, "latest_revision": null, "lines": { "object": "list", "data": [ { "id": "il_1N2CjMBwKQ696a5NeOawRQP2", "object": "line_item", "amount": 2000, "currency": "usd", "description": "1 × Gold Special (at $20.00 / month)", "discount_amounts": [ ], "discountable": true, "discounts": [ ], "invoice": "in_1J34pzGPZ1iASj5zB87qdBNZ", "livemode": false, "metadata": { }, "parent": { "invoice_item_details": null, "subscription_item_details": { "invoice_item": null, "proration": false, "proration_details": { "credited_items": null }, "subscription": "sub_JgRjFjhKbtD2qz", "subscription_item": "si_JgRjmS4Ur1khEx" }, "type": "subscription_item_details" }, "period": { "end": 1626465347, "start": 1623873347 }, "plan": { "id": "price_1J32RfGPZ1iASj5zHHp57z7C", "object": "plan", "active": true, "amount": 2000, "amount_decimal": "2000", "billing_scheme": "per_unit", "created": 1623864151, "currency": "usd", "interval": "month", "interval_count": 1, "livemode": false, "metadata": { }, "nickname": null, "product": "prod_JgPF5xnq7qBun3", "tiers": null, "tiers_mode": null, "transform_usage": null, "trial_period_days": null, "usage_type": "licensed" }, "price": { "id": "price_1J32RfGPZ1iASj5zHHp57z7C", "object": "price", "active": true, "billing_scheme": "per_unit", "created": 1623864151, "currency": "usd", "livemode": false, "lookup_key": null, "metadata": { }, "nickname": null, "product": "prod_JgPF5xnq7qBun3", "recurring": { "interval": "month", "interval_count": 1, "trial_period_days": null, "usage_type": "licensed" }, "tiers_mode": null, "transform_quantity": null, "type": "recurring", "unit_amount": 2000, "unit_amount_decimal": "2000" }, "quantity": 1, "taxes": [] } ], "has_more": false, "total_count": 1, "url": "/v1/invoices/in_1J34pzGPZ1iASj5zB87qdBNZ/lines" }, "livemode": false, "metadata": { }, "next_payment_attempt": null, "number": "C008FC2-0354", "on_behalf_of": null, "parent": { "quote_details": null, "subscription_details": { "metadata": {}, "pause_collection": null, "subscription": "sub_JgRjFjhKbtD2qz" } }, "payment_intent": { "id": "pi_1J34pzGPZ1iASj5zI2nOAaE6", "object": "payment_intent", "allowed_source_types": [ "card" ], "amount": 2000, "amount_capturable": 0, "amount_received": 0, "application": null, "application_fee_amount": null, "canceled_at": null, "cancellation_reason": null, "capture_method": "automatic", "charges": { "object": "list", "data": [ ], "has_more": false, "total_count": 0, "url": "/v1/charges?payment_intent=pi_1J34pzGPZ1iASj5zI2nOAaE6" }, "client_secret": "pi_1J34pzGPZ1iASj5zI2nOAaE6_secret_l7FN6ldFfXiFmJEumenJ2y2wu", "confirmation_method": "automatic", "created": 1623873347, "currency": "usd", "customer": "cus_CMqDWO2xODTZqt", "description": "Subscription creation", "invoice": "in_1J34pzGPZ1iASj5zB87qdBNZ", "last_payment_error": null, "livemode": false, "metadata": { }, "next_action": null, "next_source_action": null, "on_behalf_of": null, "payment_method": null, "payment_method_options": { "card": { "installments": null, "network": null, "request_three_d_secure": "automatic" } }, "payment_method_types": [ "card" ], "receipt_email": null, "review": null, "setup_future_usage": "off_session", "shipping": null, "source": "card_1By6iQGPZ1iASj5z7ijKBnXJ", "statement_descriptor": null, "statement_descriptor_suffix": null, "status": "requires_confirmation", "transfer_data": null, "transfer_group": null }, "payment_settings": { "payment_method_options": null, "payment_method_types": null, "save_default_payment_method": "on_subscription" }, "period_end": 1623873347, "period_start": 1623873347, "post_payment_credit_notes_amount": 0, "pre_payment_credit_notes_amount": 0, "receipt_number": null, "starting_balance": 0, "statement_descriptor": null, "status": "open", "status_transitions": { "finalized_at": 1623873347, "marked_uncollectible_at": null, "paid_at": null, "voided_at": null }, "subscription": "sub_JgRjFjhKbtD2qz", "subtotal": 2000, "tax": null, "tax_percent": null, "total": 2000, "total_discount_amounts": [], "total_tax_amounts": [], "transfer_data": null, "webhooks_delivered_at": 1623873347 }, "livemode": false, "metadata": { }, "next_pending_invoice_item_invoice": null, "pause_collection": null, "pending_invoice_item_interval": null, "pending_setup_intent": null, "pending_update": null, "plan": { "id": "price_1J32RfGPZ1iASj5zHHp57z7C", "object": "plan", "active": true, "amount": 2000, "amount_decimal": "2000", "billing_scheme": "per_unit", "created": 1623864151, "currency": "usd", "interval": "month", "interval_count": 1, "livemode": false, "metadata": { }, "nickname": null, "product": "prod_JgPF5xnq7qBun3", "tiers": null, "tiers_mode": null, "transform_usage": null, "trial_period_days": null, "usage_type": "licensed" }, "quantity": 1, "schedule": null, "start": 1623873347, "start_date": 1623873347, "status": "incomplete", "tax_percent": null, "transfer_data": null, "trial_end": null, "trial_start": null } ```