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
StartseiteEntwicklerressourcenChangelogClover2025-09-30.clover

Aktualisiert initCheckout, sodass es synchron ausgeführt wirdWichtige Änderungen

Das ändert sich

Die Methode stripe.initCheckout ist jetzt synchron statt asynchron.

Warum ist dies eine wichtige Änderung?

Diese grundlegende Änderung betrifft Sie, wenn Ihre Integration Elements mit der Checkout Sessions API verwendet.

Um zu migrieren, müssen Sie:

  1. Entfernen Sie alle mit initCheckout verknüpften Aufrufe von await oder .then().
  2. Ersetzen Sie Ihre fetchClientSecret-Funktion durch eine Client-Geheimnis-Zeichenfolge oder ein Promise, das in eine Client-Geheimnis-Zeichenfolge aufgelöst wird.
  3. Rufen Sie die neue asynchrone Funktion checkout.loadActions() auf, um auf Aktionen wie getSession() zuzugreifen, die session() ersetzt oder confirm(). Sie müssen loadActions() nur einmal aufrufen.
  4. Wenn Sie zuvor initCheckout in einen try...catch-Block eingebunden haben, sollten Sie stattdessen den aufgelösten type-Wert von loadActions() prüfen, um Fehler zu erkennen.
const clientSecret = fetch("/create-checkout-session", { method: "POST", headers: { "Content-Type": "application/json" }, }) .then((r) => r.json()) .then((r) => r.clientSecret); const checkout = await stripe.initCheckout({ fetchClientSecret: () => clientSecret }); const checkout = stripe.initCheckout({ clientSecret }); const paymentElement = checkout.createPaymentElement(); paymentElement.mount("#payment-element"); const session = checkout.session(); const loadActionsResult = await checkout.loadActions(); if (loadActionsResult.type === 'success') { const session = loadActionsResult.actions.getSession(); }

Auswirkungen

Die synchrone Natur von initCheckout ermöglicht es Ihnen, Elements früher zu verbinden, was die Renderlatenz aller Elements verringert, die Sie direkt nach initCheckout verbinden. Dadurch kann Elements auch die Nutzeroberfläche des Skelett-Loaders anzeigen, sobald diese verbunden ist, aber der Sitzungsstatus noch nicht vollständig geladen wurde.

Zugehörige Änderungen

  • Entfernt die Postleitzahl für Kartenzahlungen in bestimmten Regionen in Checkout und Payment Element
  • Entfernt das Feld für Währungsumrechnung aus Checkout-Sitzungen
  • Entfernt Support für die redirectToCheckout-Methode
  • Fügt Support für die Erfassung der Namen von Unternehmen und Einzelpersonen in Checkout-Sessions hinzu
  • Fügt die Möglichkeit hinzu, Zahlungsmethoden von Checkout Sessions und Payment Intents auszuschließen
  • Fügt Support zum Festlegen der Erfassungsmethode für einzelne Zahlungsmethoden mit der Checkout Sessions API hinzu
  • Fügt Support für die Konfiguration von Branding-Einstellungen für Checkout-Sitzungen hinzu.
  • Ermöglicht die Angabe von Maßeinheiten für Produkte
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