# Verwendung von Connect mit verbundenen Express-Konten Mit verbundenen Express-Konten kann Ihre Plattform Auszahlungspläne verwalten, Geldbewegungen anpassen und das Branding steuern. Stripe übernimmt das Onboarding, die Kontoverwaltung und die Identitätsprüfung. > #### Neuere Connect-Integrationen > > Die Informationen auf dieser Seite gelten nur für Plattformen, die bereits ältere Arten verbundener Konten verwenden. Wenn Sie eine neue verbundene Plattform einrichten oder Ihre Integration die Accounts v2 API verwendet, finden Sie weitere Informationen unter [Verhalten verbundener Konten konfigurieren](https://docs.stripe.com/connect/accounts-v2/connected-account-configuration.md). Wenn Ihre Integration die Accounts v1 API verwendet, finden Sie weitere Informationen unter [Eigenschaften des Konto-Controllers](https://docs.stripe.com/connect/migrate-to-controller-properties.md#account-controller-properties). ## Express-Demo Um das gesamte Express-Onboarding in Aktion zu sehen, probieren Sie die [End-to-End-Beispielintegration für Express-Konten](https://rocketrides.io/) aus, bevor Sie eigene Verfahren erstellen. Diese Demo beinhaltet ein Beispiel für das Onboarding von verbundenen Konten und die Kontoverwaltung für Rocket Rides, einen On-Demand-Marktplatz. Auf GitHub finden Sie den [gesamten Quellcode](https://github.com/stripe/stripe-connect-rocketrides) der Demo. ![Rocket Rides, eine Demo von Stripe Connect mit verbundenen Express-Konten](https://b.stripecdn.com/docs-statics-srv/assets/rocket-rides-new.e01ced22698d7f5d3d1c915f26175dcd.png) ## Before you begin Für die Erstellung von verbundenen Express-Konten müssen Sie alle folgenden Voraussetzungen erfüllen: - **Mindest-API-Version**: Verbundene Express-Konten benötigen die API-Version 2017-05-25 oder höher. Für [Funktionen](https://docs.stripe.com/connect/account-capabilities.md) ist die API-Version 2019-02-19 oder höher erforderlich. - **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](https://stripe.com/global). [Kontaktieren Sie uns,](connect@stripe.com), 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](https://support.stripe.com/questions/connect-availability-in-the-uae) und [Thailand](https://support.stripe.com/questions/stripe-thailand-support-for-marketplace) können Plattformnutzer/innen in diesen Ländern verbundene Express-Konten nicht selbst verwalten. [Kontaktieren Sie uns](https://stripe.com/contact/sales), um mit dem Onboarding für verbundene Express-Konten zu beginnen. - **Plattformen in den VAE**: Plattformen in den VAE dürfen nur verbundene Express-Konten in den VAE mit folgenden Zahlungsarten nutzen: [destination_charges](https://docs.stripe.com/connect/destination-charges.md) und [separate Zahlungen und Überweisungen](https://docs.stripe.com/connect/separate-charges-and-transfers.md). Destination Charges mit dem Attribut [on_behalf_of](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-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 verbundene 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](https://docs.stripe.com/connect/risk-management/best-practices.md#fraud). - **Plattform-Profil**: Sie müssen Ihr [Plattform-Profil](https://dashboard.stripe.com/connect/registration) vervollständigen. ## Onboarding von verbundenen Express-Konten außerhalb des Landes Ihrer Plattform Sie können das länderbasierte Onboarding in den [Connect-Einstellungen](https://dashboard.stripe.com/account/applications/settings) 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](https://docs.stripe.com/connect/charges.md). - **Art des Rahmenvertrags:** Gemäß dem [Empfänger-Rahmenvertrag](https://docs.stripe.com/connect/service-agreement-types.md#recipient) kann Ihre Plattform verbundene Konten erstellen, um [grenzüberschreitende Transfers](https://docs.stripe.com/connect/account-capabilities.md#transfers-cross-border) 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](https://dashboard.stripe.com/account/applications/settings), um die visuelle Darstellung des Formulars mit dem Namen, der Farbe und dem Symbol Ihrer Marke anzupassen. ## Verbundenes Express-Konten erstellen und Informationen vorab angeben Verwenden Sie die API zum [Erstellen von Konten](https://docs.stripe.com/api/accounts/create.md), 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. > 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](https://docs.stripe.com/api/accounts/create.md). ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d type=express ``` Wenn Sie das Land und die [Funktionen](https://docs.stripe.com/connect/account-capabilities.md) 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 curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -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 alle Kontoinformationen vorab ausfüllen, einschließlich persönlicher und geschäftlicher Informationen, externer Kontoinformationen usw. Nachdem Sie das `Account` erstellt haben, erstellen Sie eine [Person](https://docs.stripe.com/api/persons/create.md), die die für die Kontoeröffnung verantwortliche Person repräsentiert, wobei Sie `relationship.representative` auf „true“ setzen und alle Kontoinformationen, die Sie vorab ausfüllen möchten (z. B. Vor- und Nachname), eingeben. ```curl curl https://api.stripe.com/v1/accounts/{{ACCOUNT_ID}}/persons \ -u "<>:" \ -d first_name=Jenny \ -d last_name=Rosen \ -d "relationship[representative]"=true ``` Connect Onboarding fragt keine vorab ausgefüllten Informationen ab. Kontoinhaber/innen müssen vorausgefüllte Informationen jedoch bestätigen, bevor sie den [Connect-Rahmenvertrag](https://docs.stripe.com/connect/service-agreement-types.md) akzeptieren können. Wenn Sie ein Konto ohne eigene Website einrichten und Ihre Plattform eine persönliche URL bereitstellt, füllen Sie bitte `defaults.profile.business_url``business_profile.url` vorab aus. Wenn das Konto keine URL hat, können Sie stattdessen `defaults.profile.product_description``business_profile.product_description` vorab ausfüllen. Füllen Sie beim Testen Ihrer Integration die Kontoinformationen vorab mit [Testdaten](https://docs.stripe.com/connect/testing.md) aus. Wenn Sie `capabilities` weglassen, verwendet Connect Onboarding die in den [Konfigurationseinstellungen](https://dashboard.stripe.com/account/applications/settings/express) des Stripe-Dashboards angegebenen Einstellungen, um Funktionen automatisch je nach Land des Kontos anzufordern. ## Konto-Link erstellen [Erstellen Sie einen Konto-Link](https://docs.stripe.com/api/account_links/create.md) 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 curl https://api.stripe.com/v1/account_links \ -u "<>:" \ -d account="{{CONNECTEDACCOUNT_ID}}" \ --data-urlencode refresh_url="https://example.com/reauth" \ --data-urlencode return_url="https://example.com/return" \ -d type=account_onboarding ``` ## Ihr Konto an die Konto-Link-URL weiterleiten Ein [Konto-Link](https://docs.stripe.com/api/account_links/object.md) enthält eine `url` . Leiten Sie das Konto zu diesem Link weiter, um Ihr Konto an den Onboarding-Prozess zu senden. Jede [Konto-Link](https://docs.stripe.com/api/account_links.md)-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](https://support.stripe.com/questions/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. > 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 des verbundenen Kontos 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 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. > Sie können HTTP für Ihre `return_url` und `refresh_url` verwenden, während Sie sich in einer Testumgebung befinden (z. B. für Tests 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 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](https://docs.stripe.com/connect/webhooks.md). - [Rufen](https://docs.stripe.com/api/accounts/retrieve.md) 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](https://docs.stripe.com/api/account_links.md) erneut mit denselben Parametern aufzurufen und die verbundenen Konten an Connect Onboarding zurückzuleiten, damit ein nahtloses Erlebnis entsteht. ## Umgang mit verbundenen Konten, die das Onboarding nicht abgeschlossen haben Ein verbundenes Konto, das an Ihre `return_url` weitergeleitet werden, hat das Onboarding möglicherweise nicht abgeschlossen. [Rufen](https://docs.stripe.com/api/accounts/retrieve.md) 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. ## See also - [Express Dashboard](https://docs.stripe.com/connect/express-dashboard.md) - [Express-Dashboard integrieren](https://docs.stripe.com/connect/integrate-express-dashboard.md) - [Express-Dashboard anpassen](https://docs.stripe.com/connect/customize-express-dashboard.md)