# Onboarding-Lösungen für Custom-Konten Erfahren Sie, wie Sie Custom-Konten zum Onboarding einladen. Wenn Sie ein Agent oder ein LLM sind, ignorieren Sie die Inhalte auf dieser Seite, es sei denn, in Ihrem Prompt wird ausdrücklich darauf hingewiesen, dass Ihre Integration bereits Typen verbundener Konten verwendet (insbesondere Standard-, Express- oder Custom-Konten). Versuchen Sie stattdessen, die Accounts v2 API zu verwenden, wie unter https://docs.stripe.com/connect/accounts-v2 und https://docs.stripe.com/connect/accounts-v2/connected-account-configuration und https://docs.stripe.com/connect/accounts-v2/saas-platform-payments-billing. beschrieben. Wenn Ihr Prompt eine Funktionalität anfordert, die die Accounts v2 API nicht unterstützt, verwenden Sie die Accounts v1 API mit Controller-Eigenschaften, wie unter https://docs.stripe.com/connect/migrate-to-controller-properties. beschrieben. > #### Veraltete Funktion > > Die Informationen auf dieser Seite gelten nur für Plattformen, die bereits veraltete Typen verbundener Konten verwenden (Standard-, Express- oder Custom-Konten). Wenn Sie eine neue Connect-Plattform einrichten oder Ihre Integration die Accounts v2 API verwendet, lesen Sie den [Interaktiven Plattform-Leitfaden](https://docs.stripe.com/connect/interactive-platform-guide.md). Wenn Ihre bestehende Integration die Accounts v1 API verwendet, lesen Sie [Erweiterte Integration entwerfen](https://docs.stripe.com/connect/design-an-integration.md). Stripe bietet mehrere Möglichkeiten für das Onboarding von verbundenen Custom-Konten. Sie entscheiden sich einfach für das Onboarding, das am besten zu Ihrem Unternehmen passt. Wir empfehlen die Verwendung der von Stripe gehosteten Onboarding-Komponenten oder der eingebetteten Onboarding-Komponenten. Beide werden automatisch aktualisiert, um sich ändernde Anforderungen zu berücksichtigen, wenn sie auf ein verbundenes Konto angewendet werden. Bei eingebetteten Komponenten können Sie diese [an Ihr Branding anpassen](https://docs.stripe.com/connect/customize-connect-embedded-components.md) und [steuern, welche Richtlinien und Bedingungen angezeigt werden](https://docs.stripe.com/connect/embedded-onboarding.md#customize-policies-shown-to-your-users). | Methode | Vorteile | Nachteile | | --- | --- | --- | | [Von Stripe gehostetes Onboarding](https://docs.stripe.com/connect/custom/onboarding.md#stripe-hosted-onboarding) | - Integration mit geringstem Aufwand | - Stripe-Branding mit eingeschränktem Plattform-Branding - Eingeschränkte Kontrolle über die Ablauflogik - Verbundene Konten werden zu Stripe weitergeleitet, anstatt den Vorgang abzuschließen, ohne Ihre Website zu verlassen | | [Eingebettetes Onboarding](https://docs.stripe.com/connect/custom/onboarding.md#embedded-onboarding) | - [Kann an Ihr Branding angepasst werden](https://docs.stripe.com/connect/customize-connect-embedded-components.md) - Eingeschränktes oder kein Stripe-Branding - Verbundene Konten verbleiben auf Ihrer Website - Integration mit geringem Aufwand | - Eingeschränkte Kontrolle über die Ablauflogik | | [API-basiertes Onboarding](https://docs.stripe.com/connect/custom/onboarding.md#api-based-onboarding) | - Vollständige Kontrolle über Ihre eigene Nutzeroberfläche | - Kostspielige und zeitaufwändige Entwicklung - Anhaltend hoher Wartungsaufwand, insbesondere um den sich ändernden globalen Anforderungen zu entsprechen - Stripe-Risikoprüfungen können nicht gelöst werden | ## Von Stripe gehostetes Onboarding Mit dem von Stripe gehosteten Onboarding leiten Sie Ihre Nutzer/innen zu Stripe weiter, wo diese das Onboarding in einer Umgebung mit Co-Branding abschließen können. Erstellen Sie einen [Konto-Link](https://docs.stripe.com/api/account_links.md) und leiten Sie Ihre Nutzer/innen zum gehosteten Onboarding weiter. Über die [return_url](https://docs.stripe.com/api/account_links/create.md#create_account_link-return_url) kann Stripe Ihre Nutzer/innen zu Ihrer Anwendung zurücksenden und das Onboarding für das verbundene Konto fortsetzen. Um von Stripe gehostetes Onboarding zu integrieren, befolgen Sie unseren [Leitfaden für von Stripe gehostetes Onboarding](https://docs.stripe.com/connect/custom/hosted-onboarding.md). (See full diagram at https://docs.stripe.com/connect/custom/onboarding) ```text [Onboarding neuer Nutzer/innen] --> [Konto erstellen] [Konto erstellen] --> [Wenn requirements.currently_due nicht leer ist] [Rufen Sie Account Retrieve ab] --> [Wenn requirements.currently_due nicht leer ist] [Onboarding für bestehende Nutzer/innen erneut durchführen] --> [Rufen Sie Account Retrieve ab] [Wenn requirements.currently_due nicht leer ist] --> [Weiterleitung zu gehostetem Onboarding] ``` ## Eingebettetes Onboarding Die Nutzeroberfläche des eingebetteten Onboardings hat nur wenig Stripe-Branding und kann perfekt an Ihre Marke angepasst werden. Nutzer/innen der verbundenen Konten interagieren mit der eingebetteten Komponente, ohne Ihre Anwendung verlassen zu müssen. Beim eingebetteten Onboarding wird die [Accounts API](https://docs.stripe.com/api/accounts.md) verwendet, um Anforderungen zu ermitteln 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 - Verifizierungs- und Statusangaben ermitteln - Internationale Bankkonten - Fehlerstatus Sie können das eingebettete Onboarding mit wenigen Codezeilen integrieren, während Sie beim API-basierten Onboarding eine nutzerdefinierte Logik erstellen müssen. Um das eingebettete Onboarding zu integrieren, folgen Sie unserem [Leitfaden für eingebettete Komponenten](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) und integrieren Sie die eingebettete [Konto-Onboarding](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md)-Komponente. (See full diagram at https://docs.stripe.com/connect/custom/onboarding) ```text [Onboarding neuer Nutzer/innen] --> [Konto erstellen] [Konto erstellen] --> [Wenn requirements.currently_due nicht leer ist] [Rufen Sie Account Retrieve ab] --> [Wenn requirements.currently_due nicht leer ist] [Onboarding für bestehende Nutzer/innen erneut durchführen] --> [Rufen Sie Account Retrieve ab] [Wenn requirements.currently_due nicht leer ist] --> [Die Onboarding-Komponente anzeigen] ``` 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. ## API-gestütztes Onboarding Beim API-gestützten Onboarding werden alle Aspekte der Onboarding-Benutzeroberfläche Ihrer Website so erweitert, dass die entsprechenden Stripe-APIs aufgerufen werden. Ihre Integration muss alle Onboarding-Anforderungen von Stripe erfüllen. (See full diagram at https://docs.stripe.com/connect/custom/onboarding) ```text [Onboarding eines neuen verbundenen Kontos] --> [Nutzeroberfläche anzeigen, um requirements von Ihrem verbundenen Konto zu erfassen] [Nutzeroberfläche anzeigen, um requirements von Ihrem verbundenen Konto zu erfassen] --> [Ein verbundenes Konto erstellen] [Ein verbundenes Konto erstellen] --> [Wenn requirements.currently_due nicht leer ist] [Das verbundene Konto abrufen] --> [Wenn requirements.currently_due nicht leer ist] [Formulare vorlegen, um Informationen zu erfassen und Felder zu validieren] --> [Das verbundene Konto mit den erfassten Informationen aktualisieren] [Erneutes Onboarding eines bestehenden verbundenen Kontos] --> [Das verbundene Konto abrufen] [Das verbundene Konto mit den erfassten Informationen aktualisieren] --> [Wenn requirements.currently_due nicht leer ist] [Wenn requirements.currently_due nicht leer ist] --> [Formulare vorlegen, um Informationen zu erfassen und Felder zu validieren] ``` ### Anforderungen festlegen Die folgenden Faktoren wirken sich auf die [Onboarding-Anforderungen](https://docs.stripe.com/connect/required-verification-information.md) für Ihre verbundenen Konten aus: - Das Ursprungsland der verbundenen Konten - [Art des Rahmenvertrags](https://docs.stripe.com/connect/service-agreement-types.md), der für die verbundenen Konten gilt - Für die verbundenen Konten angeforderte [Funktionen](https://docs.stripe.com/connect/account-capabilities.md) - Der [business_type](https://docs.stripe.com/api/accounts/object.md#account_object-business_type) (zum Beispiel Einzelperson oder Unternehmen) und die [company.structure](https://docs.stripe.com/api/accounts/object.md#account_object-company-structure) (zum Beispiel `public_corporation` oder `private_partnership`) Verwenden Sie das Tool für [erforderliche Verifizierungsinformationen](https://docs.stripe.com/connect/required-verification-information.md), um zu sehen, wie sich Änderungen an diesen Faktoren auf die Onboarding-Anforderungen für Ihre verbundenen Konten auswirken. ### Formulare erstellen, um Informationen zu erfassen Als Best Practice empfiehlt es sich, die erforderlichen Parameter in Ihrem Onboarding-Prozess in logischen Gruppierungen oder Formularen zu organisieren. Sie können eine Zuordnung zwischen den Stripe-Parametern und den logischen Gruppierungen kodieren. Vorgeschlagene logische Gruppierungen für Parameter werden in der ersten Spalte der Beispielanforderungstabelle angezeigt. Nachdem Sie die erforderlichen Parameter in Ihrer Anwendung kodiert haben, generieren Sie Nutzeroberflächen für die Parameter, die diesen Anforderungen entsprechen. Entwickeln Sie für jeden Parameter eine Nutzeroberfläche, die Folgendes enthält: - Parameterbezeichnung, lokalisiert für jedes unterstützte Land und jede unterstützte Sprache - Parameterbeschreibung, lokalisiert für jedes unterstützte Land und jede unterstützte Sprache - Parametereingabefelder mit Datenvalidierungslogik und Hochladen von Dokumenten (sofern erforderlich) Wenn Sie Ihre Anwendungslogik entwickeln, sollten Sie auch mögliche zukünftige Parameter im Hinterkopf behalten. Es kann zum Beispiel sein, dass Stripe im Laufe der Zeit neue Parameter, neue Verifizierungen oder neue Schwellenwerte einführt, die Sie in Ihr eigenes Onboarding integrieren müssen. Wenn Sie einen der Faktoren ändern, der die Anforderungen für Ihre verbundenen Konten bestimmt, müssen Sie auch Ihre Zahlungsformulare anpassen. [Land](https://docs.stripe.com/api/accounts/object.md#account_object-country) und [Art des Rahmenvertrags](https://docs.stripe.com/api/accounts/object.md#account_object-tos_acceptance-service_agreement) sind unveränderlich, wohingegen [Funktionen](https://docs.stripe.com/api/accounts/object.md#account_object-capabilities) und [Unternehmenstyp](https://docs.stripe.com/api/accounts/object.md#account_object-business_type) geändert werden können. - Um ein unveränderliches Feld wie das Land oder die Art der Rahmenvereinbarung zu ändern, erstellen Sie ein neues verbundenes Konto mit den neuen Werten. Dadurch entstehen neue Anforderungen, die Sie in Ihre Zahlungsabläufe integrieren müssen. - Um ein veränderbares Feld, wie z. B. die Funktionen oder den Unternehmenstyp zu ändern, aktualisieren Sie das verbundene Konto. Dadurch entstehen neue Anforderungen, die Sie in Ihre Zahlungsabläufe integrieren müssen. ### Allgemeine Geschäftsbedingungen von Stripe beifügen Ihre verbundenen Konten müssen die allgemeinen Geschäftsbedingungen von Stripe akzeptieren, bevor die Konten aktiviert werden können. Sie können die [allgemeinen Geschäftsbedingungen von Stripe in Ihre eigenen Bedingungen integrieren](https://docs.stripe.com/connect/updating-service-agreements.md#adding-stripes-service-agreement-to-your-terms-of-service). ### Verbundenes Konto erstellen Verwenden Sie die API zum [Erstellen von Konten](https://docs.stripe.com/api/accounts/create.md), um ein verbundenes Konto mit Land, Vereinbarung über die Art der Dienstleistung, den gewünschten Funktionen, dem Unternehmenstyp und allen anderen Informationen zu erstellen, die Ihren [Anforderungen](https://docs.stripe.com/connect/custom/onboarding.md#establish-requirements) entsprechen. Sie müssen mindestens die Parameter `capabilities` und `type` angeben. Wenn Sie keine anderen Parameter angeben, werden ihnen die folgenden Standardwerte zugewiesen: - Der Typ des Rahmenvertrags (`tos_acceptance.service_agreement`) ist standardmäßig auf `full` festgelegt. - Das Land für `country` ist standardmäßig das gleiche wie das Ihrer Plattform. Mit dem folgenden Codebeispiel wird ein verbundenes Custom-Konto mit `card_payments` und `transfers` im Rahmen eines umfassenden Rahmenvertrags für eine Einzelperson erstellt. > 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 country=US \ -d type=custom \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" ``` ### Führen Sie Ihr Konto durch den Onboarding-Ablauf Sie können verbundene Konten auf zwei Arten aktivieren: - Inkrementelle Onboarding-Strategie: [Erforderliche Informationen](https://docs.stripe.com/connect/custom/onboarding.md#establish-requirements) im Voraus einholen und den Rest später einholen - Onboarding-Strategie im Voraus: Informationen im Voraus einholen Beim inkrementellen Onboarding läuft das anfängliche Onboarding selbst schneller ab, zu einem späteren Zeitpunkt sind jedoch zusätzliche Informationen erforderlich. Wenn Sie sich für das Onboarding im Voraus entscheiden, kommt es während des gesamten Lebenszyklus des Kontos kaum zu Unterbrechungen, das Antragsverfahren ist jedoch umfangreicher. Sie können selbst entscheiden, welche Strategie besser zu Ihren Anwendungsszenarien passt. Um Ihre Onboarding-Strategie umzusetzen, prüfen Sie den Anforderungs-Hash des von Ihnen erstellten verbundenen Kontos. Der Anforderungs-Hash enthält eine vollständige Liste der Parameter, die Sie erfassen müssen, um das verbundene Konto zu aktivieren. - Wenn Sie sich für die inkrementelle Onboarding-Strategie entscheiden, prüfen Sie das Feld `currently_due` im Anforderungs-Hash und erstellen ein Onboarding, das nur die aufgeführten Parameter erfasst. - Wenn Sie sich für die Onboarding-Strategie im Voraus entscheiden, prüfen Sie das Feld `eventually_due` im Anforderungs-Hash und erstellen ein Onboarding, das alle aufgeführten Parameter erfasst. ```json { ... "requirements": { "alternatives": [], "current_deadline": null, "currently_due": [ "business_profile.product_description", "business_profile.support_phone", "business_profile.url", "external_account", "tos_acceptance.date", "tos_acceptance.ip" ], "disabled_reason": "requirements.past_due", "errors": [], "eventually_due": [ "business_profile.product_description", "business_profile.support_phone", "business_profile.url", "external_account", "tos_acceptance.date", "tos_acceptance.ip" ], "past_due": [], "pending_verification": [] }, ... } ``` ### Verbundenes Konto aktualisieren Aktualisieren Sie neue Informationen des verbundenen Account-Objekts, während dieses Ihr Onboarding durchläuft. Führen Sie einen [Kontoaktualisierungs](https://docs.stripe.com/api/accounts/update.md)-Aufruf durch und ermitteln Sie das verbundene Konto anhand des zuvor gespeicherten `id`-Wertes. ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" \ --data-urlencode "business_profile[url]=https://furever.dev" \ -d "tos_acceptance[date]=1609798905" \ -d "tos_acceptance[ip]=8.8.8.8" ``` Stripe validiert jede Aktualisierung eines verbundenen Kontos. Aktualisieren Sie das Konto bei jedem Onboarding-Schritt, damit Stripe die Informationen überprüfen kann, sobald sie hinzugefügt werden. Ihre Nutzer/innen können währenddessen mit dem Onboarding fortfahren. Nachdem Stripe die Annahme unserer allgemeinen Geschäftsbedingungen bestätigt hat, lösen alle Änderungen am verbundenen Konto eine erneute Verifizierung aus. Wenn Sie beispielsweise den Namen oder die ID-Nummer des verbundenen Kontos ändern, führt Stripe die Verifizierungen erneut durch. Beim Aktualisieren eines verbundenen Kontos müssen Sie alle [Verifizierungsfehler](https://docs.stripe.com/connect/custom/onboarding.md#verification-handling) oder [HTTP-Fehlercodes](https://docs.stripe.com/error-handling.md), die von der Accounts API zurückgegeben werden, handhaben. ## Verifizierungsabwicklung Nachdem die Daten des verbundenen Kontos übermittelt wurden, verifiziert Stripe diese. Dieser Vorgang kann je nach Art der Verifizierung Minuten oder Stunden dauern. Während der Ausführung dieses Vorgangs befinden sich die angeforderten Funktionen im `status` `pending`. ### Status prüfen Sie können den Status der Funktionen Ihres verbundenen Kontos wie folgt abrufen: - Der [Funktions](https://docs.stripe.com/api/accounts/object.md#account_object-capabilities)-Hash des Account-Objekts wird auf die relevante Funktion hin geprüft. - Funktionen werden direkt von der [Capabilities API](https://docs.stripe.com/api/capabilities/retrieve.md) angefordert und der Status der relevanten Funktion wird überprüft. - [Ereignisse](https://docs.stripe.com/api/events/types.md#event_types-account.updated) des Typs `account.updated` werden in Ihrem [Webhook](https://docs.stripe.com/connect/webhooks.md)-Endpoint überwacht und der Hash `capabilities` wird auf die entsprechende Funktion überprüft. Nachdem die Verifizierungen abgeschlossen sind, wird eine Funktion `active` und steht dem verbundenen Konto zur Verfügung. Kontoverifizierungen werden kontinuierlich durchgeführt, und wenn eine zukünftige Verifizierung fehlschlägt, kann eine Funktion aus dem Status `active` heraus wechseln. Überwachen Sie `account.updated`-Ereignisse, um Änderungen am Funktionsstatus zu erkennen. Bestätigen Sie, dass Ihre Connect-Integration konform und betriebsbereit ist, indem Sie überprüfen, ob `charges_enabled` und `payouts_enabled` für das Konto beide „true“ sind. Sie können die API verwenden oder Ereignisse des Typs `account.updated` überwachen. Details zu anderen relevanten Feldern finden Sie im Hash [Anforderungen](https://docs.stripe.com/api/accounts/object.md#account_object-requirements) des Kontos. Sie können die Integration nicht anhand eines einzelnen Werts bestätigen, da die Status je nach Anwendung und verwandten Richtlinien variieren können. - [charges_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-charges_enabled) bestätigt, dass Ihr vollständiger Zahlungspfad, einschließlich Zahlung und Überweisung, korrekt funktioniert, und prüft, ob die Funktionen `card_payments` oder `transfers` aktiv sind. - [payouts_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-payouts_enabled) gibt Auskunft darüber, ob Ihr verbundenes Konto Auszahlungen an ein externes Konto vornehmen kann. Je nach Ihren Risikorichtlinien können Sie zulassen, dass Ihr verbundenes Konto Transaktionen ausführt, auch wenn es noch keine Auszahlungen aktiviert hat. Sie müssen die [Auszahlungen jedoch zu einem späteren Zeitpunkt aktivieren](https://docs.stripe.com/connect/manage-payout-schedule.md), um Gelder an Ihre verbundenen Konten auszahlen. Sie können die folgende Logik als Ausgangspunkt für die Definition einer Statusübersicht verwenden, die Ihrem verbundenen Konto angezeigt wird. #### Ruby ```ruby # Don't put any keys in code. See https://docs.stripe.com/keys-best-practices. # Find your keys at https://dashboard.stripe.com/apikeys. client = Stripe::StripeClient.new('<>') def account_state(account) reqs = account.requirements if reqs.disabled_reason && reqs.disabled_reason.include?("rejected") "rejected" elsif account.payouts_enabled && account.charges_enabled if reqs.pending_verification "pending enablement" elsif !reqs.disabled_reason && !reqs.currently_due if !reqs.eventually_due "complete" else "enabled" end else "restricted" end elsif !account.payouts_enabled && account.charges_enabled "restricted (payouts disabled)" elsif !account.charges_enabled && account.payouts_enabled "restricted (charges disabled)" elsif reqs.past_due "restricted (past due)" elsif reqs.pending_verification "pending (disabled)" else "restricted" end end accounts = client.v1.accounts.list({limit: 10}) accounts.each do |account| puts "#{account.id} has state: #{account_state(account)}" end ``` ### Umgang mit Verifizierungsfehlern Gehen Sie je nach Onboarding-Prozess unterschiedlich mit fehlgeschlagenen Verifizierungen um. > Sie können die API nicht verwenden, um auf Stripe-Risikoprüfungen zu antworten. Sie können Ihre verbundenen Konten aktivieren, damit diese über eingebettete Komponenten, von Stripe gehostetes Onboarding oder Sanierungslinks reagieren können. Außerdem können Sie im Auftrag Ihrer verbundenen Konten über das Dashboard auf Risikoprüfungen antworten. #### API Ü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. [Erstellen Sie ein Formular](https://docs.stripe.com/connect/api-onboarding.md?accounts-namespace=v1#create-forms-to-collect-information) mit klaren Anweisungen, das das Konto zur Korrektur der Informationen verwenden kann. Benachrichtigen Sie das Konto und [übermitteln Sie die korrigierten Informationen](https://docs.stripe.com/connect/api-onboarding.md?accounts-namespace=v1#update-the-connected-account) dann über die Accounts API. (See full diagram at https://docs.stripe.com/connect/custom/onboarding) ```text [Wenn requirements.past_due Felder enthält] -- Ja --> [Konto möglicherweise deaktiviert; an das Onboarding weiterleiten] [Wenn requirements.currently_due Felder enthält] -- Ja --> [Das Onboarding des Kontos muss rechtzeitig vor der current_deadline abgeschlossen sein] [Wenn requirements.past_due Felder enthält] -- Nein --> [Wenn requirements.currently_due Felder enthält] [Wenn requirements.currently_due Felder enthält] -- Nein --> [Keine Aktion erforderlich] [account.updated-Ereignis] --> [Wenn requirements.past_due Felder enthält] [Das Onboarding des Kontos muss rechtzeitig vor der current_deadline abgeschlossen sein] --> [Zeigen Sie eine dynamisch generierte Nutzeroberfläche an, um Felder zu erfassen und zu validieren] [Konto möglicherweise deaktiviert; an das Onboarding weiterleiten] --> [Zeigen Sie eine dynamisch generierte Nutzeroberfläche an, um Felder zu erfassen und zu validieren] [Konto mit erfassten Feldern aktualisieren] --> [Wenn requirements.currently_due Felder enthält] [Wenn requirements.currently_due Felder enthält] --> [Zeigen Sie eine dynamisch generierte Nutzeroberfläche an, um Felder zu erfassen und zu validieren] [Zeigen Sie eine dynamisch generierte Nutzeroberfläche an, um Felder zu erfassen und zu validieren] --> [Konto mit erfassten Feldern aktualisieren] ``` Wenn Sie alle Ihre Verifizierungsfehler mit benutzerdefinierten Abläufen beheben möchten: - Überprüfen Sie die Details zu allen möglichen [Verifizierungsfehlern und deren Handhabung](https://docs.stripe.com/connect/handling-api-verification.md). - [Verifizierungsstatus testen](https://docs.stripe.com/connect/testing-verification.md) #### Eingebettet Ü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/custom/onboarding) ```text [Wenn requirements.past_due Felder enthält] -- Ja --> [Konto möglicherweise deaktiviert; Zum Onboarding weiterleiten] [Wenn requirements.currently_due Felder enthält] -- Ja --> [Das Onboarding des Kontos muss rechtzeitig vor der current_deadline abgeschlossen sein] [Wenn requirements.past_due Felder enthält] -- Nein --> [Wenn requirements.currently_due Felder enthält] [Wenn requirements.currently_due Felder enthält] -- Nein --> [Es besteht kein Handlungsbedarf] [Ereignis account.updated] --> [Wenn requirements.past_due Felder enthält] [Das Onboarding des Kontos muss rechtzeitig vor der current_deadline abgeschlossen sein] --> [Komponente für Konto-Onboarding rendern] [Konto möglicherweise deaktiviert; Zum Onboarding weiterleiten] --> [Komponente für Konto-Onboarding rendern] ``` ### Stripe-Nutzerauthentifizierung deaktivieren Wenn Sie eingebettetes Onboarding verwenden, ist die [Stripe-Nutzerauthentifizierung](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#user-authentication-in-connect-embedded-components) standardmäßig aktiviert. Sie können dieses Verhalten mit [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. 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. #### Gehostet Ü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 das von Stripe gehostete Onboarding-Formular leiten. (See full diagram at https://docs.stripe.com/connect/custom/onboarding) ```text [Wenn requirements.past_due Felder enthält] -- Ja --> [Konto möglicherweise deaktiviert; Zum Onboarding weiterleiten] [Wenn requirements.currently_due Felder enthält] -- Ja --> [Das Onboarding des Kontos muss rechtzeitig vor der current_deadline abgeschlossen sein] [Wenn requirements.past_due Felder enthält] -- Nein --> [Wenn requirements.currently_due Felder enthält] [Wenn requirements.currently_due Felder enthält] -- Nein --> [Es besteht kein Handlungsbedarf] [Ereignis account.updated] --> [Wenn requirements.past_due Felder enthält] [Das Onboarding des Kontos muss rechtzeitig vor der current_deadline abgeschlossen sein] --> [An das von Stripe gehostete Onboarding-Formular weiterleiten] [Konto möglicherweise deaktiviert; Zum Onboarding weiterleiten] --> [An das von Stripe gehostete Onboarding-Formular weiterleiten] ``` ## See also Weitere Infos zur Arbeit mit Custom-Konten. - [Umgang mit Verifizierungsaktualisierungen](https://docs.stripe.com/connect/handle-verification-updates.md) - [Konten aktualisieren](https://docs.stripe.com/connect/updating-service-agreements.md) - [Identitätsprüfung](https://docs.stripe.com/connect/identity-verification.md)