# Umgang mit Verifizierungsaktualisierungen Helfen Sie Ihren verbundenen Konten, die sich ändernden Verifizierungsanforderungen einzuhalten. Bevor Ihre verbundenen Konten Zahlungen annehmen und Auszahlungen senden können, müssen Sie die sogenannten Anforderungen von „Know Your Customer“ (KYC) erfüllen. Dazu müssen Sie [bestimmte Informationen über Ihre verbundenen Konten](https://docs.stripe.com/connect/required-verification-information.md) erfassen und zur Verifizierung an Stripe senden. Stripe aktualisiert die KYC-Anforderungen regelmäßig, häufig aufgrund von Änderungen, die von Finanzaufsichtsbehörden, Kartennetzwerken und anderen Finanzinstituten eingeführt werden. Bei diesen Aktualisierungen müssen Sie möglicherweise die folgenden Aktionen durchführen: 1. Ändern Sie Ihren Onboarding-Ablauf, um den geänderten Anforderungen Rechnung zu tragen. 1. Erfassen Sie aktualisierte Informationen von betroffenen verbundenen Konten und verarbeiten Sie Verifizierungsantworten. 1. [Handhaben Sie risikobezogene Anforderungen](https://docs.stripe.com/connect/handling-api-verification.md), indem Sie verbundene Konten über erkannte Probleme informieren, damit Sie diese über Stripe-Schnittstellen bei der Lösung unterstützen können. Wenn [anstehende Aktualisierungen der Anforderungen](https://support.stripe.com/user/questions/onboarding-requirements-updates) Ihre verbundenen Konten betreffen, benachrichtigen wir Sie. ## Anstehende Anforderungen ermitteln Wenn Stripe für die Erfassung von Anforderungen zuständig ist ([controller.requirement_collection](https://docs.stripe.com/api/accounts/object.md#account_object-controller-requirement_collection) ist `stripe`), kümmert sich Stripe automatisch um anstehende Änderungen der Anforderungen für Ihre verbundenen Konten. In diesem Fall betrifft der Rest dieses Dokuments Ihre Plattform nicht. Wenn die Plattform für die Erfassung von Anforderungen zuständig ist (`requirement_collection` ist `application`), müssen Sie sich selbst um anstehende Änderungen von Anforderungen kümmern. Stripe zeigt diese Änderungen über den Hash `future_requirements` an. Wie Sie darauf reagieren, hängt von der Art Ihrer Onboarding-Integration ab, wie unten erläutert. Anstehende Anforderungen werden in den Hashes `future_requirements` der Objekte [Account](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements) und [Capability](https://docs.stripe.com/api/capabilities/object.md#capability_object-future_requirements) angezeigt. Sie werden nicht im Hash `requirements` angezeigt und wirken sich nicht auf Funktionen aus. Wenn eine anstehende Anforderung in Kraft tritt, wechselt sie vom Hash `future_requirements` zum Hash `requirements` und kann sich auf die Funktionen des Kontos auswirken. Dadurch kann das Konto möglicherweise keine Transaktionen durchführen, bis Sie die Anforderung erfüllen. Der Zeitstempel `future_requirements.current_deadline` stellt dar, wann Einträge in `future_requirements` zu `requirements` wechseln. ## Zukünftige Anforderungen erfassen Falls Sie noch keine Integration mit Stripe vorgenommen haben, konfigurieren Sie Ihre Integration anhand des [Leitfadens „Integration gestalten“](https://docs.stripe.com/connect/design-an-integration.md), bevor Sie fortfahren. Wie Sie zukünftige Anforderungen erfassen, hängt von der Art Ihrer Onboarding-Integration ab. Wenn sich aktuelle oder anstehende Anforderungen ändern, aktualisiert Stripe automatisch von Stripe gehostete und eingebettete Onboarding-Abläufe, während API-gestützte Abläufe eine manuelle Aktualisierung Ihrerseits erfordern. | Art des Onboardings | So werden zukünftige Anforderungen erfasst | | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Von Stripe gehostetes Onboarding | Legen Sie beim Erstellen von `AccountLinks` für [collection_options.future_requirements](https://docs.stripe.com/api/account_links/create.md#create_account_link-collection_options) „include“ fest. | | Eingebettetes Onboarding | Wenn Sie die [Komponente für Konto-Onboarding](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md) oder die [Kontoverwaltungskomponente](https://docs.stripe.com/connect/supported-embedded-components/account-management.md) rendern, verwenden Sie die Erfassungsoptionen, um für `future_requirements` `include` festzulegen. | | API-gestütztes Onboarding | Überwachen Sie den Hash `future_requirements` des Kontos, aktualisieren Sie Ihren Onboarding-Ablauf, um alle neuen Einträge zu erfassen, und übermitteln Sie die Informationen über die API [Accounts](https://docs.stripe.com/api/accounts/update.md) oder [Persons](https://docs.stripe.com/api/persons/update.md). Beachten Sie die folgende [detaillierte Anleitung](https://docs.stripe.com/connect/handle-verification-updates.md#integrate-with-future-requirements). | Wenn Sie von Stripe gehostetes oder eingebettetes Onboarding verwenden, können Sie stattdessen die erforderlichen Informationen erfassen, indem Sie [Sanierungslinks](https://docs.stripe.com/connect/dashboard/remediation-links.md) erstellen und teilen. ## Mit zukünftigen Anforderungen integrieren Wenn Sie von Stripe gehostetes oder eingebettetes Onboarding verwenden, müssen Sie Ihren Onboarding-Ablauf bei Änderungen von Anforderungen nicht aktualisieren. Fahren Sie mit dem Abschnitt [Aktualisierungen überwachen](https://docs.stripe.com/connect/handle-verification-updates.md#listen-for-account-updates) fort. ## API-gestütztes Onboarding Wenn Sie ein benutzerdefiniertes API-gestütztes Onboarding verwenden, müssen Sie es aktualisieren, um alle geänderten Anforderungen zu erfüllen. Sie können auch erwägen, Ihren API-gestützten Onboarding-Ablauf durch [eingebettete Komponenten](https://docs.stripe.com/connect/embedded-onboarding.md) oder [von Stripe gehostetes Onboarding](https://docs.stripe.com/connect/hosted-onboarding.md) zu ersetzen. ### Vorschau der aktualisierten Verifizierungsanforderungen anzeigen Wenn sich die Verifizierungsanforderungen ändern, müssen Sie die aktualisierten Informationen bis zu einer bestimmten Frist erfassen. Wenn die geänderten Anforderungen für ein verbundenes Konto nicht erfüllt werden, können eine oder mehrere Funktionen dieses Kontos deaktiviert werden. Weitere Informationen zu den erforderlichen Angaben finden Sie unter [Informationen, die Sie erfassen müssen](https://docs.stripe.com/connect/required-verification-information.md), basierend auf der Region des Kontos, den angeforderten Funktionen und anderen Faktoren. Sie können eine Vorschau der Informationen zu anstehenden Änderungen von Anforderungen anzeigen, indem Sie sich den Hash [future_requirements](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements) des `Account`-Objekts ansehen. Um eine Unterbrechung der Funktionen Ihrer verbundenen Konten zu vermeiden, sollten Sie Informationen zu zukünftigen Anforderungen vor dem in `future_requirements.current_deadline` angegebenen Datum erfassen, an dem diese in den Hash `requirements` wechseln. Konten mit ausstehenden Anforderungen finden Sie auch auf der Seite [Verbundene Konten](https://dashboard.stripe.com/connect/accounts-list) in Ihrem Dashboard, wo Sie nach Kontoproblem und -status filtern können. Wenn Ihre verbundenen Konten noch nicht über die aktualisierten Anforderungen in `future_requirements` verfügen oder Sie verschiedene Konfigurationen testen möchten, können Sie das Formular auf der [Seite „Erforderliche Verifizierungsinformationen“](https://docs.stripe.com/connect/required-verification-information.md) nutzen. Sie können auch [Testkonten erstellen](https://docs.stripe.com/connect/testing.md). ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account","future_requirements": { "current_deadline": 1656608400, "currently_due": [ "company.tax_id" ], "disabled_reason": null, "errors": [], "eventually_due": [ "company.tax_id" ], "past_due": [], "pending_verification": [] }, ... } ``` > Wenn Sie [Stripe-Daten](https://docs.stripe.com/stripe-data.md) verwenden, können Sie den Hash `future_requirements` mithilfe einer [Sigma-Abfrage](https://docs.stripe.com/stripe-data/query-connect-data.md#account-requirements) abrufen. #### Fügen Sie Pflichtfelder zu Ihrem Onboarding-Ablauf hinzu Wenn Sie ermittelt haben, welche aktualisierten Informationen Sie erfassen müssen, entscheiden Sie, ob Sie diese zu Ihrem Onboarding-Ablauf hinzufügen möchten. Wenn es sich bei der Aktualisierung beispielsweise um eine neue Anforderung handelt, die immer für eine Funktion gilt, und Ihr Onboarding-Ablauf diese Funktion anfordert, müssen diese Informationen in Ihrem Ablauf erfasst werden. Wenn sich durch die Aktualisierung eine Anforderung ändert, weil ein Konto einen Schwellenwert erreicht hat, prüfen Sie, wie häufig Ihre Konten diesen Schwellenwert erreichen. Wenn es nicht üblich ist, muss Ihr Onboarding-Ablauf nicht verlangen, dass jedes neue verbundene Konto diese Informationen bereitstellt. Um sich auf Anforderungen vorzubereiten, die gelten, wenn ein Konto einen Schwellenwert erreicht, sollten Sie das Array [future_requirements.eventually_due](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements-eventually_due) untersuchen. Aktualisieren Sie Ihr Onboarding-Formular, um die neuen Felder zu erfassen, und übermitteln Sie sie dann über die API [Accounts](https://docs.stripe.com/api/accounts/update.md) oder [Persons](https://docs.stripe.com/api/persons/update.md). ### Testen Sie Ihren aktualisierten Onboarding-Ablauf Um zukünftige Verifizierungsanforderungen zu simulieren, erstellen Sie ein Testkonto mit der Accounts API und legen für seinen Parameter [email](https://docs.stripe.com/api/accounts/create.md#create_account-email) `enforce_future_requirements` fest. Dadurch wird der Hash `requirements` des Kontos mit allen bekannten zukünftigen Verifizierungsanforderungen gefüllt. #### Mit Controllereigenschaften ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d "controller[stripe_dashboard][type]=none" \ -d "controller[fees][payer]=application" \ -d "controller[losses][payments]=application" \ -d "controller[requirement_collection]=application" \ -d country=US \ -d business_type=individual \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ --data-urlencode "email=jenny.rosen+enforce_future_requirements@example.com" ``` #### Mit Kontotyp ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d type=custom \ -d country=US \ -d business_type=individual \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ --data-urlencode "email=jenny.rosen+enforce_future_requirements@example.com" ``` Um zu überprüfen, ob Ihr aktualisierter Onboarding-Ablauf die Kontoanforderungen erfüllt, führen Sie das Onboarding des Testkontos durch und prüfen Sie seinen Hash `requirements`. Wenn Ihr Ablauf alle Anforderungen abdeckt, ist das Array [currently_due](https://docs.stripe.com/api/accounts/object.md#account_object-requirements-currently_due) leer. Im [Testleitfaden](https://docs.stripe.com/connect/testing.md) finden Sie zusätzliche Tools zum Simulieren bestimmter Kontozustände. ### Übermittelte zukünftige Anforderungen verifizieren Nachdem Sie die erforderlichen Informationen übermittelt haben, prüfen Sie, ob sich die Anforderung noch im Hash `future_requirements` befindet. Wenn sie sich dort nicht mehr befindet, wurde die Anforderung erfolgreich erfüllt. Wenn sich die Anforderung immer noch in `future_requirements` befindet, überprüfen Sie das Array `future_requirements.errors` auf einen Eintrag mit einer Eigenschaft `requirement`, die mit dem Namen der Anforderung übereinstimmt. Dieser Fehler kann Informationen dazu enthalten, warum die Anforderung nicht erfüllt wird. Wenn die Anforderung keine entsprechenden Fehler aufweist, untersuchen Sie das Array `future_requirements.pending_verification`. Wenn es die Anforderung enthält, verarbeitet Stripe die Informationen noch. Überprüfen Sie sie später noch einmal. Wenn Stripe aktualisierte Informationen erhält, benötigen wir Zeit, um zu überprüfen, ob sie die entsprechenden Anforderungen erfüllen. Gehen Sie bis zum Abschluss dieser Verifizierung davon aus, dass die gesamte zugehörige Funktionalität deaktiviert bleibt. Um Updates zur Verifizierung zu erfassen, überwachen Sie Ereignisse von [account.updated](https://docs.stripe.com/api/events/types.md#event_types-account.updated) und überprüfen Sie diese auf [Verifizierungsfehler](https://docs.stripe.com/connect/handling-api-verification.md#validation-and-verification-errors). Der Hash `requirements` einer deaktivierten Funktion enthält eine [disabled_reason](https://docs.stripe.com/api/capabilities/object.md#capability_object-requirements-disabled_reason)-Angabe, mit der Sie bestimmen können, was Sie unternehmen müssen. Wenn die Validierung einer Übermittlung fehlschlägt, werden Fehler in `future_requirements.errors` angezeigt: ```json { "future_requirements": { "currently_due": ["company.tax_id"], "errors": [ { "code": "invalid_tax_id_format", "requirement": "company.tax_id", "reason": "Tax IDs must be a unique set of 9 numbers without dashes or other special characters." } ] } } ``` Stellen Sie sicher, dass Ihre Integration das Array `errors` analysiert, Ihren verbundenen Konten relevante Fehlermeldungen anzeigt und es ihnen ermöglicht, die Informationen zu korrigieren und erneut zu übermitteln. Einen vollständigen Satz von Testtools finden Sie im [Testleitfaden](https://docs.stripe.com/connect/testing.md). ## Konto-Updates beachten Achten Sie auf Änderungen des Kontostatus, indem Sie das Ereignis [account.updated](https://docs.stripe.com/api/events/types.md#event_types-account.updated) überwachen. Wenn sich aktive oder zukünftige Anforderungen ändern, enthält das Ereignis das aktualisierte Konto-Objekt. Um zukünftige Anforderungen zu überwachen, stellen Sie sicher, dass Ihr Webhook-Handler `future_requirements` korrekt anhand der Nutzlast analysiert: ```json { "type": "account.updated", "data": { "object": { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "future_requirements": { "currently_due": ["company.tax_id"], "past_due": ["company.tax_id"] } } } } ``` Nachdem ein Konto Ihren Onboarding-Ablauf durchlaufen hat, überprüfen Sie die Arrays `currently_due` und `pending_verification` im Hash `future_requirements` des Kontos. Wenn beide leer sind und `future_requirements.disabled_reason` Null ist, erfüllt das Konto alle anwendbaren zukünftigen Anforderungen. ## Überlegungen zur API-Version In der [API-Version 2023-10-16](https://docs.stripe.com/upgrades.md#2023-10-16) und höher gibt das Array [requirements.errors](https://docs.stripe.com/api/accounts/object.md#account_object-requirements-errors) des `Account`-Objekts alle Typen von Verifizierungsfehlern im `code`-Attribut an. Wenn Sie eine frühere API-Version verwenden, empfehlen wir dringend, auf die neueste API-Version zu aktualisieren und `requirements.errors` zu nutzen. Wenn Sie keine Aktualisierung auf die Version vom 16.10.2023 vornehmen können, enthalten frühere Versionen des Arrays `requirements.errors` das Feld `detailed_code` , um Verifizierungsfehler zurückzugeben, die mit dem Attribut `code` nicht kompatibel waren. Das Attribut `detailed_code` wird in der API-Referenz nicht angezeigt. Wenn Sie Konto- oder Sanierungslinks verwenden, um neue Anforderungen zu erfassen, setzen Sie die [API-Version auf den Stand von 2021-09-07](https://docs.stripe.com/sdks/set-version.md) oder neuer. Wenn Sie `account.updated`-Ereignisse erhalten. Legen Sie die [API-Version von Webhooks auf 07.09.2021](https://docs.stripe.com/upgrades.md#2021-09-07) oder neuer fest. ## Checkliste zur Vorbereitung Verwenden Sie diese Checkliste, um sicherzustellen, dass Ihre Integration für anstehende Änderungen der Anforderungen gerüstet ist: - Rufen Sie Konten ab und überprüfen Sie, ob Sie `future_requirements` lesen können - Ermitteln Sie neue Anforderungszeichenfolgen und sehen Sie sich an, welche Informationen zu erfassen sind - Aktualisieren Sie Onboarding-Formulare, um neue Pflichtfelder zu erfassen (nur bei API-gestütztem Onboarding) - Übermitteln Sie Testdaten und verifizieren Sie eindeutig die Anforderungen aus `future_requirements` - Gehen Sie Fehler an, indem Sie ungültige Übermittlungen testen und die Fehlerbehandlung überprüfen - Verarbeiten Sie Webhooks für Ereignisse von `account.updated` mit Änderungen in`future_requirements` - Führen Sie Tests mit mehreren Konten durch, um Konsistenz über verschiedene Unternehmenstypen hinweg zu gewährleisten ## See also - [Abwicklung der Verifizierung mit der API](https://docs.stripe.com/connect/handling-api-verification.md) - [Erforderliche Verifizierungsinformationen](https://docs.stripe.com/connect/required-verification-information.md) - [Connect testen](https://docs.stripe.com/connect/testing.md) - [Identitätsprüfung bei Konten testen](https://docs.stripe.com/connect/testing-verification.md) - [Dokumentenprüfung für verbundene Konten](https://docs.stripe.com/connect/additional-verifications/identity-document.md)