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
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
StartseiteEntwicklerressourcenChangelogClover2026-01-28.preview

Aktualisiert Fehlercodes für die ausgehende Setup Intents APIWichtige Änderungen

Das ändert sich

Aktualisiert die von der ausgehenden Setup Intents API zurückgegebenen Fehlercodes, sodass allgemeinere Fehlertypen anstelle von Codes für bestimmte Anmeldedaten verwendet werden. Durch diese Änderung werden mehrere vorhandene Fehlercodes durch standardisierte Fehlertypen ersetzt:

  • Die Fehler blocked_payout_method_bank_account, blocked_payout_method_card und blocked_payout_method_crypto_wallet geben nun den Fehler blocked_payout_method zurück.
  • Die Fehler unsupported_payout_method_bank_account und unsupported_payout_method_card geben nun den Fehler unsupported_payout_method zurück.
  • Die Fehler invalid_payout_method_bank_account, invalid_payout_method_card und invalid_payout_method_crypto_wallet geben nun den Fehler invalid_payout_method zurück.
  • Die Fehler limit_payout_method_bank_account, limit_payout_method_card und limit_payout_method_crypto_wallet geben nun den Fehler limit_payout_method zurück.

Diese Standardisierung verbessert die Konsistenz der Fehlerbehandlung bei verschiedenen Auszahlungsmethoden und unterstützt die zukünftige Erweiterbarkeit, wenn neue Anmeldedaten zu den Auszahlungsmethoden hinzugefügt werden.

Warum ist dies eine wichtige Änderung?

Dies ist eine grundlegende Änderung, da Ihre Integration möglicherweise auf den spezifischen Fehlercode-Identifikatoren basiert, die durch dieses Update ersetzt werden. Wenn Ihr Code auf typspezifische Fehlercodes wie blocked_payout_method_bank_account, unsupported_payout_method_bank_account, invalid_payout_method_bank_account oder limit_payout_method_bank_account prüft, funktionieren diese Prüfungen nicht mehr und müssen aktualisiert werden, um die generischen Fehlertypen zu verarbeiten.

Auswirkungen

Falls Ihre Integration bestimmte Fehlercodes von ausgehenden Setup-Intents-Endpoints verarbeitet, müssen Sie Ihre Fehlerbehandlungslogik aktualisieren, um die generischen Fehlertypen zu verwenden. Die Fehlermeldungen und zugrunde liegenden Ursachen bleiben unverändert, jedoch wurden die Fehlercode-Kennungen angepasst, um eine größere Konsistenz zwischen den verschiedenen Auszahlungsmethoden zu gewährleisten.

Änderungen

CodesÄndern
blocked_payout_methodunsupported_payout_methodHinzugefügt
blocked_by_stripe
invalid_payout_method_dataHinzugefügt
invalid_payout_method
limit_payout_methodHinzugefügt
quota_exceeded

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: 2026-01-28.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.

Zugehörige Änderungen

  • Fügt Ressourcen für Bankkonten und Auszahlungsmethoden ein alternatives Referenzfeld hinzu
  • Fügt Kartenauszahlungsmethoden die Fingerabdruck-Eigenschaft hinzu
  • Global Payouts fügt Support für 15 neue Länder für grenzüberschreitende Auszahlungen 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