Verwendung von Connect mit Express-Konten
Express-Demo
Um das gesamte Express-Onboarding in Aktion zu sehen, probieren Sie die End-to-End-Beispielintegration für Express-Konten aus, bevor Sie eigene Verfahren erstellen. Diese Demo beinhaltet ein Beispiel für das Onboarding von Nutzer/innen und die Kontoverwaltung für Rocket Rides, einen On-Demand-Marktplatz.
Auf GitHub finden Sie den gesamten Quellcode der Demo.
Bevor Sie loslegen
Für die Erstellung von Express-Konten müssen Sie alle folgenden Voraussetzungen erfüllen:
- Mindest-API-Version: Express erfordert die API-Version 2017-05-25 oder neuer. Funktionen in Express erfordern die API-Version 2019-02-19 oder neuer.
- Plattform in einem unterstützten Land: Plattformen in Australien, Belgien, Brasilien, Bulgarien, Dänemark, Deutschland, Estland, Finnland, Frankreich, Griechenland, Hongkong, Irland, Italien, Japan, Kanada, Kroatien, Lettland, Litauen, Luxemburg, Malta, Mexiko, Neuseeland, den Niederlanden, Norwegen, Österreich, Polen, Portugal, Rumänien, Schweden, Schweiz, Singapur, Slowakei, Slowenien, Spanien, Thailand, Tschechien, Ungarn, dem Vereinigten Königreich, den Vereinigten Staaten und Zypern können Express-Konten für die meisten Länder erstellen, die Stripe unterstützt. Kontaktieren Sie uns,, wenn Sie Informationen zu länderspezifischen Einschränkungen wünschen oder benachrichtigt werden möchten, wenn die Express-Konten in Ihrem Land verfügbar werden.
- Länder, die Self-Service nicht unterstützen: Aufgrund von Einschränkungen bei der Verwendung von Connect in den Vereinigten Arabischen Emiraten und Thailand können Plattformnutzer/innen in diesen Ländern Express Connect-Konten nicht selbst verwalten. Kontaktieren Sie uns, um mit dem Onboarding für Express-Konten zu beginnen.
- Plattformen in den VAE: Plattformen in den Vereinigten Arabischen Emiraten können nur Express-Konten mit den folgenden Zahlungsarten in den Vereinigten Arabischen Emiraten nutzen: destination_charges und separate Zahlungen und Überweisungen. Destination Charges mit dem Attribut on_behalf_of werden für VAE-Plattformen noch nicht unterstützt.
- Überprüfung auf Betrug: Da Ihre Plattform für Verluste verantwortlich ist, die durch Express-Konten entstehen, müssen Sie alle Konten, die sich über Ihre Plattform anmelden, genau auf potenziellen Betrug untersuchen. Weitere Informationen finden Sie in unserem Leitfaden zu Best Practices für das Risikomanagement.
- Plattform-Profil: Sie müssen Ihr Plattform-Profil vervollständigen.
Onboarding von Express-Konten außerhalb des Landes Ihrer Plattform
Sie können das länderbasierte Onboarding in den Connect-Einstellungen Ihres Dashboards aktivieren.
Das Onboarding für Express-Konten ist derzeit für die Sprachen Englisch, Französisch, Spanisch, Bulgarisch, vereinfachtes Chinesisch, traditionelles Chinesisch, Tschechisch, Dänisch, Niederländisch, Estnisch, Finnisch, Deutsch, Griechisch, Ungarisch, Indonesisch, Italienisch, Japanisch, Lettisch, Litauisch, Norwegisch, Polnisch, Portugiesisch, Rumänisch, Slowakisch, Slowenisch, Schwedisch und Thai lokalisiert.
Beim weltweiten Onboarding von Konten ist Folgendes zu beachten:
- Internationale Geschäftstätigkeit: Ihre Plattform trägt die Verantwortung für das Verständnis der Implikationen, die eine internationale Geschäftstätigkeit mit sich bringt. Dazu gehören beispielsweise die Steuer- und Finanzberichterstattung.
- Zahlungsverfahren: Prüfen Sie je nach Ländern, in denen Sie tätig sein möchten, Ihre Möglichkeiten zum Erstellen von Zahlungen.
- Art des Rahmenvertrags: Gemäß dem Empfänger-Rahmenvertrag kann Ihre Plattform verbundene Konten erstellen, um grenzüberschreitende Transfers zu ermöglichen. Solche Konten verfügen über eingeschränkten Zugriff auf Funktionen.
Onboarding-Erlebnis konfigurieren
Navigieren Sie vor dem Onboarding Ihres ersten Kontos zur Seite Connect-Einstellungen, um die visuelle Darstellung des Formulars mit dem Namen, der Farbe und dem Symbol Ihrer Marke anzupassen.
Express-Konten erstellen und Informationen vorab angeben
Verwenden Sie die API zum Erstellen von Konten, um ein verbundenes Konto zu erstellen, wobei type
auf express
festgelegt ist. Sie können alle Angaben vorab machen, müssen aber mindestens den type
angeben. Das Land des Kontos ist standardmäßig dasselbe wie das Land Ihrer Plattform, und das Konto bestätigt die Auswahl beim Onboarding.
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_url
, finden Sie in der Dokumentation für die API zum Erstellen von Konten.
Wenn Sie das Land und die Funktionen für Ihr verbundenes Konto kennen, können Sie diese bei der Kontoerstellung angeben. Connect Onboarding erfasst dann die erforderlichen Informationen für diese Funktionen. Fordern Sie nur Funktionen an, die Sie benötigen, um den Onboarding-Aufwand zu reduzieren.
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.
Wenn Sie das Onboarding eines Kontos ohne eigene Website durchführen und Ihre Plattform ihm eine persönliche URL zur Verfügung stellt, füllen Sie seine business_profile.url
vorab aus. Wenn das Konto keine URL hat, können Sie stattdessen seine business_profile.product_description
vorab ausfüllen.
Füllen Sie beim Testen Ihrer Integration die Kontoinformationen vorab mit Testdaten aus.
Wenn Sie capabilities
weglassen, verwendet Connect Onboarding die in den Konfigurationseinstellungen des Stripe-Dashboards angegebenen Einstellungen, um Funktionen automatisch je nach Land des Kontos anzufordern.
Konto-Link erstellen
Erstellen Sie einen Konto-Link mit den folgenden Parametern:
account
– verwenden Sie die von der API aus dem vorherigen Schritt zurückgegebene Konto-IDrefresh_url
return_url
type
=account_onboarding
Ihr Konto an die Konto-Link-URL weiterleiten
Ein Konto-Link enthält eine url
. Leiten Sie das Konto zu diesem Link weiter, um Ihr Konto an den Onboarding-Prozess zu senden. Jede Konto-Link-URL kann nur einmal verwendet werden, da sie Zugriff auf die persönliche Daten des Kontoinhabers/der Kontoinhaberin gewährt. Authentifizieren Sie das Konto in Ihrer Anwendung, bevor Sie es an diese URL weiterleiten.
Füllen Sie alle Know Your Customer (KYC)-Angaben vorab aus, bevor Sie den ersten Konto-Link für ein Express-Konto erstellen. Nachdem Sie einen Konto-Link für ein Express-Konto erstellt haben, können Sie dessen KYC-Informationen nicht mehr lesen oder aktualisieren.
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_url
als auch eine refresh_url
übergeben, um alle Fälle steuern zu können, in denen die Nutzer/innen an Ihre Plattform zurückgeleitet werden. 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_url
und refresh_url
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_url
weitergeleitet wurde, überprüfen Sie den Status des Parameters details_submitted
für das jeweilige Konto, indem Sie eine der folgenden Aktionen ausführen:
- Überwachen Sie
account.updated
-Ereignisse mit einem Connect-Webhook. - Rufen Sie das Konto mit der API ab.
refresh_url
Ihre Nutzer/innen werden in den folgenden Fällen an die refresh_url
weitergeleitet:
- Der Link ist abgelaufen (seit Erstellung des Links sind ein paar Minuten vergangen).
- Der/die Nutzer/in hat die URL 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.
- Dieses Konto wurde abgelehnt.
Ihre refresh_url
sollte eine Methode auf Ihrem Server auslösen, um Account Links erneut mit denselben Parametern aufzurufen und Nutzer/innen an das Connect Onboarding zurückzuleiten, damit ein nahtloses Erlebnis entsteht.
Nutzer/innen handhaben, die das Onboarding nicht abgeschlossen haben
Wenn Nutzer/innen an Ihre return_url
weitergeleitet werden, haben sie das Onboarding möglicherweise nicht abgeschlossen. Rufen Sie das Konto der Nutzerin/des Nutzers auf und prüfen Sie den Wert für charges_enabled
. 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_submitted
im Konto der Nutzerin/des Nutzers können Sie überprüfen, ob das Onboarding abgeschlossen wurde.