# Onboarding von Konten Verwenden Sie die eingebetteten Connect-Komponente für Konto-Onboarding. Die Komponente für das Onboarding von Konten verwendet die Accounts-API, um Anforderungen auszulesen und ein Onboarding-Formular zu erstellen, das für alle von Stripe unterstützten Länder lokalisiert ist und Daten validiert. Außerdem unterstützt das eingebettete Onboarding alle Unternehmenstypen, unterschiedliche Konfigurationen von Unternehmensvertreterinnen/-vertretern, Dokument-Uploads, Identitätsverifizierung und Verifizierungsstatus. Weitere Informationen finden Sie unter [Eingebettetes Onboarding](https://docs.stripe.com/connect/embedded-onboarding.md). 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. Die Komponente für das Onboarding von Konten verwendet die Accounts-API, um Anforderungen auszulesen und ein Onboarding-Formular zu erstellen, das für alle von Stripe unterstützten Länder lokalisiert ist und Daten validiert. Außerdem unterstützt das eingebettete Onboarding alle Unternehmenstypen, unterschiedliche Konfigurationen von Unternehmensvertreterinnen/-vertretern, Dokument-Uploads, Identitätsverifizierung und Verifizierungsstatus. Weitere Informationen finden Sie unter [Eingebettetes Onboarding](https://docs.stripe.com/connect/embedded-onboarding.md). 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. Die Komponente für das Onboarding von Konten verwendet die Accounts-API, um Anforderungen auszulesen und ein Onboarding-Formular zu erstellen, das für alle von Stripe unterstützten Länder lokalisiert ist und Daten validiert. Außerdem unterstützt das eingebettete Onboarding alle Unternehmenstypen, unterschiedliche Konfigurationen von Unternehmensvertreterinnen/-vertretern, Dokument-Uploads, Identitätsverifizierung und Verifizierungsstatus. Weitere Informationen finden Sie unter [Eingebettetes Onboarding](https://docs.stripe.com/connect/embedded-onboarding.md). 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. Die Komponente für das Onboarding von Konten verwendet die Accounts-API, um Anforderungen auszulesen und ein Onboarding-Formular zu erstellen, das für alle von Stripe unterstützten Länder lokalisiert ist und Daten validiert. Außerdem unterstützt das eingebettete Onboarding alle Unternehmenstypen, unterschiedliche Konfigurationen von Unternehmensvertreterinnen/-vertretern, Dokument-Uploads, Identitätsverifizierung und Verifizierungsstatus. Weitere Informationen finden Sie unter [Eingebettetes Onboarding](https://docs.stripe.com/connect/embedded-onboarding.md). 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. ## Optionen für die Erfassung von Anforderungen Wenn Sie Informationen mit der Komponente Konto-Onboarding erfassen, werden stets `currently_due`-Anforderungen erfasst. Sie können das Attribut `collectionOptions` nutzen, um darüber hinaus jegliche der folgenden Optionen anzufordern: - `eventually_due`-Anforderungen - [zukünftige Anforderungen](https://docs.stripe.com/connect/handle-verification-updates.md) - Detaillierte [Einschränkungen der Anforderung](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md#requirement-restrictions) Weitere Informationen zu den spezifischen Anforderungen für Ihre verbundenen Konten finden Sie unter [Erforderliche Verifizierungsinformationen](https://docs.stripe.com/connect/required-verification-information.md). ### Einschränkungen von Anforderungen Wenn Sie Erfassungsoptionen festlegen, können Sie detaillierte Anforderungsbeschränkungen als `only` oder `exclude` konfigurieren. Beide Optionen akzeptieren ein Array von Zeichenfolgen, die die erforderlichen Eigenschaften darstellen, wie sie in `requirements.entries[].description` für Accounts v2 und den verschiedenen Anforderungs-Arrays für Accounts v1 erscheinen. Weitere Informationen darüber, welche Anforderungen für Ihre verbundenen Konten gelten, finden Sie unter [Erforderliche Verifizierungsinformationen](https://docs.stripe.com/connect/required-verification-information.md). Stellen Sie sich die Optionen als Filter vor, wobei `exclude` passende Kontoanforderungen herausfiltert und `only` als Schnittmenge zwischen den Konto-Anforderungen und den angegebenen Werten fungiert. Sie unterstützen auch den Platzhalterabgleich mit `*` und Beziehungspräfixe. Wenn Sie z. B. über ein verbundenes Konto mit mehreren Inhabern verfügen, können Sie die Adressinformationen für alle Inhaber/innen einziehen, indem Sie Folgendes angeben:`only: ["owners.address.*"]`. Einer Person können mehrere Beziehungen zugeordnet sein, und Beziehungen können mehreren Personen zugewiesen werden. Wenn Sie Beziehungspräfixe nutzen, gelten sie daher für alle Personen auf dem Konto mit der angegebenen Beziehung. Dies ist besonders nützlich in Situationen, in denen Sie die ID einer bestimmten Person nicht kennen, dafür aber ihre Beziehung. Wichtige Überlegungen: - Konten müssen weiterhin alle KYC-Anforderungen erfüllen, um die Funktionen zu aktivieren. Die Option `exclude` entfernt keine Anforderung, sie verhindert nur die Erfassung zu diesem Zeitpunkt. Die Informationen müssen dennoch erfasst werden. - Diese Einschränkungen gelten nur innerhalb eingebetteter Komponenten. Sie wirken sich nicht auf Konten aus, die andere Arten von Dashboards verwenden. - Diese Funktion dient dazu, die Benutzerfreundlichkeit zu verbessern, und nicht, um zu verhindern, dass Konten auf Informationen zugreifen. #### Die Anforderungseinschränkung „Nur“ Diese Option beschränkt die Erfassung auf den angegebenen Satz an Anforderungen, die auch für das Konto ausstehen. Sie wird am häufigsten verwendet, um eine Sanierung zu erstellen, und ist besonders nützlich für Anforderungen, die eine Form des Hochladens von Dokumenten oder der Identitätsüberprüfung erfordern. Diese Option verhindert, dass beim Konto-Onboarding der Schritt der standardmäßigen abschließenden Zusammenfassung angezeigt wird. Wenn alle spezifizierten Anforderungen erfüllt sind, wird die Konto-Onboarding-Komponente sofort beendet. #### Die Anforderungseinschränkung „Ausschließen“ Bei dieser Option werden die angegebenen Felder ausgeblendet, wodurch verhindert wird, dass ein verbundenes Konto diese Informationen bereitstellt oder bearbeitet. Es werden nur Felder aus der Komponente ausgeblendet. Die Informationsanforderungen werden nicht aufgehoben. Diese Option ist nützlich, wenn Sie Informationen vorab ausfüllen möchten, auf die das verbundene Konto während des Onboardings nicht zugreifen soll. Bei Express-Konten gilt: Wenn Sie die Anforderung `business_type` ausschließen (`exclude`) (z. B. um zu verhindern, dass ein Konto seinen Unternehmenstyp ändert), müssen das Land und die Funktionen des Kontos festgelegt werden. ## Erfassung externer Konten Verwenden Sie die Funktion [external_account_collection](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-account_onboarding-features-external_account_collection), um zu steuern, ob die Komponente externe Kontoinformationen erfasst. Dieser Parameter ist standardmäßig aktiviert. Wenn `external_account_collection` aktiviert ist, ist eine [Nutzerauthentifizierung](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#user-authentication-in-connect-embedded-components) erforderlich. Sie können die Stripe-Nutzerauthentifizierung mit dem Parameter [disable_stripe_user_authentication](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-account_onboarding-features-disable_stripe_user_authentication) deaktivieren. ## Stripe-Nutzerauthentifizierung deaktivieren Verwenden Sie die Funktion [disable_stripe_user_authentication](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-account_onboarding-features-disable_stripe_user_authentication), um zu steuern, ob die Komponente eine Stripe-Nutzerauthentifizierung erfordert. - Standardmäßig ist `disable_stripe_user_authentication` das Gegenteil des Werts [external_account_collection](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-account_onboarding-features-external_account_collection). - Wenn Sie `external_account_collection` nicht festlegen, wird standardmäßig „true“ verwendet, sodass `disable_stripe_user_authentication` standardmäßig auf „false“ gesetzt wird. - Wenn `controller.requirement_collection` `stripe` ist, sind beide Werte standardmäßig „false“. Dieser Wert kann nur für Konten gelten, bei denen `controller.requirement_collection` `application` ist. Wir empfehlen die Implementierung von 2FA oder gleichwertigen 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-Konten, ü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. ## Passen Sie die Ihren Nutzer/innen angezeigten Richtlinien an 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/supported-embedded-components/account-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 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}`); // }); ``` #### HTML + JS | Methode | Typ | Beschreibung | Standard | | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | | `setFullTermsOfServiceUrl` | `string` | Absolute URL zu Ihren [vollständigen Allgemeinen Geschäftsbedingungen](https://docs.stripe.com/connect/service-agreement-types.md#full). | [Vollständiger Rahmenvertrag von Stripe](https://stripe.com/connect-account/legal/full) | | `setRecipientTermsOfServiceUrl` | `string` | Absolute URL zu Ihren [Allgemeinen Geschäftsbedingungen für Empfänger/innen](https://docs.stripe.com/connect/service-agreement-types.md#recipient). | [Rahmenvertrag für Empfänger/innen von Stripe](https://stripe.com/connect-account/legal/recipient) | | `setPrivacyPolicyUrl` | `string` | Absolute URL zu Ihrer Datenschutzerklärung. | [Datenschutzerklärung von Stripe](https://stripe.com/privacy) | | `setSkipTermsOfServiceCollection` | `string` | [VERALTET] Nutzung der Anforderungseinschränkung `exclude: ["tos_acceptance.*"]` Stattdessen: Falls „true“, wird beim eingebetteten Onboarding die Erfassung der allgemeinen Geschäftsbedingungen übersprungen, und Sie müssen die [Zustimmung zu den Bedingungen selbst einholen](https://docs.stripe.com/connect/updating-service-agreements.md#indicating-acceptance). | false | | `setCollectionOptions` | `{fields: 'currently_due' | 'eventually_due', future_requirements: 'omit' | 'include', requirements: { exclude: string[] } | { only: string[] }}` | Ermöglicht eine benutzerdefinierte Einstellung der Erfassung der `currently_due`- oder`eventually_due`-Anforderungen, regelt, ob[zukünftige Anforderungen](https://docs.stripe.com/connect/handle-verification-updates.md) einbezogen werden sollen und ermöglicht die Einschränkung der Erfassung von Anforderungen. Bei der Festlegung von`eventually_due` werden sowohl die `eventually_due`- als auch die `currently_due`-Anforderungen erfasst. | `{fields: 'currently_due', futureRequirements: 'omit'}` | | `setOnExit` | `() => void` | Das verbundene Konto hat den Onboarding-Vorgang beendet | | | `setOnStepChange` | `({step}: StepChange) => void` | Das verbundene Konto ist innerhalb des Onboarding-Vorgangs von einem Schritt zum nächsten navigiert. Verwenden Sie `StepChange`, um den aktuellen Schritt zu identifizieren (wie unten beschrieben). | | So richten Sie mit dieser Komponente neue Konten ein: 1. Erstellen Sie ein [verbundenes Konto](https://docs.stripe.com/api/accounts/create.md). Sie können Informationen zum `Account`-Objekt in diesem API-Aufruf vorab ausfüllen. 1. [Initialisieren Sie die in Connect eingebetteten Komponenten](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions) mithilfe der ID des verbundenen Kontos. 1. Beziehen Sie das Element `account-onboarding` ein, um dem verbundenen Konto den Onboarding-Ablauf zu zeigen. 1. Überwachen Sie das von dieser Komponente ausgegebene `exit`-Ereignis. Stripe sendet dieses Ereignis, wenn das verbundene Konto den Onboarding-Vorgang beendet. 1. Wenn `exit` ausgelöst wird, rufen Sie die `Account`-Details ab, um den Status von Folgendem zu prüfen: - [details_submitted](https://docs.stripe.com/api/accounts/object.md#account_object-details_submitted) - [charges_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-charges_enabled) - [payouts_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-payouts_enabled) - Alle anderen angeforderten Funktionen Wenn alle erforderlichen Funktionen aktiviert sind, können Sie das verbundene Konto zum nächsten Schritt Ihres Ablaufs führen. #### React | React-Eigenschaft | Typ | Beschreibung | Standard | Erforderlich oder optional | | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------- | | `onExit` | `() => void` | Die Komponente führt diese Callback-Funktion aus, wenn das verbundene Konto den Onboarding-Vorgang beendet. | | erforderlich | | `fullTermsOfServiceUrl` | `string` | Link zu Ihren [vollständigen Allgemeinen Geschäftsbedingungen](https://docs.stripe.com/connect/service-agreement-types.md#full) (Vertragstext) | [Vollständiger Rahmenvertrag von Stripe](https://stripe.com/connect-account/legal/full) | optional | | `recipientTermsOfServiceUrl` | `string` | Link zu Ihren [Allgemeinen Geschäftsbedingungen für Empfänger](https://docs.stripe.com/connect/service-agreement-types.md#recipient) (Vertragstext) | [Rahmenvertrag für Empfänger/innen von Stripe](https://stripe.com/connect-account/legal/recipient) | optional | | `privacyPolicyUrl` | `string` | Link zu Ihrer Datenschutzerklärung | [Datenschutzerklärung von Stripe](https://stripe.com/privacy) | optional | | `skipTermsOfServiceCollection` | `boolean` | [VERALTET] Nutzung der Anforderungseinschränkung `exclude: ["tos_acceptance.*"]` Stattdessen: Falls „true“, wird beim eingebetteten Onboarding die Erfassung der allgemeinen Geschäftsbedingungen übersprungen, und Sie müssen die [Zustimmung zu den Bedingungen selbst einholen](https://docs.stripe.com/connect/updating-service-agreements.md#indicating-acceptance). | false | optional | | `collectionOptions` | `{fields: 'currently_due' | 'eventually_due', futureRequirements?: 'omit' | 'include', requirements?: { exclude: string[] } | { only: string[] }}` | Ermöglicht eine benutzerdefinierte Einstellung der Erfassung der `currently_due`- oder`eventually_due`-Anforderungen, regelt, ob[zukünftige Anforderungen](https://docs.stripe.com/connect/handle-verification-updates.md) einbezogen werden und ermöglicht die Einschränkung der Erfassung von Anforderungen. Bei der Festlegung von `eventually_due` werden sowohl `eventually_due`- als auch `currently_due`-Anforderungen erfasst. Sie können diesen Parameter nicht aktualisieren, nachdem die Komponente ursprünglich gerendert wurde. | `{fields: 'currently_due', futureRequirements: 'omit'}` | optional | | `onStepChange` | `({step}: StepChange) => void` | Die Komponente führt diesen Rückruf aus, wenn das verbundene Konto innerhalb des Onboarding Prozesses von einem Schritt zum nächsten navigiert ist. Verwenden Sie `StepChange`, um den aktuellen Schritt zu identifizieren, wie unten beschrieben. | | optional | 1. Erstellen Sie ein [verbundenes Konto](https://docs.stripe.com/api/accounts/create.md). Sie können Informationen zum `Account`-Objekt in diesem API-Aufruf vorab ausfüllen. 1. [Initialisieren Sie die in Connect eingebetteten Komponenten](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions) mithilfe der ID des verbundenen Kontos. 1. Beziehen Sie das Element `account-onboarding` ein, um dem verbundenen Konto den Onboarding-Ablauf zu zeigen. 1. Übergeben Sie eine Callback-Funktion `onExit`, die ausgeführt werden soll, wenn das verbundene Konto den Onboarding-Vorgang beendet. 1. Wenn `onExit` ausgelöst wird, rufen Sie die `Account`-Details ab, um den Status von Folgendem zu prüfen: - [details_submitted](https://docs.stripe.com/api/accounts/object.md#account_object-details_submitted) - [charges_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-charges_enabled) - [payouts_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-payouts_enabled) - Alle anderen angeforderten Funktionen Wenn alle erforderlichen Funktionen aktiviert sind, können Sie das verbundene Konto zum nächsten Schritt Ihres Ablaufs führen. ### Das StepChange-Objekt Der Typ `StepChange` ist in `connect.js` definiert. Jedes Mal, wenn das verbundene Konto im Onboarding-Prozess von einem Schritt zum anderen navigiert, empfängt der Schrittänderungs-Handler ein `StepChange`-Objekt mit der folgenden Eigenschaft: | Name | Typ | Beispielwert | | ------ | --------------------------------------------- | --------------- | | `step` | `string` (muss ein gültiger Schrittname sein) | `business_type` | Der eindeutige Verweis auf einen Onboarding-Schritt. | ##### Stufenbeschränkungen - Das `StepChange`-Objekt dient nur für Analysen. - Schritte können in beliebiger Reihenfolge angezeigt und wiederholt werden. - Die Liste der gültigen `step`-Namen kann jederzeit ohne Vorankündigung geändert werden. #### Schrittnamen Jede Seite in einem Onboarding-Ablauf hat einen der folgenden Schrittnamen. | Schrittname | Beschreibung | | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `stripe_user_authentication` | [Nutzerauthentifizierung](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#user-authentication-in-connect-embedded-components) enthält ein Pop-up-Fenster zu einem Stripe-eigenen Fenster. Das verbundene Konto muss sich authentifizieren, bevor es seinen Workflow fortsetzen kann. | | `risk_intervention` | Unterstützt das verbundene Konto bei der Erfüllung risikobezogener Anforderungen. | | `legal_entity_sharing` | Verbundene Konten können optional [Geschäftsinformationen](https://docs.stripe.com/connect/networked-onboarding.md) aus bestehenden Konten mit derselben/demselben Inhaber/in wiederverwenden. | | `business_type` | Legt den Unternehmenstyp des verbundenen Kontos fest. In bestimmten Fällen kann das verbundene Konto auch sein Land festlegen. | | `business_details` | Sammelt Informationen zum Unternehmen des verbundenen Kontos. | | `business_verification` | Erfasst einen Rechtsnachweis, aus dem die ID-Nummer der juristischen Person des Unternehmens hervorgeht, zum Beispiel die Satzung des Unternehmens. Oder ermöglicht es Nutzer/innen, falsch eingegebene Informationen in Bezug auf die juristische Person zu korrigieren. | | `business_bank_account_ownership_verification` | Sammelt Dokumente, die erforderlich sind, um zu überprüfen, ob die Bankkontoinformationen, z. B. der Name der juristischen Person und die Kontonummer, mit den Informationen des Stripe-Kontos des Nutzers/der Nutzerin übereinstimmen. | | `business_documents` | Sammelt andere Dokumente und Verifizierungsanforderungen in Bezug auf das Unternehmen. | | `representative_details` | Sammelt Informationen über den/die Kontovertreter/in. | | `representative_document` | Erfasst einen behördlich ausgestellten Ausweis, der die Existenz des Kontovertreters/der Kontovertreterin bestätigt. | | `representative_additional_document` | Erfasst ein zusätzliches Dokument, um die Angaben des Kontovertreters/der Kontovertreterin zu verifizieren. | | `legal_guardian_details` | Holt die Zustimmung der erziehungsberechtigten Person für Konten ein, die von Minderjährigen eröffnet wurden. | | `owners` | Sammelt Informationen zu den [wirtschaftlichen Eigentümern/Eigentümerinnen](https://support.stripe.com/questions/beneficial-owner-and-director-definitions) eines Unternehmens. | | `directors` | Sammelt Informationen über die [Vorstandsmitglieder](https://support.stripe.com/questions/beneficial-owner-and-director-definitions) eines Unternehmens. | | `executives` | Sammelt Informationen über die [Führungskräfte](https://support.stripe.com/questions/beneficial-owner-and-director-definitions) eines Unternehmens. | | `proof_of_ownership_document` | Sammelt Unterlagen, die die [wirtschaftlichen Eigentümer/innen](https://support.stripe.com/questions/beneficial-owner-and-director-definitions) eines Unternehmens verifizieren. | | `proof_of_authorization` | Sammelt Unterlagen, um zu überprüfen, ob der/die [Kontovertreter/in innerhalb eines Unternehmens eine Position mit ausreichender Autorität](https://support.stripe.com/questions/representative-authority-verification) innehat. | | `confirm_owners` | So können verbundene Konten bestätigen, dass die an Stripe übermittelten Informationen zum/zur wirtschaftlichen Eigentümer/in aktuell und korrekt sind. | | `risa_compliance_survey` | (Gilt nur für Unternehmen in Japan.) Beantwortet Fragen zum [geänderten Ratenverkaufsgesetz](https://stripe.com/guides/installment-sales-act). | | `treasury_and_card_issuing_terms_of_service` | Erfasst die Allgemeinen Geschäftsbedingungen [von Finanzkonten für Plattformen und Kartenausstellung](https://docs.stripe.com/treasury/connect.md), wenn diese Funktionen angefordert werden. | | `external_account` | Erfasst das [externe Konto](https://docs.stripe.com/api/accounts/object.md#account_object-external_accounts) des verbundenen Kontos. | | `support_details` | Sammelt Informationen, anhand derer Kundinnen und Kunden das Unternehmen der verbundenen Konten erkennen können. Diese Support-Informationen können in Zahlungsaufstellungen, Rechnungen und Belegen sichtbar sein. | | `climate` | Ermöglicht es einem verbundenen Konto, sich für [Stripe Climate](https://docs.stripe.com/climate.md) anzumelden. | | `tax` | Ermöglicht es einem verbundenen Konto, sich für [Stripe Tax](https://docs.stripe.com/tax.md) zu entscheiden. | | `summary` | Letzter Schritt der Überprüfung des Onboardings. Das verbundene Konto kann die eingegebenen Informationen aus diesem Schritt aktualisieren. Die URL für die Allgemeinen Geschäftsbedingungen und den Datenschutz wird auf diesem Bildschirm angezeigt. | | `summary_risk` | Im Übersichtsschritt kann ein verbundenes Konto Informationen im Zusammenhang mit den Risikoanforderungen aktualisieren. | | `summary_business_type` | Im Übersichtsschritt kann ein verbundenes Konto Informationen aktualisieren, die sich auf seinen Unternehmenstyp beziehen. | | `summary_business` | Im Übersichtsschritt kann ein verbundenes Konto Informationen aktualisieren, die sich auf sein Unternehmen beziehen. | | `summary_support` | Im Übersichtsschritt kann ein verbundenes Konto öffentlich zugängliche Informationen aktualisieren, die sich auf sein Unternehmen beziehen. | | `summary_persons` | Im Übersichtsschritt kann ein verbundenes Konto Informationen über jede Person in seinem Konto aktualisieren. | | `summary_external_account` | Ausgehend vom Zusammenfassungsschritt kann ein verbundenes Konto Informationen zu seinem [externen Konto](https://docs.stripe.com/api/accounts/object.md#account_object-external_accounts) aktualisieren. | | `summary_tax` | Im Übersichtsschritt kann ein verbundenes Konto Informationen im Zusammenhang mit seiner [Stripe Tax](https://docs.stripe.com/tax.md)-Integration aktualisieren. | | `summary_tax_identification_form` | Im Übersichtsschritt kann ein verbundenes Konto Informationen aktualisieren, die sich auf seine zertifizierten W8/W9-Steuerinformationen beziehen. Dies wird angezeigt, wenn Stripe W8/W9-Informationen erfassen muss. | | `summary_climate` | Im Übersichtsschritt kann ein verbundenes Konto Informationen im Zusammenhang mit seiner [Stripe Climate](https://docs.stripe.com/climate.md)-Integration aktualisieren. | | `terms_of_service` | Bei der Nutzung von Anforderungseinschränkungen, um `nur` die Zustimmung zu den allgemeinen Geschäftsbedingungen zu erfassen, rendern wir einen speziellen Schritt, da der Zusammenfassungsschritt nicht gerendert wird, wenn Anforderungseinschränkungen mit `nur` genutzt werden. | ### Kontositzung erstellen Wenn Sie eine [Kontositzung erstellen](https://docs.stripe.com/api/account_sessions/create.md), aktivieren Sie 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" \ -d "components[account_onboarding][features][disable_stripe_user_authentication]=true" ``` ### Komponente für das Konto-Onboarding rendern Nachdem Sie die Kontositzung erstellt und [StripeConnect eingerichtet haben](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions), können Sie die Konto-Onboarding-Komponente in Ihrer App anzeigen: #### Swift ```swift class MyViewController: UIViewController, AccountOnboardingControllerDelegate { func accountOnboardingButtonTapped() { // Optional. If you use CollectionOptions, make sure to follow our policy instructions. // let collectionOptions = AccountCollectionOptions() // collectionOptions.fields = .eventuallyDue // collectionOptions.futureRequirements = .include let accountOnboardingController = embeddedComponentManager.createAccountOnboardingController( // fullTermsOfServiceUrl: URL(string: "{{URL}}")!, // recipientTermsOfServiceUrl: URL(string: "{{URL}}")!, // privacyPolicyUrl: URL(string: "{{URL}}")!, // collectionOptions: collectionOptions ) accountOnboardingController.delegate = self accountOnboardingController.title = "Onboard with Stripe" // Display the component in your app accountOnboardingController.present(from: self) } // MARK: - AccountOnboardingControllerDelegate func accountOnboardingDidExit(_ accountOnboarding: AccountOnboardingController) { print("User exited the onboarding flow") } } ``` Wenn `accountOnboardingDidExit` ausgelöst wird, rufen Sie die `Account`-Details ab, um den Status von Folgendem zu überprüfen: - [details_submitted](https://docs.stripe.com/api/accounts/object.md#account_object-details_submitted) - [charges_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-charges_enabled) - [payouts_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-payouts_enabled) - Alle anderen angeforderten Funktionen Wenn alle erforderlichen Funktionen aktiviert sind, können Sie mit dem verbundenen Konto zum nächsten Schritt Ihres Antrags übergehen. [Siehe Referenzdokumentation :external:](https://stripe.dev/stripe-ios/stripeconnect/documentation/stripeconnect/accountonboardingcontroller). ### Kontositzung erstellen Wenn Sie eine [Kontositzung erstellen](https://docs.stripe.com/api/account_sessions/create.md), aktivieren Sie 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" \ -d "components[account_onboarding][features][disable_stripe_user_authentication]=true" ``` ### Komponente für das Konto-Onboarding rendern Nachdem Sie die Kontositzung erstellt und [StripeConnect eingerichtet haben](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions), können Sie die Konto-Onboarding-Komponente in Ihrer App anzeigen: #### Kotlin ```kotlin class MyActivity : FragmentActivity() { private lateinit var accountOnboardingController: AccountOnboardingController override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) EmbeddedComponentManager.onActivityCreate(this) // Optional. If you use CollectionOptions, make sure to follow our policy instructions. // val collectionOptions = CollectionOptions( // fields = FieldOption.EVENTUALLY_DUE, // futureRequirements = FutureRequirementOption.INCLUDE, // ) accountOnboardingController = embeddedComponentManager.createAccountOnboardingController( activity = this, title = getString(R.string.account_onboarding), props = AccountOnboardingProps( // fullTermsOfServiceUrl = "{{URL}}", // recipientTermsOfServiceUrl = "{{URL}}", // privacyPolicyUrl = "{{URL}}", // collectionOptions = collectionOptions ) ).apply { onDismissListener = OnDismissListener { println("User exited the onboarding flow") } } } private fun showAccountOnboarding() { accountOnboardingController.show() } } ``` Wenn der Listener für Kündigungen ausgelöst wird, rufen Sie die `Account`-Details ab, um den Status von Folgendem zu überprüfen: - [details_submitted](https://docs.stripe.com/api/accounts/object.md#account_object-details_submitted) - [charges_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-charges_enabled) - [payouts_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-payouts_enabled) - Alle anderen angeforderten Funktionen Wenn alle erforderlichen Funktionen aktiviert sind, können Sie mit dem verbundenen Konto zum nächsten Schritt Ihres Antrags übergehen. [Siehe Referenzdokumentation :external:](https://stripe.dev/stripe-android/connect/com.stripe.android.connect/-account-onboarding-controller/index.html). ### Konto-Sitzung erstellen Wenn Sie eine [Kontositzung erstellen](https://docs.stripe.com/api/account_sessions/create.md), aktivieren Sie 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" \ -d "components[account_onboarding][features][disable_stripe_user_authentication]=true" ``` ### Komponente für das Konto-Onboarding rendern Nachdem Sie die Konto Sitzung erstellt und [StripeConnect eingerichtet](https://docs.stripe.com/connect/get-started-connect-embedded-components.md?platform=react-native#account-sessions) haben, können Sie die Komponente für das Onboarding von Konten in Ihrer Anwendung rendern: #### TypeScript ```javascript import { ConnectAccountOnboarding } from '@stripe/stripe-react-native'; export default function AccountOnboardingScreen() { return ( { console.log('User exited onboarding'); }} /> ); } ``` Wenn `onExit` ausgelöst wird, rufen Sie die `Account`-Details ab, um den Status von Folgendem zu prüfen: - [details_submitted](https://docs.stripe.com/api/accounts/object.md#account_object-details_submitted) - [charges_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-charges_enabled) - [payouts_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-payouts_enabled) - Alle anderen angeforderten Funktionen Wenn alle erforderlichen Funktionen aktiviert sind, können Sie mit dem verbundenen Konto zum nächsten Schritt Ihres Antrags übergehen. [Siehe Referenzdokumentation :external:](https://stripe.dev/stripe-react-native/api-reference/functions/ConnectAccountOnboarding.html). ## Zugriff anfordern (Private Vorschau) Melden Sie sich an , um Zugriff auf die eingebetteten Komponenten von Connect für React Native in der privaten Vorschau zu beantragen. Falls Sie noch kein Stripe-Konto besitzen, können Sie sich [jetzt registrieren](https://dashboard.stripe.com/register).