Verwendung von Connect mit verbundenen Express-Konten

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.

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.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d type=express

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.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d country=US \
  -d type=express \
  -d "capabilities[card_payments][requested]"=true \
  -d "capabilities[transfers][requested]"=true \
  -d business_type=individual \
  --data-urlencode "business_profile[url]"="https://example.com"

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.

Erstellen Sie einen Konto-Link mit den folgenden Parametern:

• account – verwenden Sie die von der API aus dem vorherigen Schritt zurückgegebene Konto-ID
• refresh_url
• return_url
• type = account_onboarding

curl https://api.stripe.com/v1/account_links \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d account=
{{CONNECTED_ACCOUNT_ID}} \
  --data-urlencode refresh_url="https://example.com/reauth" \
  --data-urlencode return_url="https://example.com/return" \
  -d type=account_onboarding

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önlichen 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 verbundenes Express-Konto erstellen. Nachdem Sie einen Konto-Link für ein verbundenes Express-Konto erstellt haben, können Sie dessen KYC-Informationen nicht mehr lesen oder aktualisieren.

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 das verbundene Konto an Ihre Plattform weitergeleitet wird. Es ist wichtig, dass Sie diese URLs korrekt implementieren, um Ihrem verbundenen Konto das bestmögliche Erlebnis zu bieten.

return_url

Stripe löst eine Weiterleitung zu dieser URL aus, wenn das verbundene Konto den Connect Onboarding-Ablauf abschließt. Das heißt nicht, dass alle Informationen erfasst wurden oder keine offenen Anforderungen für das Konto bestehen. Es bedeutet lediglich, dass das Verfahren ordnungsgemäß durchlaufen und beendet wurde.

Über diese URL wird kein Status übergeben. Nachdem ein verbundenes Konto 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

Ihr verbundenes Konto wird in diesen Fällen an die refresh_url weitergeleitet:

• Der Link ist abgelaufen (nach der Erstellung des Links sind ein paar Minuten vergangen).
• Sie haben die URL bereits aufgerufen (sie haben die Seite aktualisiert oder auf die Zurück/Vorwärts-Schaltfläche im Browser geklickt).
• Ihre Plattform hat keinen Zugang mehr zu diesem Konto.
• Dieses Konto wurde abgelehnt.

Richten Sie Ihre refresh_url ein, um eine Methode auf Ihrem Server auszulösen, um Konto-Links erneut mit denselben Parametern aufzurufen und die verbundenen Konten an Connect Onboarding zurückzuleiten, damit ein nahtloses Erlebnis entsteht.

Ein verbundenes Konto, das an Ihre return_url weitergeleitet werden, hat das Onboarding möglicherweise nicht abgeschlossen. Rufen Sie sein Konto ab und prüfen Sie den Wert für charges_enabled. Wenn das Onboarding für das Konto nicht komplett abgeschlossen wurde, geben Sie ihm mithilfe entsprechender Eingabeaufforderungen der Nutzeroberfläche die Möglichkeit, das Onboarding zu einem späteren Zeitpunkt fortzusetzen. Verbundene Konten können ihre Konto-Aktivierung über einen neuen (von Ihrer Integration generierten) Link abschließen. Anhand des Status des Parameters details_submitted für ihr Konto können Sie überprüfen, ob das Onboarding abgeschlossen wurde.