Fügt den v1-APIs die Kundenkontoeigenschaft hinzu, um die Interoperabilität mit Accounts v2 zu gewährleisten
Das ändert sich
Fügt die Eigenschaft customer_account hinzu, die es neuen Connect-Plattformen und Marktplätzen, die Accounts v2 verwenden, ermöglicht, auf Zahlungen zu verweisen, die sie von verbundenen Konten oder Kunden/Kundinnen einziehen. Diese Eigenschaft ist in mehreren API v1-Endpoints verfügbar, beispielsweise in Payment Intents und Rechnungen.
Beispielsweise können Sie die Setup Intents API verwenden, um die Zahlungsdaten eines Kontos für zukünftige Zahlungen zu speichern. In diesem Beispiel muss das Konto als Kunde/Kundin konfiguriert sein.
curl https://api.stripe.com/v1/setup_intents \ -u "${API_KEY}" \ -H "Stripe-Version: 2025-12-15.clover" \ -d "payment_method_types[]=stripe_balance" \ -d "payment_method_data[type]=stripe_balance" \ -d confirm=true \ -d customer_account=acct_1234 \ -d usage=off_session
Auswirkungen
Plattformen und Marktplätze auf Connect berechnen den mit ihnen verbundenen Konten häufig Gebühren für die von ihnen angebotenen Dienste. Bisher haben Sie die Accounts v1 API und die Customers v1 API verwendet, um zwei Objekte zu erstellen, die einen einzelnen Nutzer/eine einzelne Nutzerin repräsentieren. Diese getrennte Darstellung bedeutete, dass KYC-Daten zweimal erfasst, die Daten zwischen den beiden Objekten synchronisiert und mehrere IDs für denselben Nutzer/dieselbe Nutzerin gespeichert werden mussten.
Sie können jetzt die Accounts v2 API verwenden, um eine einheitliche Identität zu erstellen, die Ihre Nutzer/innen bei Stripe repräsentiert. Dies verbessert die Konversionsrate beim Onboarding, da die KYC-Daten zwischen Identitäten der Kunden/Kundinnen und verbundenen Konten geteilt werden. So müssen Connect-Nutzer/innen keine doppelten Profile und benutzerdefinierte Beziehungslogik erstellen.
Übergeben Sie die Konto-ID Ihrer Nutzerin/Ihres Nutzers in der Eigenschaft customer_ für APIs, die Zahlungen erfassen oder verfolgen.
Eine Änderung ist nicht erforderlich, wenn Ihre Integration Customers v1 verwendet und die Eigenschaft Kunde. Wenn Sie daran interessiert sind, die Accounts v2 API für neue oder bestehende verbundene Konten zu verwenden, registrieren Sie sich im Dashboard.