Weiter zum Inhalt
Konto erstellen
oder
anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellen
Anmelden
Jetzt starten
Zahlungen
Umsatz
Plattformen und Marktplätze
Geldmanagement
Entwicklerressourcen
Übersicht
Versionierung
Änderungsprotokoll
    Übersicht
    Basilikum
    Acacia
    Vorherige Versionen
Aktualisieren Sie Ihre API-Version
Ihre SDK-Version aktualisieren
Essentials
SDKs
API
Tests
Stripe-CLI
Beispiel-Projekte
Tools
Workbench
Entwickler-Dashboard
Stripe Shell
Stripe für Visual Studio Code
Funktionen
Arbeitsabläufe
Ereignisziele
Stripe-StatuswarnungenHochgeladene Dateien
KI-Lösungen
Agent-Toolkit
Model Context Protocol
Sicherheit und Datenschutz
Sicherheit
Stripebot-Webcrawler
Datenschutz
Extend Stripe
Erstellen Sie Stripe-Apps
Verwenden Sie Apps von Stripe
Partner
Partner-Ecosystem
Partner-Zertifizierung
StartseiteEntwicklerressourcenChangelogBasil2025-04-30.preview

Fügt den Abrechnungsmodus hinzu, um ein verbessertes Verhalten bei der anteilsmäßigen Verrechnung von Krediten zu unterstützenÖffentliche Vorschau

Das ändert sich

Mit dem neuen Parameter billing_mode können Sie ein flexibleres Verhalten beim Erstellen von Abonnements, der Rechnungsvorschau, Checkout-Sitzungen oder Abonnementplänen aktivieren.

billing_mode=classicbilling_mode=flexible
Die Beträge anteilmäßig verrechneter Gutschriften werden auf der Grundlage des aktuellen Preises, der Steuer, der Menge und der letzten genutzten Rabatte des Abonnementartikels berechnet. Dies kann zu unerwarteten anteilmäßigen Verrechnungen führen, wenn sich Kundensteuersätze in der Mitte des Abrechnungszyklus ändern, die anteilmäßige Verrechnung von Lastschriften deaktiviert ist oder komplexe Rabattgutscheine verwendet werden.Anteilmäßige Verrechnungen von Gutschriften werden auf der Grundlage des ursprünglichen Betrags berechnet, der zuvor von einem Kunden/einer Kundin abgebucht wurde. Dadurch wird die Ermittlung anteilmäßiger Verrechnungen unter Berücksichtigung von Steuern, Gutscheinen und Überlegungen zum Abrechnungszyklus verbessert. Bei der anteilmäßigen Verrechnung von Gutschriften werden beispielsweise Steuern basierend auf der ursprünglichen Abbuchung korrekt erstattet (wenn sich der Steuersatz in der Mitte des Abrechnungszeitraums geändert hat). Es werden keine anteilmäßig verrechneten Gutschriften ausgestellt, wenn keine Abbuchung erfolgte.
subscription.trial_start bleibt unverändert, wenn ein Abonnement wieder in den Status trialing wechselt.subscription.trial_start wird aktualisiert, um das Startdatum der letzten Testversion widerzuspiegeln.
Der billing_cycle_anchor wird manchmal während anderer Vorgänge zurückgesetzt:
  • billing_cycle_anchor wird auf das cancel_at-Datum zurückgesetzt, wenn cancel_at auf ein Datum vor dem nächsten Zeitpunkt des Abonnementzyklus festgelegt wird.
  • billing_cycle_anchor wird auf den aktuellen Zeitpunkt zurückgesetzt, wenn von einem Abonnement mit allen Preisen in USD zu einem Abonnement mit mindestens einem Preis über 0 USD gewechselt wird.
  • billing_cycle_anchor wird auf den aktuellen Zeitpunkt zurückgesetzt, wenn zu einem Preis mit einem anderen wiederkehrenden Intervall gewechselt wird.
billing_cycle_anchor wird bei anderen Vorgängen nicht zurückgesetzt:
  • billing_cycle_anchor ändert sich nicht, wenn cancel_at auf ein Datum vor dem nächsten Zeitpunkt der Abonnementzyklen festgelegt wird.
  • billing_cycle_anchor ändert sich nicht, wenn von einem Abonnement mit allen Preisen von 0 USD zu einem Abonnement mit mindestens einem Preis über 0 USD gewechselt wird.
  • billing_cycle_anchor ändert sich nicht, wenn zu einem Preis mit einem anderen wiederkehrenden Intervall gewechselt wird.

Die Konfiguration von billing_mode als flexible unterliegt Einschränkungen. Erfahren Sie mehr über die Einschränkungen und wie der Abrechnungsmodus flexibles Verhalten für Abonnements ermöglicht.

Ergebnis

Sie können billing_mode für die folgenden API Methoden zum Erstellen eines Abonnements auf flexible festlegen:

  • Abonnement erstellen
  • Rechnungsvorschau erstellen
  • Checkout-Sitzung erstellen
  • Abonnementplan erstellen

Änderungen

ParameterÄndernRessourcen oder Endpoints
billing_modeHinzugefügt
Checkout.Session#create.subscription_dataInvoice#create_preview.schedule_detailsInvoice#create_preview.subscription_details
 + 7 weitere
Quote#create.subscription_dataQuote.subscription_dataQuotePreviewSubscriptionScheduleSubscription#createSubscriptionSchedule#createSubscriptionScheduleSubscription

Upgrade

  1. Zeigen Sie Ihre aktuelle API-Version in Workbench an.
  2. Wenn Sie ein SDK verwenden, aktualisieren Sie auf die entsprechende SDK-Version für diese API-Version.
    • Wenn Sie kein SDK verwenden, aktualisieren Sie Ihre API-Anfragen auf Stripe-Version: 2025-04-30.preview
  3. Aktualisieren Sie die für Webhook-Endpoints verwendete API-Version.
  4. Testen Sie Ihre Integration mit der neuen Version.
  5. Wenn Sie Connect verwenden, testen Sie Ihre Connect-Integration.
  6. Führen Sie das Upgrade in Workbench durch. Sie können die Version für 72 Stunden zurücksetzen.

Erfahren Sie mehr über Stripe-API-Upgrades.

War diese Seite hilfreich?
JaNein
  • Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
  • Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
  • Schauen Sie sich unser Änderungsprotokoll an.
  • Fragen? Sales-Team kontaktieren.
  • LLM? Lesen Sie llms.txt.
  • Unterstützt von Markdoc