# Eingebettetes Onboarding Stellen Sie Ihren verbundenen Konten ein lokalisiertes Onboarding-Formular zur Verfügung, mit dem die Daten validiert werden können. Die eingebettete Onboarding-Nutzeroberfläche weist nur wenig Stripe-Branding auf und kann an Ihre Marke angepasst werden. Sie betten die [Konto-Onboarding-Komponente](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md) in Ihre Plattformanwendung ein und Ihre verbundenen Konten interagieren mit der eingebetteten Komponente, ohne Ihre Anwendung verlassen zu müssen. Die Komponente unterstützt [vernetztes Onboarding](https://docs.stripe.com/connect/networked-onboarding.md), wodurch Inhaber/innen mehrerer Stripe-Konten Unternehmensinformationen untereinander austauschen können. Beim Onboarding eines Kontos können diese Informationen aus einem bestehenden Konto wiederverwendet werden, anstatt sie erneut einzureichen. Das eingebettete Onboarding verwendet die [Accounts API](https://docs.stripe.com/api/accounts.md), um Anforderungen zu lesen und ein Onboarding-Formular mit zuverlässiger Datenvalidierung zu generieren, das für alle von Stripe unterstützten Länder lokalisiert ist. Darüber hinaus übernimmt das eingebettete Onboarding Folgendes: - Unternehmenstypen - Konfigurationen der Unternehmensvertreter/innen - Verifizierungsdokument wird hochgeladen - Identitätverifizierung und verschiedene Status - Internationale Bankkonten - Fehlerstatus In dieser Demo können Sie die Nutzeroberfläche der eingebetteten Onboarding-Komponente erkunden: Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production. ## Konto erstellen und Datenerfassung konfigurieren [Serverseitig] Erstellen Sie ein [verbundenes Konto](https://docs.stripe.com/api/accounts.md) mit den Standard-[Controller](https://docs.stripe.com/api/accounts/create.md#create_account-controller)-Eigenschaften. Siehe [Entwurf einer Integration](https://docs.stripe.com/connect/interactive-platform-guide.md) Um mehr über die Eigenschaften des Controllers zu erfahren. Alternativ können Sie ein verbundenes Konto erstellen, indem Sie einen [Kontotyp](https://docs.stripe.com/api/accounts/create.md#create_account-type) angeben. Wenn Sie das Land des Kontos angeben oder Funktionen dafür anfordern, kann der/die Kontoinhaber/in das Land nicht ändern. Andernfalls hängt es vom Dashboard-Zugriff des Kontos ab: - **Vollständiges Stripe-Dashboard:** Während der Registrierung kann der/die Kontoinhaber/in ein beliebiges Akquisitionsland auswählen, genau wie bei der Anmeldung für ein normales Stripe-Konto. Stripe fordert je nach ausgewähltem Land automatisch eine Reihe von Funktionen für das Konto an. - **Express-Dashboard:** Beim Onboarding kann der/die Kontoinhaber/in aus einer Liste von Ländern wählen, die Sie in den [Onboarding-Optionen](https://dashboard.stripe.com/settings/connect/onboarding-options/countries) Ihres Plattform-Dashboards konfigurieren. Sie können diese Optionen auch konfigurieren, um die Standardfunktionen anzugeben, die für Konten in jedem Land angefordert werden sollen. - **Kein Stripe-Dashboard**: Wenn Stripe für die Erfassung der Anforderungen verantwortlich ist, kann der Kontoinhaber im Onboarding-Prozess ein beliebiges Akquisitionsland auswählen. Andernfalls müssen in Ihrem nutzerdefinierten Onboarding-Ablauf das Land festgelegt und Funktionen angefordert werden. #### Mit Controllereigenschaften ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d "controller[fees][payer]=application" \ -d "controller[losses][payments]=application" \ -d "controller[stripe_dashboard][type]=express" ``` #### Mit Kontotyp ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d type=standard ``` Die Antwort enthält die ID, die Sie verwenden, um in Ihrer gesamten Integration auf das `Account` zu verweisen. ### Funktionen anfordern Sie können [Funktionen](https://docs.stripe.com/connect/account-capabilities.md#creating) beim Erstellen eines Kontos anfordern, indem Sie die Eigenschaft `requested` der gewünschten Funktionen auf „true“ festlegen. Bei Konten mit Zugriff auf das Express-Dashboard können Sie Ihre [Onboarding-Optionen](https://dashboard.stripe.com/settings/connect/onboarding-options/countries) auch so konfigurieren, dass bestimmte Funktionen beim Erstellen eines Kontos automatisch angefordert werden. Die Onboarding-Nutzeroberflächen von Stripe erfassen automatisch die Anforderungen für angeforderte Funktionen. Fordern Sie nur Funktionen an, die Sie benötigen, um den Onboarding-Aufwand zu reduzieren. ### Informationen vorab angeben Wenn Sie Informationen über den/die Kontoinhaber/in haben (wie Name, Adresse oder andere Details), können Sie das Onboarding vereinfachen, indem Sie diese bei der Erstellung oder Aktualisierung des Kontos angeben. Die Onboarding-Schnittstelle fordert den/die Kontoinhaber/in auf, die vorausgefüllten Informationen zu bestätigen, bevor er/sie den [Connect-Rahmenvertrag](https://docs.stripe.com/connect/service-agreement-types.md) akzeptiert. Der/die Kontoinhaber/in kann alle vorausgefüllten Informationen bearbeiten, bevor er/sie den Rahmenvertrag akzeptiert, selbst wenn Sie die Informationen über die Accounts API bereitgestellt haben. Wenn Sie das Onboarding eines Kontos durchlaufen haben und Ihre Plattform eine URL dafür bereitstellt, füllen Sie die [business_profile.url](https://docs.stripe.com/api/accounts/create.md#create_account-business_profile-url) des Kontos vorab aus. Wenn das Unternehmen keine URL hat, können Sie stattdessen seine [business_profile.product_description](https://docs.stripe.com/api/accounts/create.md#create_account-business_profile-product_description) vorab ausfüllen. Verwenden Sie beim Testen Ihrer Integration [Testdaten](https://docs.stripe.com/connect/testing.md), um verschiedene Ergebnisse zu simulieren, zum Beispiel Identitätsprüfung, Verifizierung der Unternehmensinformationen, Auszahlungsfehler und mehr. ### Benutzerdefinierten Satz an Anforderungen erfassen Sie können die eingebettete Komponente so konfigurieren, dass sie bestimmte Anforderungen erfasst, indem Sie die Optionen `exclude` und `only` verwenden. Auf diese Weise können Sie einen benutzerdefinierten Ablauf zum Erfassen bestimmter Anforderungen erstellen und die eingebettete Komponente für alle anderen Anforderungen verwenden. Zum Beispiel: - Verwenden Sie `exclude`, um zu verhindern, dass verbundene Konten über die Komponente auf die angegebenen Anforderungen zugreifen können. - Verwenden Sie `only`, um verbundene Konten darauf zu beschränken, nur auf die angegebenen Anforderungen über die Komponente zuzugreifen. Einzelheiten zur Verwendung dieser Erfassungsoptionen finden Sie in der Dokumentation zur [Konto-Onboarding-Komponente](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md#requirement-restrictions) oder zur [Konto-Verwaltungskomponente](https://docs.stripe.com/connect/supported-embedded-components/account-management.md#requirement-restrictions). ## Legen Sie fest, ob alle Informationen im Voraus erfasst werden sollen Sie als Plattform müssen entscheiden, ob die erforderlichen Informationen von den verbundenen Konten *vorab* (Upfront onboarding is a type of onboarding where you collect all required verification information from your users at sign-up) oder *inkrementell* (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) erfasst werden sollen. Beim Onboarding im Voraus werden die `eventually_due`-Anforderungen für das Konto erfasst, während beim inkrementellen Onboarding nur die `currently_due`-Anforderungen erfasst werden. | Onboarding-Typ | Vorteile | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Im Voraus** | - Normalerweise ist nur eine Abfrage für alle Informationen erforderlich - Vermeidet die Möglichkeit von Auszahlungs- und Bearbeitungsproblemen aufgrund verpasster Fristen - Stellt frühzeitig ein potenzielles Risiko dar, wenn Konten Informationen verweigern | | **Inkrementell** | - Das Onboarding von Konten kann schnell abgeschlossen werden, da sie nicht so viele Informationen bereitstellen müssen | Um zu bestimmen, ob Sie das Onboarding im Voraus oder inkrementelles Onboarding nutzen möchten, überprüfen Sie die [Anforderungen](https://docs.stripe.com/connect/required-verification-information.md) für die Standorte und Funktionen Ihrer verbundenen Konten. Auch wenn Stripe versucht, etwaige Auswirkungen auf verbundene Konten zu minimieren, können sich Anforderungen im Laufe der Zeit ändern. Bei verbundenen Konten, bei denen Sie für die Anforderungserfassung verantwortlich sind, können Sie das Verhalten [zukünftiger Anforderungen](https://docs.stripe.com/connect/handle-verification-updates.md) mithilfe des Parameters `collection_options` anpassen. Um die zukünftigen Anforderungen des Kontos zu erfassen, setzen Sie [`collection_options.future_requirements`](https://docs.stripe.com/api/account_links/create.md#create_account_link-collection_options-future_requirements) auf `include`. ### Zusätzliche öffentliche Angaben erfassen (Private Vorschau) Stripe erfasst die erforderlichen öffentlichen Angaben für jedes verbundene Konto. Sie können zusätzliche Felder auswählen, deren Wert Sie beim Onboarding entsprechend den Anforderungen Ihres Unternehmens erfassen möchten. Alle Felder, die Sie auswählen, und die Stripe nicht benötigt, werden als optional angezeigt, und verbundene Konten können wählen, ob sie diese bereitstellen möchten. 1. Aktivieren Sie in den Einstellungen für [öffentliche Angaben](https://dashboard.stripe.com/settings/connect/onboarding-options/public-details) im Dashboard die Schaltfläche **öffentliche Angaben erfassen**. 1. Wählen Sie die Felder aus, die verbundenen Konten beim Onboarding angezeigt werden sollen. 1. Klicken Sie auf **Speichern**. #### Verfügbare Felder: Sie können die folgenden öffentlichen Angaben erfassen: | Feld | Beschreibung | | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | [Zahlungsbeschreibung in der Abrechnung](https://docs.stripe.com/connect/statement-descriptors.md) | Der Text, der auf der Kreditkartenabrechnung oder dem Kontoauszug einer Kundin/eines Kunden für Zahlungen an das verbundene Konto erscheint. | | Telefonnummer des Kundensupports | Eine Telefonnummer, unter der Kundinnen und Kunden den Support zu Fragen zum verbundenen Konto erreichen. | | Adresse des Kundensupports | Eine E-Mail-Adresse, unter der Kundinnen und Kunden das verbundene Konto kontaktieren können. | | E-Mail-Adresse des Kundensupports | Eine E-Mail-Adresse, unter der Kundinnen und Kunden das verbundene Konto kontaktieren können. | > #### Anforderungen variieren > > Die Anforderungen von Stripe variieren je nach verbundenem Konto je nach Unternehmenstyp, Land und angeforderten Funktionen. Aktivieren Sie Felder, um sicherzustellen, dass diese beim Onboarding grundsätzlich angezeigt werden, unabhängig davon, ob sie erforderlich sind oder nicht. ## Richtlinien anpassen, die Ihren Nutzern/Nutzerinnen angezeigt werden Der Rahmenvertrag und die [Datenschutzerklärung](https://stripe.com/privacy) von Stripe werden verbundenen Konten im eingebetteten Onboarding angezeigt. Nutzer/innen verbundener Konten, die den [Rahmenvertrag von Stripe nicht akzeptiert haben](https://docs.stripe.com/connect/service-agreement-types.md#accepting-the-correct-agreement), müssen dies im letzten Bildschirm des Onboardings nachholen. Das eingebettete Onboarding verfügt außerdem über eine Fußzeile mit Links zum Rahmenvertrag und zur [Datenschutzerklärung](https://stripe.com/privacy) von Stripe. Für verbundene Konten, bei denen die Plattform für die Erfassung der Anforderungen zuständig ist, haben Sie zusätzliche Optionen zur Anpassung des Onboarding-Ablaufs, die im Folgenden beschrieben werden. ### Kümmern Sie sich selbst um die Zustimmung zum Rahmenvertrag Wenn Sie eine Plattform sind, die das Onboarding von verbundenen Konten durchführt und dabei für die Erfassung der Anforderungen verantwortlich sind, können Sie die [Zustimmung zu den Allgemeinen Geschäftsbedingungen](https://docs.stripe.com/connect/updating-service-agreements.md#tos-acceptance) über Ihre eigene Methode statt über die integrierte Konto-Onboarding-Komponente einholen. In diesem Fall werden Ihre verbundenen Konten im letzten Onboarding-Bildschirm nur aufgefordert, die von ihnen eingegebenen Informationen zu bestätigen, und Sie müssen ihre Zustimmung zum Rahmenvertrag von Stripe einholen. Das eingebettete Onboarding enthält weiterhin Links zu den allgemeinen Geschäftsbedingungen (zum Beispiel in der Fußzeile), die Sie durch [Verknüpfung mit Ihren eigenen Vereinbarungen und Ihrer Datenschutzerklärung](https://docs.stripe.com/connect/embedded-onboarding.md#link-to-your-own-agreements-and-privacy-policy) ersetzen können. ### Link zu Ihren Vereinbarungen und Datenschutzerklärung Verbundene Konten können den Stripe-Rahmenvertrag und die [Datenschutzerklärung](https://stripe.com/privacy) während des eingebetteten Onboardings einsehen. Für Ihre verbundenen Konten, bei denen Sie für die Erfassung der Anforderungen verantwortlich sind, können Sie diese Links durch Ihre eigenen Vereinbarungen und Richtlinien ersetzen. Befolgen Sie diese Anweisungen, um [den Stripe-Rahmenvertrag aufzunehmen](https://docs.stripe.com/connect/updating-service-agreements.md#adding-stripes-service-agreement-to-your-terms-of-service) und stellen Sie einen [Link zur Datenschutzerklärung von Stripe](https://docs.stripe.com/connect/updating-service-agreements.md#disclosing-how-stripe-processes-user-data) zur Verfügung. ## Komponente für Konto-Onboarding integrieren [Serverseitig] [Clientseitig] Erstellen Sie eine [Kontositzung](https://docs.stripe.com/api/account_sessions.md), indem Sie die ID des verbundenen Kontos und `account_onboarding` als zu aktivierende Komponente angeben. ### Kontositzung erstellen Aktivieren Sie beim [Erstellen einer Kontositzung](https://docs.stripe.com/api/account_sessions/create.md) das Konto-Onboarding, indem Sie `account_onboarding` im Parameter `components` angeben. ```curl curl https://api.stripe.com/v1/account_sessions \ -u "<>:" \ -d "account={{CONNECTEDACCOUNT_ID}}" \ -d "components[account_onboarding][enabled]=true" ``` ### Komponente für das Konto-Onboarding rendern Nachdem die Kontositzung erstellt und [ConnectJS initialisiert wurde](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions), können Sie die Komponente für Konto-Onboarding im Frontend darstellen: #### JavaScript ```js // Include this element in your HTML const accountOnboarding = stripeConnectInstance.create('account-onboarding'); accountOnboarding.setOnExit(() => { console.log('User exited the onboarding flow'); }); container.appendChild(accountOnboarding); // Optional: make sure to follow our policy instructions above // accountOnboarding.setFullTermsOfServiceUrl('{{URL}}') // accountOnboarding.setRecipientTermsOfServiceUrl('{{URL}}') // accountOnboarding.setPrivacyPolicyUrl('{{URL}}') // accountOnboarding.setCollectionOptions({ // fields: 'eventually_due', // futureRequirements: 'include', // requirements: { // exclude: ['business_profile.product_description'] // } // }) // accountOnboarding.setOnStepChange((stepChange) => { // console.log(`User entered: ${stepChange.step}`); // }); ``` Siehe [Konto Onboarding](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md) für Onboarding-Funktionen wie: - Handler wie `setOnStepChange` für Analysen hinzufügen. - Onboarding mit unseren iOS und Android SDKs in Ihre Mobile App einbetten. - Konditionen und Datenschutz-URLs anpassen. - Einzugsoptionen angeben. ## Identifizieren und reagieren Sie auf Aktualisierungen der Anforderungen [Serverseitig] Richten Sie Ihre Integration so ein, [dass Änderungen](https://docs.stripe.com/connect/handling-api-verification.md#verification-process) der Kontoanforderungen überwacht werden. Sie können den Umgang mit neuen Anforderungen (und wie diese möglicherweise Zahlungen und Auszahlungen deaktivieren) mit den [Test-Auslöserkarten](https://docs.stripe.com/connect/testing.md#trigger-cards) testen. Senden Sie ein verbundenes Konto über das Onboarding zurück, wenn es `currently_due`- oder `eventually_due`-Anforderungen erfüllt. Sie müssen die spezifischen Anforderungen nicht identifizieren, da die Onboarding-Schnittstelle weiß, welche Informationen sie erfassen muss. Wenn beispielsweise ein Tippfehler die Verifizierung der Identität des Kontoinhabers/der Kontoinhaberin verhindert, fordert das Onboarding ihn/sie auf, ein Identitätsdokument hochzuladen. Stripe benachrichtigt Sie über alle [bevorstehenden Aktualisierungen der Anforderungen](https://support.stripe.com/user/questions/onboarding-requirements-updates), die Ihre verbundenen Konten betreffen. Sie können diese Informationen proaktiv erfassen, indem Sie die [zukünftigen Anforderungen](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements) für Ihre Konten überprüfen. Erhalten Sie für verbundene Konten, bei denen [controller.requirement_collection](https://docs.stripe.com/api/accounts/object.md#account_object-controller-requirement_collection) `stripe` ist, nach dem Erstellen einer [Konto-Link](https://docs.stripe.com/api/account_links.md) oder einer [Kontositzung](https://docs.stripe.com/api/account_sessions.md) keine Updates mehr für Identitätsinformationen. Konten speichern Identitätsinformationen in den Hashes `company` und `individual`. ### Verifizierungsfehler handhaben Überwachen Sie das Ereignis [account.updated](https://docs.stripe.com/api/events/types.md#event_types-account.updated). Wenn das Konto zum Zeitpunkt der `current_deadline` Felder mit der Bezeichnung `currently_due` enthält, wird die entsprechende Funktion deaktiviert und diese Felder werden zu `past_due` hinzugefügt. Lassen Sie Ihre Konten die Verifizierungsanforderungen regeln, indem Sie sie an die [Komponente für Konto-Onboarding](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md) leiten. (See full diagram at https://docs.stripe.com/connect/embedded-onboarding) ### Stripe-Nutzerauthentifizierung deaktivieren Bei Verwendung des eingebetteten Onboarding ist die [Nutzerauthentifizierung durch Stripe](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#user-authentication-in-connect-embedded-components) standardmäßig aktiviert. Dieses Verhalten können Sie mithilfe von [`disable_stripe_user_authentication`](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-account_onboarding-features-disable_stripe_user_authentication) aufheben. Wir empfehlen den Einsatz der Zwei-Faktor-Authentifizierung oder gleichwertiger Sicherheitsmaßnahmen als [Best Practice](https://docs.stripe.com/connect/risk-management/best-practices.md#prevent-account-take-overs). Bei Kontokonfigurationen, die diese Funktion unterstützen, wie z. B. Custom, übernehmen Sie die Haftung für verbundene Konten, wenn diese [Negativsalden](https://docs.stripe.com/connect/risk-management/best-practices.md#decide-your-approach-to-negative-balance-liability) nicht zurückzahlen können. ## See also - [Erste Schritte mit in Connect eingebetteten Komponenten](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) - [Eingebettete Komponenten anpassen](https://docs.stripe.com/connect/customize-connect-embedded-components.md)