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-03-31.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.

Ersetzt die Preisfelder der obersten Ebene durch eine verbesserte Preismodellierung für Rechnungsposten und RechnungseinzelpostenWichtige Änderungen

Das ändert sich

Wir führen ein neues polymorphes Preiskonzept für Rechnungsposten und Rechnungseinzelposten ein. Es enthält alle preisbezogenen Daten und vereinheitlicht die Struktur der Preisobjekte (Preis und Plan), um neue Preisobjekttypen hinzuzufügen. Außerdem verschieben wir Daten zum Stückbetrag in die Preisgestaltung.

Warum ist dies eine wichtige Änderung?

  • Die Felder price und plan sind für Rechnungsposten und Rechnnungseinzelposten nicht mehr verfügbar.
  • Verschieben Sie unit_amount und unit_amount_decimal in das neue Konzept pricing für Rechnungsposten und Rechnnungseinzelposten.

Ergebnis

Ersetzen Sie alle Verweise auf price oder plan in Rechnungsposten und Rechnnungseinzelposten durch das Feld pricing:

  • Verwenden Sie anstelle von invoice_item.price.id den Parameter invoice_item.pricing.price_details.price, nachdem Sie überprüft haben, dass invoice_item.pricing.type gleich price_details ist.
  • Verwenden Sie beim Erstellen oder Aktualisieren von Rechnungsposten den Parameter pricing anstelle von price (z. B. legen Sie pricing.price fest, anstatt den Parameter price zu übergeben)
  • Verwenden Sie für Einheitsbeträge pricing.unit_amount_decimal anstelle von unit_amount oder unit_amount_decimal
  • Verwenden Sie beim Erstellen oder Aktualisieren von Rechnungsposten den Parameter unit_amount_decimal statt unit_amount

Änderungen

ParameterÄndernRessourcen oder Endpoints
planpriceunit_amount_decimalunit_amountEntfernt
InvoiceItem
planpriceEntfernt
InvoiceLineItem
pricingHinzugefügt
Invoice#add_lines.lines[]Invoice#update_lines.lines[]InvoiceItem#create
 + 4 weitere
InvoiceItem#updateInvoiceLineItem#updateInvoiceItemInvoiceLineItem
priceEntfernt
Invoice#add_lines.lines[]Invoice#update_lines.lines[]InvoiceItem#create
 + 4 weitere
InvoiceItem#updateInvoiceItemInvoiceLineItem#updateInvoiceLineItem
unit_amountEntfernt
InvoiceItem#createInvoiceItem#updateInvoiceItem

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

  • Ersetzt steuerbezogene Eigenschaften der obersten Ebene durch eine verbesserte Steuermodellierung für Rechnungen, Rechnungsposten und Stornorechnungsposten
  • Fügt Unterstützung für mehrere (Teil-)Zahlungen auf Rechnungen hinzu
  • Fügt Zuständigkeitsebene und Grund für die Besteuerung zu manuellen Steuerbeträgen auf Rechnungen 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