# Von Stripe gehostetes Onboarding für Custom-Konten Lassen Sie Stripe Informationen zur Identitätsprüfung für Ihre verbundenen Custom-Konten erfassen. > #### Neuere Connect-Integrationen > > Die Informationen auf dieser Seite gelten nur für Plattformen, die bereits ältere Arten verbundener Konten verwenden. Informationen zum Onboarding von verbundenen Konten mit dem von Stripe gehosteten Onboarding finden Sie unter [Von Stripe gehostetes Onboarding](https://docs.stripe.com/connect/hosted-onboarding.md). [Connect Onboarding bei Custom-Konten](https://stripe.com/connect/onboarding) ist ein von Stripe gehostetes Webformular, mit dem Informationen zur Identitätsprüfung von Nutzerinnen und Nutzern erfasst werden. Es passt die erfassten Informationen dynamisch an, um die Funktionen, das Land und den Unternehmenstyp des verbundenen Kontos widerzuspiegeln. *Connect* (Connect is Stripe's solution for multi-party businesses, such as marketplace or software platforms, to route payments between sellers, customers, and other recipients) Onboarding ist die empfohlene Lösung zur Erfassung von Informationen zur Identitätsprüfung für Custom-Konten und stellt sicher, dass Ihr Ablauf optimiert ist für: - Mobile Browser - Barrierefreiheit - Internationalisierung und Lokalisierung - Konversionsrate - Intelligente Abfrage von Anforderungen auf der Grundlage der bereits im Konto vorhandenen Daten So sieht das Formular für die beispielhafte Integration von Stripe, [Furever](https://furever.dev/), aus: ![Screenshot des Connect Onboarding-Formulars](https://b.stripecdn.com/docs-statics-srv/assets/hosted_onboarding_form.e59ba8300f563e43489953f06127f52c.png) ## So verwenden Sie Connect Onboarding bei Custom-Konten 1. Navigieren Sie zu Ihren [Onboarding-Einstellungen](https://dashboard.stripe.com/settings/connect/onboarding-interface), um die visuelle Darstellung des Formulars anzupassen. Sie müssen den Namen, die Farbe und das Symbol Ihrer Marke angeben. Sie müssen [Bankkontodaten innerhalb des Formulars erfassen](https://dashboard.stripe.com/settings/connect/payouts/external_accounts). Dies kann manuell oder automatisch mit [Stripe Financial Connections](https://docs.stripe.com/financial-connections.md) geschehen. 1. Erstellen Sie ein neues Konto und fordern Sie die Konto-ID an oder verwenden Sie eine vorhandene Konto-ID (in der Form `acct_XXXXXXXX`). 1. Wenn Sie Informationen über den/die Kontoinhaber/in haben (wie Name, Adresse oder andere Details), können Sie diese proaktiv über die [Methoden zur Kontoerstellung oder -aktualisierung](https://docs.stripe.com/api/accounts.md) bereitstellen. Je mehr Informationen über die API zur Verfügung gestellt werden, desto weniger Informationen werden von Connect Onboarding von Ihren Nutzer/innen abgefragt . 1. Rufen Sie die [Konto-Links](https://docs.stripe.com/api/account_links.md) mit den folgenden Parametern auf (weitere Informationen finden Sie in der [API-Referenz](https://docs.stripe.com/api/account_links.md)): - `account` - `refresh_url` - `return_url` - `type` - `collection_options` (optional) 1. Im Onboarding-Verfahren für Ihre eigene Plattform leiten Sie Ihre Nutzer/innen an die von [Konto-Links](https://docs.stripe.com/api/account_links.md) zurückgegebene `url` weiter. 1. Verarbeiten Sie zusätzliche Kontostatus und leiten Sie Ihre Nutzer/innen bei Bedarf zurück zum Connect Onboarding-Ablauf. Um von Nutzer/innen initiierte Aktualisierungen von Informationen, die sie bereits bereitgestellt haben, zu verarbeiten, erstellen Sie eine Möglichkeit für Ihre Nutzer/innen, eine neue Weiterleitung zum Connect Onboarding-Formular vom Dashboard Ihrer Plattform zu erhalten. ## Die zu erfassenden Informationen bestimmen Connect Onboarding bei Custom-Konten unterstützt Onboarding im Voraus oder *inkrementelles Onboarding* (Incremental onboarding is a type of onboarding where you gradually collect required verification information from your users. You collect a minimum amount of information at sign-up, and you collect more information as the connected account earns more revenue). Beim *Onboarding im Voraus* (Upfront onboarding is a type of onboarding where you collect all required verification information from your users at sign-up) werden die `eventually_due`-Anforderungen für das Konto erfasst, während beim inkrementellen Onboarding die `currently_due`-Anforderungen erfasst werden. Informationen zu den Vor- und Nachteilen der beiden Verfahren finden Sie in der [Dokumentation zu den Onboarding-Verfahren](https://docs.stripe.com/connect/identity-verification.md#onboarding-flows). Mit den `currently_due`-Anforderungen werden nur die Nutzerinformationen angefordert, die zu diesem speziellen Zeitpunkt für die Verifizierung benötigt werden. Die `eventually_due`-Anforderungen enthalten einen vollständigeren Satz von Fragen, die letztendlich erfasst werden müssen. Ausgehend von den Anforderungen Ihrer Plattform übergeben Sie entweder `currently_due` oder `eventually_due` als Wert des `collection_options.fields`-Parameters in Ihren Aufrufen der [Konto-Links](https://docs.stripe.com/api/account_links.md). Nachfolgend finden Sie eine Beispielanfrage: ```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 \ -d "collection_options[fields]=eventually_due" ``` ## Weiterleitung Ihrer Nutzer/innen an die Konto-Link-URL Die Antwort auf Ihre Anfrage nach [Konto-Links](https://docs.stripe.com/api/account_links.md) enthält einen Wert für den Schlüssel `url`. Leiten Sie Ihre Nutzer/innen zu diesem Link weiter, um sie in den Ablauf zu senden. Sie können Ihre Konto-Link-URLs 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. Wenn Sie die Option** Externe Kontoinformationen erfassen für Konten aktivieren, bei denen die Plattform für die Erfassung der Anforderungen verantwortlich ist** in Ihren [Onboarding-Einstellungen für Auszahlungen](https://dashboard.stripe.com/settings/connect/payouts/external_accounts) aktivieren oder wenn die `treasury`-Funktion angefordert wird, muss der/die Nutzer/in eine zusätzliche Authentifizierung mit Stripe einrichten, bevor er/sie den Onboarding-Ablauf startet. > 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 abwickeln Connect Onboarding verlangt, dass Sie sowohl eine `return_url` als auch eine `refresh_url` übergeben, um alle Fälle abzuwickeln, in denen die Nutzer/innen an Ihre Plattform zurückgeleitet werden. Es ist wichtig, dass Sie diese korrekt implementieren, um Ihren Nutzer/innen die bestmögliche Erfahrung zu bieten. > Während der Testphase können Sie für Ihre `return_url` und `refresh_url` HTTP verwenden (beispielsweise um mit „localhost“ zu testen), im Live-Modus wird jedoch nur HTTPS akzeptiert. Sie müssen alle Test-URLs vor der Inbetriebnahme durch HTTPS-URLs ersetzen. #### return_url Stripe leitet zurück zu dieser URL, wenn der Nutzer/die Nutzerin den Connect-Onboarding-Flow abgeschlossen oder an einer beliebigen Stelle im Flow auf **Später speichern** geklickt hat. Das bedeutet *nicht*, dass alle Informationen erfasst wurden oder dass es keine offenen Anforderungen für das Konto gibt. Es bedeutet lediglich, dass der Flow korrekt betreten und verlassen wurde. Mit dieser URL wird kein Status übergeben. Nachdem ein/e Nutzer/in zu Ihrer `return_url` weitergeleitet wurde, überprüfen Sie den Status des Attributs `requirements` für sein/ihr Konto. Sie können entweder die `account.updated`-Webhooks überwachen oder das [Account](https://docs.stripe.com/api/accounts.md)-Objekt abrufen und den Status des Attributs `requirements` überprüfen. Weitere Informationen finden Sie in Schritt 4 unten. #### refresh_url Ihre Nutzer/innen werden in den folgenden Fällen an die `refresh_url` weitergeleitet: - Der Link ist abgelaufen (seit der Erstellung des Links sind ein paar Minuten vergangen). - Der Link wurde bereits aufgerufen (die Nutzer/innen haben die Seite aktualisiert oder auf die **Zurück**/**Vorwärts**-Schaltfläche geklickt. - Der Link wurde in einer Drittanbieteranwendung (z. B. einem Messaging-Client) geteilt, die versucht hat, auf die URL zuzugreifen und sie in der Vorschau anzuzeigen. Viele Clients besuchen Links automatisch. Dies kann jedoch dazu führen, dass die Links ablaufen. Ihre `refresh_url` sollte eine Methode auf Ihrem Server auslösen, um [Account Links](https://docs.stripe.com/api/account_links.md) erneut mit denselben Parametern aufzurufen und Nutzer/innen an das Connect Onboarding zurückzuleiten, damit ein nahtloses Erlebnis entsteht. ## Umgang mit einer Situation, in der neue Anforderungen fällig werden Richten Sie Ihre Integration so ein, dass Änderungen der Kontoanforderungen überwacht, falls noch nicht geschehen. Wir empfehlen, [dafür Webhooks zu verwenden](https://docs.stripe.com/connect/handling-api-verification.md#verification-process). Sie können den Umgang mit neuen Anforderungen (und wie diese möglicherweise Zahlungen und *Auszahlungen* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit) deaktivieren) mit unseren [Test-Modus-Auslöserkarten](https://docs.stripe.com/connect/testing.md#trigger-cards) testen. Wenn [anstehende Aktualisierungen der Anforderungen](https://support.stripe.com/user/questions/onboarding-requirements-updates) Ihre verbundenen Konten betreffen, benachrichtigen wir Sie. Wenn Sie eingebettetes oder von Stripe gehostetes Onboarding verwenden, können Sie proaktiv Informationen erfassen, damit [zukünftige Anforderungen](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements) automatisch erfüllt werden. Fügen Sie für das eingebettete Onboarding das Attribut `collectionOptions` in die [eingebettete Onboarding-Komponente](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md) ein. Geben Sie für das von Stripe gehostete Onboarding beim [Erstellen von Konto-Links](https://docs.stripe.com/api/account_links/create.md#create_account_link-collection_options) den Parameter `collection_options` an. Senden Sie die Nutzer/innen ausgehend von den Verifizierungsanforderungen Ihrer Anwendung bei Bedarf zurück an Connect Onboarding, um Anforderungen vom Typ `currently_due` oder `eventually_due` wie in Schritt 1 beschrieben zu erfüllen. Sie können dies als Signal dafür verwenden, wann Sie Ihre Nutzer/innen in das Verfahren zurückschicken. Beachten Sie, dass Sie sich bei Verwendung von Connect Onboarding nicht wirklich darum kümmern müssen, welche Anforderungen erfüllt werden müssen. Wenn Sie die Nutzer/innen zurück an Connect Onboarding schicken, werden die richtigen Informationen erfasst. Wenn Ihr/e Nutzer/in beispielsweise seine/ihre Daten falsch eingibt und nicht verifiziert werden kann, wird er/sie möglicherweise gebeten, ein Identitätsdokument vorzulegen (zum Beispiel einen Führerschein in den USA). Wenn Sie diese/n Nutzer/in an Connect Onboarding senden, wird er/sie aufgefordert, zur Verifizierung ein solches Dokument hochzuladen. > Connect Onboarding bei Custom-Konten erfasst diese `external_account`-Anforderung nicht automatisch. Um `external_account` zu erfassen, aktivieren Sie die Option **Externe Kontoinformationen erfassen für Konten, bei denen die Plattform für die Erfassung der Anforderungen verantwortlich ist **in Ihren [Onboarding-Einstellungen für Auszahlungen](https://dashboard.stripe.com/settings/connect/payouts/external_accounts). Weitere Informationen zur Verwaltung von [Bankkonten und Debitkarten](https://docs.stripe.com/connect/payouts-bank-accounts.md). ## Umgang mit nutzerinitiierten Updates Bei den meisten der bisher diskutierten Connect Onboarding-Anwendungen ging es darum, den Benutzer aufzufordern, neue Informationen anzugeben. Connect Onboarding unterstützt auch von Nutzer/innen initiierte Aktualisierungen der Informationen, die sie bereits im Parameter `type` des [Account Link](https://docs.stripe.com/api/account_links.md) angegeben haben. `type` akzeptiert einen von zwei Werten: `account_onboarding` oder `account_update`. #### account_onboarding Dieser Wert für `type` stellt ein Formular für die Eingabe von ausstehenden Anforderungen zur Verfügung. Verwenden Sie es beim Onboarding neuer Nutzer/innen oder wenn vorhandene Nutzer/innen neue Anforderungen haben, z. B. wenn ein Nutzer/eine Nutzerin bereits ausreichend Informationen angegeben hat, Sie jedoch eine neue Funktion angefordert haben, die weitere Informationen benötigt. Senden Sie den Nutzer/die Nutzerin in diesem Modus an das Formular, um lediglich die benötigten neuen Informationen zu erfassen. #### account_update Dieser Wert für `type` zeigt die Attribute an, die bereits im Kontoobjekt ausgefüllt sind, und ermöglicht es Ihrem Benutzer, zuvor bereitgestellte Informationen zu bearbeiten. Stellen Sie einen Zugriffspunkt auf Ihrer Plattform-Website für einen `type=account_update` bereit, über den Nutzer/innen selbst Aktualisierungen vornehmen können (zum Beispiel, wenn sich ihre Adresse ändert). Sie können den Link als „Mein Profil bearbeiten“ oder „Meine Verifizierungsinformationen aktualisieren“ formulieren. ## Unterstützte Browser Gehostetes Onboarding unterstützt dieselben Browser, die das [Stripe-Dashboard derzeit unterstützt](https://docs.stripe.com/dashboard/basics.md): - Die letzten 20 Hauptversionen von Chrome und Firefox - Die letzten beiden Hauptversionen von Safari und Edge - Die letzten beiden Hauptversionen von Mobile Safari für iOS Gehostes Onboarding wird nicht unterstützt, wenn es in Webansichten eingebettet ist. Es wird nur in eigenständigen Browsern unterstützt. ## See also - [Identitätsprüfung](https://docs.stripe.com/connect/identity-verification.md)