Verwendung von Connect mit verbundenen Standard-Konten
Nutzen Sie verbundene Standard-Konten, um sofort mit Connect loszulegen und überlassen Sie Stripe den Großteil der Nutzererfahrung der verbundenen Konten.
Ein verbundenes Standard-Konto ist ein konventionelles Stripe-Konto, bei dem Ihr verbundenes Konto eine Beziehung mit Stripe unterhält, sich beim Dashboard anmelden kann und eigenständig Zahlungen abwickeln kann.
Die Musterintegration von Stripe, Kavholm, zeigt, wie Sie Connect Onboarding für ein nahtloses Onboarding-Nutzererlebnis verwenden können.
Loslegen
Wenn Sie neu bei Connect sind, beginnen Sie mit einem Leitfaden zur Verwendung von Standard-Konten, um anderen Unternehmen die direkte Zahlungsannahme zu ermöglichen.
So verwenden Sie Connect Onboarding bei Standard-Konten
Navigieren Sie zur Seite Connect-Einstellungen, um die visuelle Darstellung des Formulars mit dem Namen, der Farbe und dem Symbol Ihrer Marke anzupassen.
Erstellen Sie mithilfe der API
/v1/accounts
ein neues Konto und rufen Sie die Konto-ID ab. Sie können die Informationen zum Account-Objekt für den/die Nutzer/in bereits angeben, bevor Sie den Konto-Link generieren. Übergeben Sie den folgenden Parameter:type
=standard
Notiz
Wenn Sie das neue Konto erstellt haben, überprüfen Sie, ob es im Dashboard angezeigt wird.
Rufen Sie die Account Links API auf, um einen Link für das Onboarding des Kontos zu erstellen.
Im Onboarding-Verfahren für Ihre eigene Plattform leiten Sie Ihre Nutzer/innen an die von Konto-Links zurückgegebene
url
weiter.Verwalten Sie zusätzliche Kontostatus und leiten Sie Ihr Konto bei Bedarf zum Connect Onboarding-Verfahren weiter.
Optional: Sie können weitere Verfahren, zum Beispiel Tax oder Climate, über die Connect-Onboarding-Optionen zum Connect Onboarding-Ablauf hinzufügen.
Standard-Konten erstellen und Informationen vorab angeben
Use the Create Account API to create a connected account with type
set to standard
. You can prefill any information, but at a minimum, you must specify the type
. The country of the account defaults to the same country as your platform, and the account confirms the selection during onboarding. If you know what capabilities the account needs, you can request them when you create it.
Notiz
Dieses Beispiel enthält nur einige der Felder, die Sie beim Erstellen eines Kontos festlegen können. Eine vollständige Liste der Felder, die Sie festlegen können, z. B. address
und website_
, finden Sie in der Dokumentation für die API zum Erstellen von Konten.
Falls Sie bereits Informationen für Ihre verbundenen Konten erfasst haben, können Sie diese im Account-Objekt vorab angeben. Sie können beliebige Kontoinformationen vorab ausfüllen, einschließlich der Unternehmens- oder Personendaten, externer Kontodaten usw.
Connect Onboarding fragt keine vorab ausgefüllten Informationen ab. Kontoinhaber/innen müssen vorausgefüllte Informationen jedoch bestätigen, bevor sie den Connect-Rahmenvertrag akzeptieren können.
Füllen Sie beim Testen Ihrer Integration die Kontoinformationen vorab mit Testdaten aus.
Konto-Link erstellen
Sie können einen Konto-Link erstellen, indem Sie die Account Links API mit den folgenden Parametern aufrufen:
account
– verwenden Sie die von der API aus dem vorherigen Schritt zurückgegebene Konto-IDrefresh_
url return_
url type
=account_
onboarding
Nutzer/innen an die Konto-Link-URL weiterleiten
Die Antwort auf Ihre Anfrage nach Konto-Links-Anforderung enthält einen Wert für den Schlüssel url
. Leiten Sie Ihre Nutzer/innen an diesen Link weiter, um sie in den Ablauf aufzunehmen. Sie können URLs von der Account Links API nur einmal verwenden, da sie Zugang zu den persönlichen Daten des Kontoinhabers/der Kontoinhaberin gewähren. Führen Sie die Authentifizierung der Nutzer/innen in Ihrer Anwendung durch, bevor Sie sie an diese URL weiterleiten. Nachdem Sie eine Kontoverknüpfung für ein Standardkonto erstellt haben, können Sie keine Know Your Customer (KYC)-Informationen mehr lesen oder schreiben. Füllen Sie alle KYC-Informationen vorab aus, bevor Sie den ersten Konto-Link erstellen.
Sicherheitshinweis
Versenden Sie keine Konto-Link-URLs per E-Mail, Textnachricht oder anderweitig außerhalb Ihrer Plattformanwendung. Stellen Sie die URLs Ihren authentifizierten Kontoinhaberinnen und Kontoinhabern stattdessen in Ihrer Anwendung zur Verfügung.
Rückkehr der Nutzer/innen zu Ihrer Plattform steuern
Connect Onboarding verlangt, dass Sie sowohl eine return_
als auch eine refresh_
übergeben, um alle Fälle steuern zu können, in denen Sie die Nutzer/innen an Ihre Plattform zurückleiten. Es ist wichtig, dass Sie diese URLs korrekt implementieren, um Ihren Nutzern/innen die bestmögliche Erfahrung zu bieten.
Notiz
Sie können HTTP für Ihre return_
und refresh_
verwenden, während Sie sich im Testmodus befinden (zum Beispiel für einen Test mit localhost). Im Live-Modus wird jedoch nur HTTPS akzeptiert. Vergewissern Sie sich, dass Sie vor dem Go-Live alle Test-URLs gegen HTTPS-URLs getauscht haben.
return_url
Stripe löst eine Weiterleitung zurück zu dieser URL aus, wenn die Nutzer/innen das Connect Onboarding abschließen. Das bedeutet nicht, dass alle Informationen erfasst wurden oder keine offenen Anforderungen für das Konto bestehen. Es heißt lediglich, dass die Nutzer/innen das Verfahren ordnungsgemäß durchlaufen und beendet haben.
Über diese URL wird kein Status übergeben. Nachdem ein/eine Nutzer/in zu Ihrer return_
weitergeleitet wurde, überprüfen Sie den Status des Parameters details_
für das jeweilige Konto, indem Sie eine der folgenden Aktionen ausführen:
- Achten Sie auf
account.
-Webhooks.updated - Rufen Sie die Accounts-API auf und prüfen Sie das zurückgegebene Objekt.
refresh_url
Ihre Nutzer/innen werden in den folgenden Fällen an die refresh_
weitergeleitet:
- Der Link ist abgelaufen (seit Erstellung des Links sind ein paar Minuten vergangen).
- Der/die Nutzer/in hat den Link bereits aufgerufen (er/sie hat die Seite aktualisiert oder auf die Zurück/Vorwärts-Schaltfläche geklickt)
- Ihre Plattform hat keinen Zugang mehr zu diesem Konto.
- Das Konto wurde abgelehnt.
Ihre refresh_
löst eine Methode auf Ihrem Server aus, um Account Links erneut mit denselben Parametern aufzurufen und Nutzer/innen an das Connect Onboarding zurückzuleiten, damit ein nahtloses Erlebnis entsteht.
Umgang mit Nutzer/innen, die das Onboarding nicht abgeschlossen haben
Wenn Nutzer/innen an Ihre return_
weitergeleitet werden, haben sie das Onboarding möglicherweise nicht abgeschlossen. Rufen Sie mithilfe des Endpoints /v1/accounts
das Konto der Nutzerin/des Nutzers auf und prüfen Sie den Wert für charges_
. Wenn das Onboarding für das Konto nicht komplett abgeschlossen wurde, geben Sie dem/der Nutzer/in mithilfe entsprechender UI-Eingabeaufforderungen die Möglichkeit, das Onboarding zu einem späteren Zeitpunkt fortzusetzen. Nutzer/innen können ihre Konto-Aktivierung über einen neuen (von Ihrer Integration generierten) Link abschließen. Anhand des Status des Parameters details_
im Konto der Nutzerin/des Nutzers können Sie überprüfen, ob das Onboarding abgeschlossen wurde.