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 Shell
Stripe für Visual Studio Code
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
Datenschutz
Stripe erweitern
Erstellen Sie Stripe-Apps
Verwenden Sie Apps von Stripe
Partner
Partner-Ecosystem
Partner-Zertifizierung
Vereinigte Staaten
Deutsch
StartseiteEntwicklerressourcenChangelogBasil2025-03-31.basil

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

Das ändert sich

Wir führen ein neues übergeordnetes Feld für Rechnungen, Rechnungsposten und Rechnungseinzelposten ein. Im übergeordneten Feld können Sie die Details des vorgelagerten Objekts anzeigen, das die Rechnung, den Rechnungsposten oder den Rechnungseinzelposten generiert hat (z. B. ein Abo, ein Angebot oder andere). Es ersetzt Felder auf oberster Ebene, die wir zuvor als Referenz für diese Objekte verwendet haben.

Warum ist dies eine wichtige Änderung?

  • Für das Objekt Rechnung haben wir die Felder Angebot, Abo, subscription_details und subscription_proration_date eingestellt.
  • Beim Objekt Rechnungsposten haben wir die Felder subscription_item und Abo eingestellt.
  • Beim Objekt Rechnungseinzelposten haben wir die Felder Typ, Abo, subscription_item, invoice_item, anteilmäßige Verrechnung und proration_details eingestellt.

Ergebnis

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

Bei Rechnungs-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

Bei Rechnungsposten-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

Bei Rechnungseinzelposten-Objekten:

  • 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.
  • Schauen Sie sich unser Änderungsprotokoll an.
  • Fragen? Sales-Team kontaktieren.
  • LLM? Lesen Sie llms.txt.
  • Unterstützt von Markdoc