Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellenAnmelden
Jetzt starten
Zahlungen
Umsatz
Plattformen und Marktplätze
Geldmanagement
Entwicklerressourcen
APIs und SDKsHilfe
Übersicht
Versionierung
Änderungsprotokoll
    Übersicht
    Clover
    Basil
    Acacia
    Vorherige Versionen
Aktualisieren Sie Ihre API-Version
Ihre SDK-Version aktualisieren
Essentials
SDKs
API
Tests
Stripe-CLI
Beispiel-Projekte
Tools
Stripe Dashboard
Workbench
Entwickler-Dashboard
Stripe für Visual Studio Code
Terraform
Funktionen
Arbeitsabläufe
Ereignisziele
Stripe-StatuswarnungenHochgeladene Dateien
KI-Lösungen
Agent-Toolkit
Model Context ProtocolAgentische KI-SaaS-Billing-Workflows aufbauen
Sicherheit und Datenschutz
Sicherheit
Stripebot-Webcrawler
Stripe erweitern
Erstellen Sie Stripe-Apps
Verwenden Sie Apps von Stripe
Partner
Partner-Ecosystem
Partner-Zertifizierung
Vereinigte Staaten
Deutsch
StartseiteEntwicklerressourcenChangelogBasil2025-08-27.basil

Hinweis

Bis jetzt ist diese Seite noch nicht in dieser Sprache verfügbar. Wir arbeiten aber verstärkt daran, unsere Dokumentation in weiteren Sprachen bereitzustellen, und werden die Übersetzung sofort anzeigen, sobald diese verfügbar ist.

Fügt Support für Rechnungsposten-Metadaten und den Zeitraum in Abonnements und Zeitplänen hinzu

Das ändert sich

Wir haben eine neue Möglichkeit eingeführt, die Felder metadata und period für einmalige Rechnungsposten, die von Abonnements und Abonnementplänen generiert werden, anzupassen.

  • Sie können metadata direkt anhängen, wenn Sie add_invoice_items konfigurieren. Damit entfällt die Notwendigkeit, diese Informationen später in nachfolgenden und separaten API-Aufrufen hinzuzufügen.

  • Sie können benutzerdefinierte Daten für period.start und period.end festlegen, die die Standarddaten für den Rechnungsstellungszyklus eines Abonnements überschreiben. So können Sie die Zeiträume für die Revenue Recognition von einmaligen Abbuchungen genau steuern. Wir haben auch Zeitstempelindikatoren (wie max_item_period_start und min_item_period_end für Abonnements, phase_start und phase_end für Zeitpläne) aufgenommen. Auf diese Weise können Sie die Daten an wichtigen Zeitstempeln wie Rechnungsstellungszeiträumen für Abonnements oder Phasenterminen für Abonnementpläne ausrichten.

Auswirkungen

Spezifizieren Sie das Feld metadata oder das Feld period für add_invoice_items über die folgenden API Endpoints:

  • Erstellen oder aktualisieren Sie Abos.
  • Erstellen oder aktualisieren Sie Zeitpläne.
  • Erstellen Sie eine Vorschau-Rechnung, indem Sie die schedule_details angeben.

Änderungen

ParameterÄndernRessourcen oder Endpoints
metadataperiodHinzugefügt
Invoice#create_preview.schedule_details.phases[].add_invoice_items[]Subscription#create.add_invoice_items[]Subscription#update.add_invoice_items[]
 + 3 weitere
SubscriptionSchedule.phases[].add_invoice_items[]SubscriptionSchedule#create.phases[].add_invoice_items[]SubscriptionSchedule#update.phases[].add_invoice_items[]

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-08-27.basil
  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.

Zugehörige Änderungen

  • Fügt dem Konfigurationsobjekt des Kundenportals ein Namensfeld hinzu
  • Unterstützt Drittanbieter-Steuer-Apps für Abos mit flexiblem Abrechnungsmodus
War diese Seite hilfreich?
JaNein
  • Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
  • Schauen Sie sich unser Änderungsprotokoll an.
  • Fragen? Sales-Team kontaktieren.
  • LLM? Lesen Sie llms.txt.
  • Unterstützt von Markdoc