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
Datenschutz
Extend Stripe
Erstellen Sie Stripe-Apps
Verwenden Sie Apps von Stripe
Partner
Partner-Ecosystem
Partner-Zertifizierung
StartseiteEntwicklerressourcenChangelogBasil2025-03-31.basil

In den Rechnungsressourcen wird jetzt angegeben, wie sie generiert wurdenWichtige Änderungen

Das ändert sich

Wir führen ein neues parent-Feld für Rechnungen, Rechnungsposten und Rechnungseinzelposten ein. Im Feld parent können Sie die Details des Upstream-Objekts anzeigen, das das Feld invoice, invoice item oder invoice line item generiert hat (z. B. ein Abonnement, ein Angebot oder andere). Es ersetzt die Felder der obersten Ebene, die wir zuvor verwendet haben, um auf diese Objekte zu verweisen.

Warum ist dies eine wichtige Änderung?

  • Für das Objekt Rechnung haben wir die Felder quote, subscription, subscription_details und subscription_proration_date eingestellt.
  • Für das Objekt Rechnungsposten haben wir die Feldersubscription_item und subscription eingestellt.
  • Für das Objekt Rechnungseinzelposten haben wir die Felder type, subscription, subscription_item, invoice_item, proration und proration_details eingestellt.

Ergebnis

Ersetzen Sie Feldverweise in Rechnungsobjekten durch ihre neuen Positionen im Feld parent.

Bei Invoice-Objekten:

  • Verwenden Sie invoice.parent.subscription_details.subscription (stellen Sie sicher, dass invoice.parent.type gleich subscription_details ist) anstelle von invoice.subscription.
  • Dies gilt auch für:
    • quote
    • subscription_details
    • subscription_proration_date

Auf Invoice Item-Objekten:

  • Verwenden Sie invoiceitem.parent.subscription_details.subscription (stellen Sie sicher, dass invoiceitem.parent.type gleich subscription_details ist) anstelle von invoice_item.subscription
  • Dies gilt auch für das Feld subscription_item

Für Invoice Line Item-Objekte:

  • Verwenden Sie line_item.parent.subscription_item_details.subscription_item (stellen Sie sicher, dass line_item.parent.type gleich subscription_item_details ist) anstelle von line_item.subscription_item.
  • Dies gilt auch für:
    • subscription
    • invoice_item
    • proration
    • proration_details

Änderungen

ParameterÄndernRessourcen oder Endpoints
subscription_itemsubscriptionEntfernt
InvoiceItem
quotesubscription_detailssubscriptionsubscription_proration_dateEntfernt
Invoice
invoice_itemproration_detailsprorationsubscriptionsubscription_itemtypeEntfernt
InvoiceLineItem
parentHinzugefügt
InvoiceItemInvoiceInvoiceLineItem

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-03-31.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 Abrechnungszeiträume auf der Ebene der Abonnementartikel hinzu und entfernt Zeiträume auf Abonnementebene
  • Fügt Unterstützung für die letzte Aggregationsformel für Zähler hinzu
  • Fügt neue Webhook-Ereignistypen für Abrechnungszähler hinzu
  • Fügt neue Webhook-Ereignistypen für Abrechnungsgutschriften hinzu
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