Verwendung von Connect mit verbundenen Standard-Konten

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.

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

Falls Sie bereits Informationen für Ihre verbundenen Konten erfasst haben, können Sie diese im Account-Objekt vorab angeben. Sie können alle Kontoinformationen vorab ausfüllen, einschließlich persönlicher und geschäftlicher Informationen, externer Kontoinformationen 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.

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-ID
• refresh_url
• return_url
• type = account_onboarding

curl https://api.stripe.com/v1/account_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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

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.

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 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.

return_url

Stripe löst eine Weiterleitung zu dieser URL aus, wenn die Nutzer/innen das Connect Onboarding abschließen. Das heißt nicht, dass alle Informationen erfasst wurden oder keine offenen Anforderungen für das Konto bestehen. Es bedeutet 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:

• Achten Sie auf account.updated-Webhooks.
• 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_url 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_url 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.

Wenn Nutzer/innen an Ihre return_url weitergeleitet werden, haben sie das Onboarding möglicherweise nicht abgeschlossen. Rufen Sie mithilfe des Endpoints /v1/accounts das Nutzerkonto auf und prüfen Sie den Wert für charges_enabled. Wenn das Onboarding für das Konto nicht komplett abgeschlossen wurde, geben Sie den Nutzerinnen/Nutzern mithilfe entsprechender Eingabeaufforderungen der Nutzeroberfläche die Möglichkeit, das Onboarding zu einem späteren Zeitpunkt fortzusetzen. Diese können ihre Konto-Aktivierung dann über einen neuen (von Ihrer Integration generierten) Link abschließen. Anhand des Status des Parameters details_submitted im Nutzerkonto können Sie überprüfen, ob das Onboarding abgeschlossen wurde.