# Anstehende Anforderungsaktualisierungen Erfahren Sie mehr über die Änderungen an den erforderlichen Verifizierungsinformationen und wie sich dies auf Ihre Integration mit Stripe auswirkt. Die Anforderungsaktualisierungen in diesem Leitfaden beziehen sich auf Eigenschaften in der Accounts v1 API. Sie können die entsprechenden Accounts v2 API-Eigenschaften unter [erforderliche Verifizierungsinformationen](https://docs.stripe.com/connect/required-verification-information.md) einsehen. Wählen Sie hierzu im Dropdown-Menü **Accounts API** die Option `v2` und im Dropdown-Menü **Anforderungsaktualisierung** die gewünschte Aktualisierung aus. Regulatorische Vorschriften zu Zahlungen tragen dazu bei, Straftaten wie Geldwäsche, Betrug und Steuerhinterziehung zu verhindern. Finanzaufsichtsbehörden auf der ganzen Welt setzen [Know Your Customer (KYC)-Anforderungen](https://support.stripe.com/questions/know-your-customer) durch, um sicherzustellen, dass Stripe Identitätsangaben von bestimmten Arten von Unternehmen und von Einzelpersonen erfasst, verifiziert und aufbewahrt, die diese letztendlich besitzen, kontrollieren oder leiten. Diese Anforderungen werden häufig von Finanzdienstleistungsaufsichtsbehörden, Kartennetzwerken und anderen Finanzinstituten aktualisiert. Dieser Leitfaden bietet einen Überblick über die bevorstehenden Änderungen und hebt die wichtigsten Änderungen hervor. Die vollständige Liste der Anforderungen finden Sie unter [Erforderliche Verifizierungsinformationen](https://docs.stripe.com/connect/required-verification-information.md). Wenn Sie einen API-basierten Ablauf für das Onboarding Ihrer verbundenen verwenden, müssen Sie Ihre Integration aktualisieren, um alle Anforderungsänderungen zu verarbeiten. Erfahren Sie mehr über [Onboarding-Optionen für Connect](https://docs.stripe.com/connect/onboarding.md) und die [Migration Ihrer API-basierten Onboarding- und Sanierungsabläufe auf von Stripe gehostete oder eingebettete Abläufe](https://docs.stripe.com/connect/migrate-from-api-onboarding.md). #### Programm - Europa *Letzte Aktualisierung: 23. Februar 2026* ## Grundlegendes zu den Änderungen an den Verifizierungsanforderungen Zur Anpassung an die Vorschriften der Financial Conduct Authority (FCA) des Vereinigten Königreichs und der Central Bank of Ireland (CBI) aktualisiert Stripe seine Verifizierungsanforderungen für Kundinnen/Kunden (KYC) und wirtschaftliche Eigentümer/innen (UBOs) und Vorstände. Wenn Ihre verbundenen Konten in einem der aufgeführten Länder betrieben werden, müssen Sie möglicherweise Ihren Onboarding-Ablauf aktualisieren. Wenn Sie die erforderlichen Aktualisierungen nicht vornehmen, wird der Zugriff Ihrer verbundenen Konten auf Zahlungen und Finanzdienstleistungen unterbrochen. Um mehr darüber zu erfahren, was sich ändert und warum, lesen Sie den [Support-Artikel zu neuen Compliance-Anforderungen](https://support.stripe.com/questions/europe-verification-requirement-updates-for-connected-accounts). Die bevorstehenden Änderungen betreffen verbundene Konten in den folgenden Ländern: - AT - BE - BG - CH - CY - CZ - DE - DK - EE - ES - FI - FR - GB - GI - GR - HR - HU - IE - IS - IT - LI - LT - LU - LV - MT - NL - NO - PL - PT - RO - SE - SI - SK > #### Laufende Aktualisierungen > > Stripe wird die API bis zum 1. April 2026 weiter aktualisieren, um die Erfassung dieser Anforderungen zu unterstützen. ## Wahl eines Integration-Ansatzes Stripe empfiehlt, Stripe-gehostetes oder eingebettetes Onboarding zu verwenden, um Anforderungen zur Geschäfts- und Identitätsverifizierung zu erfassen. Diese Optionen erfordern weniger Ressourcen für Implementierung und Wartung als die Nutzung des API-Onboardings. Die folgende Tabelle beschreibt die wichtigsten Unterschiede: - [Von Stripe gehostetes Onboarding](https://docs.stripe.com/connect/hosted-onboarding.md): (Empfohlen) Senden Sie Konten zu einem Stripe-gehosteten Flow, damit die erforderlichen Informationen übermittelt werden. - [Eingebettetes Onboarding](https://docs.stripe.com/connect/embedded-onboarding.md): (Empfohlen) Betten Sie von Stripe bereitgestellte Onboarding-Komponenten ein, mit denen Konten Informationen direkt aus Ihrer App an Stripe übermitteln können. - [API Onboarding](https://docs.stripe.com/connect/api-onboarding.md): Erstellen und verwalten Sie einen benutzerdefinierten Onboarding-Ablauf mithilfe der Stripe-APIs. | | **Von Stripe gehostetes Onboarding** | **Eingebettetes Onboarding** | **API-Onboarding** | | ------------------------------------------------------------ | -------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | Ideal für Folgendes | Plattformen, die möchten, dass Stripe das Onboarding übernimmt | Plattformen, die einen markeneigenen In-App-Onboarding-Ablauf wünschen | Plattformen, die die volle Kontrolle benötigen und diesen Ablauf aufbauen und pflegen können | | Anfänglicher Implementierungsaufwand | 3–4 Engineering-Wochen | 3–4 Engineering-Wochen | 30–40 Engineering-Wochen | | Laufende Bemühungen, Anforderungsaktualisierungen umzusetzen | Wird automatisch von Stripe erledigt | Wird automatisch von Stripe erledigt | Erfordert eine proaktive Überwachung auf bevorstehende Änderungen sowie technische Ressourcen, um den Onboarding-Ablauf für jede Änderung zu aktualisieren | | Anpassung | Von Stripe gehostete Schnittstelle mit Plattform-Branding | Hochgradig themenfähige Komponente, auf die Konten über die Plattform-App zugreifen | Die Plattform entwirft, erstellt und verwaltet die Benutzeroberfläche | | Bemühungen um Support weiterer Länder | Wird automatisch von Stripe erledigt | Wird automatisch von Stripe erledigt | Erfordert technische Ressourcen, um den Onboarding-Ablauf für jedes zusätzliche Land zu aktualisieren | Erfahren Sie mehr über [Onboarding-Optionen von Connect](https://docs.stripe.com/connect/onboarding.md) und die [Migration Ihrer API-basierten Onboarding- und Sanierungsabläufe auf von Stripe gehostete oder eingebettete Abläufe](https://docs.stripe.com/connect/migrate-from-api-onboarding.md). Die [Änderungen, die Sie an Ihrem Onboarding-Ablauf vornehmen](https://docs.stripe.com/connect/handle-verification-updates.md#collect-future-requirements), sind von Ihrer Onboarding-Konfiguration abhängig. Aktualisieren Sie nicht nur Ihren Onboarding-Ablauf, sondern aktualisieren Sie auch Ihre interne und externe Dokumentation nach Bedarf und bereiten Sie Ihre Support-Teams darauf vor, Fragen zu den Updates zu beantworten. Wenn Sie das von Stripe gehostete oder eingebettete Onboarding verwenden, müssen Sie Ihre Integration nicht aktualisieren, um sich auf diese Anforderungsänderungen vorzubereiten. Sie können Ihren verbundenen Konten jedoch mitteilen, dass Stripe möglicherweise neue oder aktualisierte Identitätsangaben anfordert, wenn sich die Anforderungen ändern. ## Übersicht der API-Integration Wenn Sie sich entscheiden, nicht zu von Stripe gehostetem oder eingebettetem Onboarding zu migrieren, müssen Sie die folgenden Aktualisierungen vornehmen: - [KYC-(Kenne deinen Kunden)-Verifizierung](https://docs.stripe.com/connect/upcoming-requirements-updates.md#know-your-customer-\(kyc\)-verification) - [Überprüfung des/der endgültigen wirtschaftlichen Eigentümerin/Eigentümers (UBO) und der Beziehung zum Vorstand](https://docs.stripe.com/connect/upcoming-requirements-updates.md#ubo-director-verification) - [Anforderungen zur niederländischen Unternehmensregistrierung (KvK)](https://docs.stripe.com/connect/upcoming-requirements-updates.md#netherlands-business-registration-requirements) - [Neue Fehlercodes](https://docs.stripe.com/connect/upcoming-requirements-updates.md#new-error-codes) ## Zeitplan aktualisieren Der folgende Zeitplan erläutert die wichtigsten Meilensteine für diese Änderungen. Stellen Sie sicher, dass Sie Ihre Integration frühzeitig aktualisieren und testen, um Probleme zu vermeiden, wenn die neuen Anforderungen in Kraft treten. | Datum | Meilenstein | Beschreibung | | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Oktober 2025 | Beginn der Integrationsplanung | Erste API-Updates sind verfügbar. Überprüfen Sie diesen Leitfaden und die Änderungen, um mit der Planung Ihrer Integrationsupdates zu beginnen. | | März 2026 | Überprüfen Sie die betroffenen Konten und testen Sie Ihre Integrationsupdates. | Stripe stellt eine geschätzte Anzahl der betroffenen verbundenen Konten zur Verfügung. Beginnen Sie mit dem Test Ihres aktualisierten Onboarding-Flows. | | März–April 2026 | Die Einführung von `future_requirements` beginnt (API-Onboarding). | Für Plattformen, die API-Onboarding verwenden, beginnt Stripe damit, die neuen Anforderungen sowohl für neue als auch für bestehende Konten zu `future_requirements` hinzuzufügen. | | April 2026 | Es gelten neue Anforderungen für Plattformen, die ausschließlich verbundene Konten mit dem Unternehmenstyp `individual` haben | Stellen Sie sicher, dass Ihr aktualisierter Onboarding-Prozess bereit ist, die neuen Anforderungen zu erfassen. Ihr aktualisierter Prozess muss bis zum 1. April funktionieren, wenn Stripe mit der Einführung der neuen Anforderungen beginnt. Alle neuen Anforderungen werden Ende April wirksam. | | 1. Mai 2026 | Neue Anforderungen für Plattformen, die verbundene Konten mit dem Unternehmenstyp `company` haben, einschließlich Plattformen, die auch verbundene Konten mit dem Typ `individual` haben | Stellen Sie sicher, dass Ihr aktualisierter Onboarding-Prozess bereit ist, die neuen Anforderungen zu erfassen. Ihr aktualisierter Prozess muss bis zum 1. Mai für alle verbundenen Konten funktionieren, wenn Stripe mit der Einführung der neuen Anforderungen beginnt. Alle neuen Anforderungen werden Ende Mai wirksam. | | Juni–August 2026 | Für bestehende Konten werden derzeit neue Anforderungen fällig | Die neuen Anforderungen werden in diesem Zeitraum neu generiert und auf die bereits verbundenen Konten übertragen. Nutzen Sie Ihren aktualisierten Onboarding-Ablauf, um sie bei Bedarf einzuziehen. | | Juli - Oktober 2026 | Fälligkeitstermine für neue Anforderungen | Um Einschränkungen zu vermeiden, müssen die aktualisierten Anforderungen für jedes Konto bis zum Fälligkeitsdatum des jeweiligen Kontos verifiziert werden. | ## KYC-Verifizierung („Know Your Customer“, zu deutsch „Kenne deinen Kunden“) Stripe stärkt unseren Prozess zur Identitätsüberprüfung, was dazu führen kann, dass einige Ihrer verbundenen Konten zusätzliche Informationen bereitstellen müssen. Außerdem fügen wir der API mehr Optionen für die Verifizierung von Informationen hinzu. Die folgenden Unternehmen müssen überprüfbare KYC-Informationen bereitstellen: - Juristische Person (für natürliche Personen und Einzelunternehmer); - Kontovertreter/in - UBOs (Ultimate Beneficial Owners, letztendliche wirtschaftliche Eigentümer/innen (für Konten, die nach dem Stripe-Risikomodell als hoch risikoreich eingestuft werden) ### Zusätzliche Verifizierungsmethoden Verwenden Sie zusätzlich zu den standardmäßig eingegebenen Informationen die folgenden optionalen Methoden, um die Erfolgsquote der Verifizierung zu maximieren: - [Stripe Identity](https://docs.stripe.com/connect/upcoming-requirements-updates.md#stripe-identity): (Recommended) Selfie verwenden und Dokumente für Konten erfassen, bei denen die automatische Verifizierung fehlschlägt. - [Nationale ID-Verifizierung](https://docs.stripe.com/connect/upcoming-requirements-updates.md#national-id-verification): Zur Erhöhung der First-Pass-Verifizierungsquoten wird im Voraus eine nationale ID-Nummer erhoben. - [Hochladen weiterer Dokumente](https://support.stripe.com/questions/documents-for-identity-and-home-address-verification): Reichen Sie zusätzliche Identitäts- oder Adressdokumente zur manuellen Überprüfung ein. ### Stripe Identity (Empfohlen) Sie können versuchen, verbundene Konten, deren automatische Verifizierung fehlschlägt, mit [Stripe Identity](https://stripe.com/identity) zu verifizieren. Identity funktioniert durch das Erfassen eines Selfies und eines [Ausweisdokuments](https://docs.stripe.com/acceptable-verification-documents.md). Die meisten [europäischen Länder](https://docs.stripe.com/identity/use-cases.md) unterstützen Stripe Identity und die Erfolgsquoten variieren je nach Land. Erstellen Sie eine [Verifizierungssitzung](https://docs.stripe.com/api/identity/verification_sessions.md?api-version=preview) für die Identität und verwenden Sie den Parameter [related_person](https://docs.stripe.com/api/identity/verification_sessions/object.md?api-version=preview#identity_verification_session_object-related_person), um `document` und `proof_of_liveness`-Anforderungen für die Person zu übermitteln. Sie können die Ergebnisse über die API oder das Dashboard überprüfen. ### Überprüfung des Personalausweises In den [von diesem Update betroffenen Ländern](https://docs.stripe.com/connect/upcoming-requirements-updates.md#affected-countries) können Sie die Verifizierung eines Vertreters oder einer Vertreterin eines verbundenen Kontos verbessern, indem Sie zusätzlich zu Name, Geburtsdatum, Adresse und Nationalität die nationale Ausweisnummer angeben. Die Verifizierung unterstützt derzeit nur die folgenden nationalen Identifikationsnummern. | Land | Nationaler Ausweis | | -------- | -------------------------------------- | | Dänemark | Zentrales Personenregister (CPR) | | Italien | Steuernummer (Codice Fiscale) | | Polen | PESEL-Nummer | | Spanien | Documento Nacional de Identidad (DNI) | | Schweden | Personennummer (Personalausweisnummer) | Länder, die nicht von dieser Aktualisierung betroffen sind, wie z. B. die USA, unterstützen die Verifizierung der nationalen Ausweisnummer nicht. Beispielsweise können Sie die Ausweisnummer für eine spanische Person angeben, die als Vertreterin eines verbundenen Kontos in Österreich fungiert, aber nicht für eine spanische Person, die als Vertreterin eines verbundenen Kontos in den USA tätig ist. > #### Verfügbarkeit eines nationalen Ausweises > > Sie können mit der Erfassung nationaler ID-Nummern für Ihre verbundenen Konten beginnen, wenn die aktualisierten Anforderungen zu zukünftigen Anforderungen werden. In der Zwischenzeit ist die Integration für Ihre Sandbox-Konten als Vorschau verfügbar. ### Implementieren Sie die Verifizierung der nationalen Ausweisnummer über die API Das folgende Beispiel demonstriert das Onboarding eines neuen verbundenen Kontos mit den aktualisierten Anforderungen. > Die folgenden Unterschiede betreffen nur die v1 Accounts API, nicht v2. #### Schritt 1: Verbundenes Konto zum Testen erstellen (Öffentliche Vorschau) Nachdem zukünftige Anforderungen neu generiert wurden, können Sie wie gewohnt verbundene Konten erstellen. Erstellen Sie bis dahin neue verbundene Konten in einer [Sandbox](https://docs.stripe.com/sandboxes.md), um das neue KYC-Verhalten zu aktivieren. Lösen Sie dieses Verhalten aus, indem Sie zwei Teile Ihres Konto Erstellungsaufrufs ändern: 1. Fügen Sie die Kopfzeile `experimental_onboarding_preview=v2` hinzu. 1. Übermitteln Sie `capabilities[card_payments][preview]=true`. Nachdem Sie das Konto erstellt haben, wird eine neue Anforderungszeichenfolge `representative.nationality` angezeigt. Dies bedeutet, dass Sie eine/n Konto-Vertreter/in erstellen und die Nationalität weitergeben können. ```shell // Creating a connected account in Spain > curl https://api.stripe.com/v1/accounts \ -u sk_test_123 \ -H "Stripe-Version: 2025-08-27.basil;experimental_onboarding_preview=v2" \ -d 'type'='custom' \ -d 'country'='ES' \ -d 'capabilities[card_payments][requested]'='true' \ -d 'capabilities[card_payments][preview]'='true' \ -d 'capabilities[transfers][requested]'='true' { "id": "acct_1Nv0FGQ9RKHgCVdB", ... "requirements": { "past_due": [ ... "representative.nationality", ... ] } ... } ``` #### Schritt 2: Erstellen eines Konto-Vertreters Nachdem Sie das verbundene Konto erstellt haben, erstellen Sie einen Konto-Vertreter. ```shell > curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB/persons \ -u sk_test_123: \ -d first_name=John \ -d last_name=Doe { "id": "person_1N9XNb2eZvKYlo2CjPX7xF6B", ... } ``` #### Schritt 3: Angabe der Staatsangehörigkeit Nachdem Sie einen Konto-Vertreter erstellt haben, wird `nationality` in `past_due` angezeigt. Erfassen Sie dieses Feld, damit Stripe feststellen kann, ob der Vertreter für die Erfassung der `id_number` in Frage kommt. ```shell > curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB -u sk_test_123: { ... "requirements": { "past_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.dob.year", ...other person requirements... "person_1N9XNb2eZvKYlo2CjPX7xF6B.nationality" ] } ... } ``` Nachdem Sie die Staatsangehörigkeit eingezogen haben, sehen Sie, wenn sich die Person in einem berechtigten Land befindet, ihre Ausweisnummer als alternative Anforderung im Array `alternatives`. Jeder Eintrag im Array `alternatives` stellt einen alternativen Lösungspfad für eine Standard-Anforderung dar. Sie können anstelle der ursprünglichen Anforderung eine alternative Anforderung erfüllen, müssen aber nicht beide erfüllen. In diesem Beispiel enthält `alternatives` `id_number` als Alternative für die überfällige Anforderung `dob.year`. Das bedeutet, dass Sie anstelle des Geburtsjahres die nationale ID-Nummer der Person angeben können. Wenn Sie das Geburtsjahr angeben, müssen Sie nicht die ID-Nummer angeben. ```shell > curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB/persons/person_1N9XNb2eZvKYlo2CjPX7xF6B \ -u sk_test_123: \ -d nationality=ES > curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB -u sk_test_123: { "requirements": { "past_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.dob.year", ...other person fields... ], "alternatives": [ { "original_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.dob.year", ...other person fields... ], "alternative_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number" ] } ] } } ``` #### Schritt 4: Erfassen der verbleibenden Felder für den Konto-Vertreter Erfassen Sie zusätzliche Personenattribute, einschließlich einer nationalen Ausweisnummer, um die programmatische KYC-Verifizierung zu starten. ```shell > curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB/persons/person_1N9XNb2eZvKYlo2CjPX7xF6B \ -u sk_test_123: \ -d 'id_number'='74362315-A' \ ...other person fields... ``` #### Schritt 5: Eingegebene Felder werden in die ausstehende Verifizierung verschoben Nachdem Sie die entsprechenden Daten eingegeben haben, werden die Felder in `pending_verification` auf eine neue Art und Weise angezeigt: - Eingegebene Felder gehen in `pending_verification` anstatt in `verifizierung.document` und `verification.additional_document` über. Dies zeigt an, dass die eingegebenen Felder überprüft werden. - Die `id_number`-Anforderung kann in`pending_verification` gestellt werden, falls angegeben, auch wenn sie nur unter `alternative_fields_due` und nie unter `past_due` oder`currently_due` angezeigt wird. ```shell > curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB/ -u sk_test_123: { "requirements": { "pending_verification": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.city", "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.line1", "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.postal_code", "person_1N9XNb2eZvKYlo2CjPX7xF6B.dob.day", "person_1N9XNb2eZvKYlo2CjPX7xF6B.dob.month", "person_1N9XNb2eZvKYlo2CjPX7xF6B.dob.year", "person_1N9XNb2eZvKYlo2CjPX7xF6B.first_name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number", "person_1N9XNb2eZvKYlo2CjPX7xF6B.last_name" ] } } ``` #### Schritt 6: Umgang mit Verifizierungsfehlern In vielen Fällen besteht der Vertreter nach dem Setzen der Felder in `pending_verification`die KYC-Prüfung und der Prozess wird abgeschlossen. Wenn die Verifizierung fehlschlägt, gibt Stripe zusätzliche Informationen zurück, die Ihnen bei den nächsten Schritten helfen. Es gibt zwei wichtige Änderungen. **Mehrere Alternativen** Im Anforderungs-Hash sehen Sie mehrere Alternativen. Jede dieser Funktionen stellt einen möglichen Weg für Ihre Nutzer/innen dar. Beispielsweise, wenn Name und Geburtsdatum übereinstimmen, aber Name und Adresse nicht, hat Ihr verbundenes Konto mehrere Möglichkeiten, das Problem zu lösen: 1. Sie können die von ihnen eingegebenen Informationen für Name und Adresse überprüfen und diese Felder erneut eingeben, um Fehler zu korrigieren. 1. Sie können die eingegebenen Informationen für Geburtsdatum, Name, Adresse und id_number überprüfen und die korrekten Informationen erneut eingeben. 1. Sie können ein Dokument hochladen, das mit ihrem Namen und ihrer Adresse übereinstimmt 1. Sie können Stripe Identity abschließen Diese vier Pfade werden als `past_due`-Felder und `alternatives` angezeigt: ```shell > curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB -u sk_test_123: { "requirements": { // 1. They can check the information they've entered for dob, name, and address, and re-enter the correct information. "past_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.first_name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.last_name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.*" ], "alternatives": [ // 2. They can check the information they entered for dob, name, address and id_number and re-key correct information. { "original_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.first_name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.last_name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.*" ], "alternative_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number" ] }, // 3. They can upload document that matches their name and address { "original_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.first_name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.last_name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.*" ], "alternative_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.verification.additional_document" ] }, // 4. They can complete Stripe Identity { "original_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.first_name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.last_name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.*" ], "alternative_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.proof_of_liveness" ] } ] } } ``` **Fehler bei eingegebenen Feldern** Wenn zuvor bei der Verarbeitung von eingegebenen Feldern ein Verifizierungsfehler auftrat, wurden Dokumentfelder auf `past_due` gesetzt und es traten Fehler auf ihnen auf. In Zukunft kehren die eingegebenen Felder zu`past_due` zurück. Felder wie`id_number` verbleiben in`alternative_fields_due`. Wenn z. B. Name, Geburtsdatum und Adresse ursprünglich `past_due` sind, und nach der Einreichung stimmen Name und Geburtsdatum überein, während Name und Adresse dies nicht tun, dann kehren Name und Adresse zurück zu`past_due`, während das Geburtsdatum entfernt wird. In diesem Fall werden Fehler in den Feldern in `past_due` und`alternative_fields_due` angezeigt. ```shell > curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB -u sk_test_123: { "requirements": { "past_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.address" ], "alternatives": [ { "original_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.address" ], "alternative_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number" ] }, { "original_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.address" ], "alternative_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.proof_of_liveness" ] }, { "original_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.name", "person_1N9XNb2eZvKYlo2CjPX7xF6B.address" ], "alternative_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.verification.additional_document" ] } ], "errors": [ { "code": "verification_failed_keyed_identity", "reason": "Identity information could not be verified.", "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.name" }, { "code": "verification_failed_keyed_identity", "reason": "Identity information could not be verified.", "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.address" }, { "code": "verification_failed_keyed_identity", "reason": "Identity information could not be verified.", "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number" } ] } } ``` ### Konten mit hohem Risiko Für das Risikomodell von Stripe ist eine KYC-Verifizierung für UBOs nur bei Konten erforderlich, die als hoch risikoreich eingestuft werden. Hängen Sie für Tests `_high_risk` an den Unternehmensnamen an, um eine Risikoeinstufung zu erzwingen. Auf diese Weise können Sie den gesamten KYC-Verifizierungsablauf für Eigentümer/innen testen, einschließlich der Anforderungen und Fehler, die Ihre Integration handhaben muss. Dieses Beispiel zeigt, wie Sie ein Testkonto mit hohem Risiko erstellen und Eigentümer/innen hinzufügen: ```curl // Creating a connected account in Spain curl https://api.stripe.com/v1/accounts \ -u sk_test_123: \ -H "Stripe-Version: 2025-08-27.basil;experimental_onboarding_preview=v2" \ -d 'type'='custom' \ -d 'country'='ES' \ -d 'capabilities[card_payments][requested]'='true' \ -d 'capabilities[card_payments][preview]'='true' \ -d 'capabilities[transfers][requested]'='true' { "id": "acct_123", ... "requirements": {...} ... } // Set the business name to enforce the account to be high risk curl https://api.stripe.com/v1/accounts/acct_123 \ -u sk_test_123: \ -d "business_profile[name]"="example_high_risk" ``` ```curl curl https://api.stripe.com/v1/accounts/acct_123/persons \ -u sk_test_123: \ -d first_name=Marie \ -d last_name=Dupont \ -d "dob[day]"=1 \ -d "dob[month]"=1 \ -d "dob[year]"=1901 \ -d "relationship[owner]=true" \ -d "address[line1]"="address_no_match" \ -d "address[city]"="Madrid" \ -d "address[postal_code]"="28001" { "id": "person_123", ... } ``` ```curl curl https://api.stripe.com/v1/accounts/acct_123 \ -u sk_test_123: \ -d "company[owners_provided]"="true" ``` Nachdem Stripe die KYC-Verifizierung der Eigentümerin oder des Eigentümers durchgeführt hat, spiegeln die Konto-Anforderungen das Ergebnis wider. Wenn der Name der Eigentümerin oder des Eigentümers übereinstimmt, die Adresse aber nicht (ausgelöst durch die Verwendung der Testadresse `address_no_match`), umfassen die Anforderungen `verification_failed_keyed_identity`-Fehler in den Feldern der Eigentümerin oder des Eigentümers: ```json { "requirements": { "past_due": [ "people.person_123.address.city", "people.person_123.address.line1", "people.person_123.address.postal_code", "people.person_123.first_name", "people.person_123.last_name" ], "errors": [ { "code": "verification_failed_keyed_identity", "requirement": "people.person_123.address.city" }, { "code": "verification_failed_keyed_identity", "requirement": "people.person_123.address.line1" }, { "code": "verification_failed_keyed_identity", "requirement": "people.person_123.address.postal_code" }, { "code": "verification_failed_keyed_identity", "requirement": "people.person_123.first_name" }, { "code": "verification_failed_keyed_identity", "requirement": "people.person_123.last_name" } ], "alternatives": [ { "original_fields_due": [ "people.person_123.address.city", "people.person_123.address.line1", "people.person_123.address.postal_code", "people.person_123.first_name", "people.person_123.last_name" ], "alternative_fields_due": [ "people.person_123.verification.additional_document" ] }, { "original_fields_due": [ "people.person_123.address.city", "people.person_123.address.line1", "people.person_123.address.postal_code", "people.person_123.first_name", "people.person_123.last_name" ], "alternative_fields_due": [ "people.person_123.verification.proof_of_liveness" ] } ] } } ``` Um diese Anforderungen zu erfüllen, müssen Sie entweder die Identitätsangaben der Eigentümerin oder des Eigentümers erneut übermitteln oder eine der alternativen Anforderungen erfüllen (`additional_document` hochladen oder `proof_of_liveness` ausfüllen). ## Beziehungsüberprüfung für UBOs und Geschäftsführer/innen Stripe verbessert seinen Prozess zur Überprüfung von wirtschaftlichen Eigentümern (UBOs) und Vorständen. Die europäischen Vorschriften verlangen eine Überprüfung der Beziehung von UBOs und Vorständen zur juristischen Person: - **UBO:** Eine Einzelperson, die (direkt oder indirekt) mehr als 25 % einer juristischen Person besitzt oder kontrolliert (z. B. Unternehmen, Kapitalgesellschaften, LLCs und Partnerschaften). - **Vorstandsmitglied**: Ein Mitglied des Verwaltungsrats des Unternehmens oder jede andere leitende Person, die für das Management des Unternehmens verantwortlich ist. (Beispiele hierfür sind CEO, COO, President, Geschäftsführer, geschäftsführender Vorstand usw.) Die folgende Tabelle zeigt die Beziehungen, die für jeden juristischen Personentyp verifiziert werden müssen: | Typ der juristischen Person | Zu überprüfende Beziehungen | Hinweis | | ----------------------------------------------------------- | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Unternehmen, Kapitalgesellschaft, LLC, Personengesellschaft | UBOs, falls zutreffend; ansonsten Vorstände | Nur Vereinigtes Königreich: sowohl UBOs als auch Geschäftsführer/innen | | Wohltätige Organisation | Vorstandsmitglieder | Die meisten gemeinnützigen Organisationen haben keine UBOs | | Privatperson oder Einzelunternehmer/in | k. A. | k. A. | | Regierungsstelle oder Behörde | k. A. | Um von der Bereitstellung von UBO-Informationen befreit zu werden, müssen Regierungsstellen den in [diesem Support-Artikel](https://support.stripe.com/questions/business-verification-requirements-for-government-entities) beschriebenen Prozess befolgen. | | Börsennotiertes Unternehmen | k. A. | Um von der Bereitstellung von UBO-Informationen befreit zu werden, müssen börsennotierte Unternehmen den in [diesem Support-Artikel](https://support.stripe.com/questions/business-verification-requirements-for-publicly-traded-companies) beschriebenen Prozess befolgen. | ### UBO- und Vorstandsinformationen UBOs und Vorstandsmitglieder müssen die folgenden Informationen bereitstellen: - Vollständiger Name - Geburtsdatum - Adresse - E-Mail-Adresse - Titel (nur Vorstandsmitglieder) Stripe versucht, die Beziehung der Person zu überprüfen, indem es die folgenden zentralen Eigenschaften der Person mit der juristischen Person abgleicht: | Unternehmen | Wichtige Eigenschaften | | ------------------ | ----------------------------------------------------------------------------------------------- | | Person | - Vorname - Nachname - (Falls angegeben) Ausweisnummer | | Juristische Person | - Name - Adresse - Steueridentifikationsnummer - Umsatzsteuer-ID - Registrierungsnummer | Für eine erfolgreiche Verifizierung muss möglicherweise nur ein Teil der Eigenschaften übereinstimmen. Stripe versucht, Beziehungen auf folgende Weise zu überprüfen: | Methode | Beschreibung | Beispielanforderungen | | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Drittanbieter | Wenn ein Drittanbieter verfügbar ist, versucht Stripe automatisch, alle Beziehungen auf dem Konto zu verifizieren. | - `owners.first_name` - `owners.last_name` - `company.tax_id` | | Offizielles Dokument | Sie können ein Dokument zum Nachweis der wirtschaftlichen Berechtigung für Inhaber/innen und ein Dokument zum Nachweis der Registrierung für Geschäftsführer/innen vorlegen. Die [akzeptierten Dokumente](https://docs.stripe.com/acceptable-verification-documents.md) variieren je nach Land. | - `owners.first_name` - `owners.last_name` - `company.name` - `company.address.line1` - `company.address.city` - `company.address.state` - `documents.proof_of_ultimate_beneficial_ownership` | | Digitale Bescheinigung | Sie können die folgenden PDF-Vorlagen verwenden, um digitale Bescheinigungen für Ihre Beziehungen bereitzustellen: - [Vorlage für digitale UBO-Bescheinigungen](https://docs.stripecdn.com/6e82842bfc01bd0b1c46d77f7d46b69673a9ca965ed2ad9ef53139f98abdbbaf.pdf) - [Vorlage zur digitalen Bescheinigung des Vorstands](https://docs.stripecdn.com/715ffef45157ff700bc368a4011659ee23bc8ba3c68746c5c15948a6eee1591f.pdf) | - `owners.id_number` - `company.tax_id` - `documents.proof_of_ultimate_beneficial_ownership` - `documents.proof_of_ultimate_beneficial_ownership.signer` | ### Identifizieren Sie die Anforderungen zur Überprüfung von Beziehungen mithilfe der API Wenn Sie die Anforderungen für ein `Konto` abrufen, stellen die ursprünglichen und alternativen Verifizierungsoptionen Kombinationen aus den wichtigsten Informationen und den verfügbaren Verifizierungsmethoden dar. In den meisten Fällen gibt es mindestens drei Optionen zur Verifizierung von Eigentümerinnen und Eigentümern oder Geschäftsführerinnen und Geschäftsführern. Der folgende Code zeigt ein Beispiel für ein verbundenes Konto mit Anforderungen an den Eigentümer. Bestimmte Optionen und die Reihenfolge, in der sie angezeigt werden, können je nach Konto variieren. ```shell // Example with owner requirements > curl https://api.stripe.com/v1/accounts/acct_1234 \ -u sk_test_123: { "id": "acct_1234", "past_due": { // third-party provider option "currently_due": [ "owners.first_name", "owners.last_name", "company.owners_provided", "company.tax_id" ], "alternatives": [ { "original_fields_needed": [ "owners.first_name", "owners.last_name", "company.owners_provided", "company.tax_id" ], // official document option "alternative_fields_needed": [ "owners.first_name", "owners.last_name", "company.owners_provided", "company.name", "company.address.line1", "company.address.state", "company.address.city", "documents.proof_of_ultimate_beneficial_ownership.files" ], }, { "original_fields_needed": [ "owners.first_name", "owners.last_name", "company.owners_provided", "company.tax_id" ], // digital attestation option "alternative_fields_needed": [ "owners.first_name", "owners.last_name", "company.owners_provided", "company.name", "company.address.line1", "company.address.state", "company.address.city", "documents.proof_of_ultimate_beneficial_ownership.files", "documents.proof_of_ultimate_beneficial_ownership.signer" ], } ] } } ``` ### Verifizierung des Vorstands anstatt von Inhaberinnen/Inhabern Wenn ein verbundenes Konto berechtigt ist, den Vorstand anstelle von Inhaber/innen anzugeben, enthält es alternative Optionen zur Verifizierung des Vorstands. Wenn Sie den Vorstand verifizieren, müssen Sie dennoch bestätigen, dass Sie keine UBOs angegeben haben. Das folgende Beispiel zeigt ein verbundenes Konto, das zur Verifizierung des Vorstands anstatt von Inhaberinnen/Inhabern berechtigt ist: ```shell // Example with owner requirements > curl https://api.stripe.com/v1/accounts/acct_1234 \ -u sk_test_123: { "id": "acct_1234", "past_due": { // third-party provider option for owners "currently_due": [ "owners.first_name", "owners.last_name", "company.owners_provided", "company.tax_id" ], "alternatives": [ ..., { "original_fields_needed": [ "owners.first_name", "owners.last_name", "company.owners_provided", "company.tax_id" ], // third-party provider option for directors "alternative_fields_needed": [ "directors.first_name", "directors.last_name", "company.directors_provided", "company.owners_provided", "company.tax_id" ], } ] } } ``` Wenn Sie Informationen zum Vorstand bereitstellen und bestätigen, dass Sie keine UBOs angeben, spiegeln die primären Anforderungsoptionen immer noch die Inhaberanforderungen wider. Sie können Informationen zu Inhaberinnen und Inhabern angeben, wenn diese verfügbar sind. Das folgende Beispiel zeigt ein verbundenes Konto mit 0-UBO-Bescheinigung: ```shell // Example with owner requirements > curl https://api.stripe.com/v1/accounts/acct_1234 \ -u sk_test_123: { "id": "acct_1234", "past_due": { // third-party provider option for owners "currently_due": [ "owners.first_name", "owners.last_name", // company.owners_provided is no longer a requirement "company.tax_id" ], "alternatives": [ ..., { "original_fields_needed": [ "owners.first_name", "owners.last_name", "company.tax_id" ], // third-party provider option for directors "alternative_fields_needed": [ "directors.first_name", "directors.last_name", "company.directors_provided", "company.tax_id" ], } ] } } ``` ### Fehlerbehandlung Fehler bei den Anforderungen an Inhaber/innen und Vorstandsmitglieder können zusätzlich zu den üblichen [Fehlern bei Dokumenten- und Detailabgleichen](https://docs.stripe.com/error-codes.md) die folgenden `Codewerte` umfassen. | Code | Beschreibung | | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `verification_missing_owners` | Dem `Konto` fehlen Informationen über Inhaber/innen, die von einem Drittanbieter identifiziert wurden oder in einem Dokument oder einer digitalen Bescheinigung aufgeführt sind. | | `verification_missing_directors` | Dem `Konto` fehlen Informationen zum Vorstand, die von einem Drittanbieter identifiziert wurden oder in einem Dokument oder einer digitalen Bescheinigung aufgeführt sind. | | `verification_data_not_found` (Private preview) | Ein Drittanbieter konnte keine Informationen über das Unternehmen finden. | In einigen Fällen können Sie diese Fehler beheben, indem Sie die Unternehmensdaten aktualisieren. In den meisten Fällen müssen Sie jedoch die verbundenen Konten entweder zum Dokumenten-Upload-Pfad oder zum digitalen Beglaubigungspfad weiterleiten. Wenn Stripe fehlende Inhaber/innen oder Vorstandsmitglieder identifiziert, kann in einigen Fällen eine private Vorschau-API Daten über diese Personen bereitstellen. Das verbundene Konto kann diese Daten verwenden, um die fehlenden `Personen` anzulegen. ### Implementieren Sie eine digitale Bestätigung für die UBO- und Vorstandsverifizierung mithilfe der API > #### Verfügbarkeit > > Die Accounts v2-API unterstützt derzeit noch keine digitale Bescheinigungen. Das folgende Beispiel zeigt, wie eine digitale Bestätigung für die Verifizierung von UBOs oder Geschäftsführern durchgeführt wird. 1. Rufen Sie das Konto ab, um zu ermitteln, welche Bescheinigungsdokumente erforderlich sind. ```shell // Check for UBO attestation requirement > curl https://api.stripe.com/v1/accounts/acct_1234 \ -u sk_test_123: // Response showing UBO attestation { "id": "acct_1234", "requirements": { "past_due": [ "documents.proof_of_ultimate_beneficial_ownership.files", "documents.proof_of_ultimate_beneficial_ownership.signer", ], "errors": [] } } // Or for directors & officers requirement { "id": "acct_1234", "requirements": { "past_due": [ "documents.proof_of_registration.files", "documents.proof_of_registration.signer" ], "errors": [] } } ``` Die Option für digitale Bescheinigungsanforderungen kann als primäre Option oder als Alternative zu einer anderen Option angezeigt werden. Bestimmte Optionen und die Reihenfolge, in der sie angezeigt werden, können je nach Konto variieren. 1. Erstellen Sie ein PDF mithilfe der Vorlage und lassen Sie es von einer berechtigten Person digital unterschreiben. 1. Laden Sie das signierte Bescheinigungsdokument mit der Datei-API hoch. ```shell curl -X POST https://files.stripe.com/v1/files \ -u sk_test_123: \ -F purpose=account_requirement \ -F file=@signed_attestation.pdf // Response { "id": "file_1234567890", "object": "file", "purpose": "account_requirement" } ``` 1. Reichen Sie das Dokument mit dem Ausweis der `Person` ein, die die/den Unterzeichner/in vertritt. ```shell // For UBO attestation curl -X POST https://api.stripe.com/v1/accounts/acct_1234 \ -u sk_test_123: \ -d "documents[proof_of_ultimate_beneficial_ownership][files][]=file_1234567890" \ -d "documents[proof_of_ultimate_beneficial_ownership][signer][person]=person_xyz" // For D&O attestation curl -X POST https://api.stripe.com/v1/accounts/acct_1234 \ -u sk_test_123: \ -d "documents[proof_of_registration][files][]=file_1234567890" \ -d "documents[proof_of_registration][signer][person]=person_xyz" ``` ### Anforderungen an die Validierung des Unterzeichners Wer kann Bescheinigungen unterzeichnen? - Konto-Vertreter/innen - Geschäftsinhaber ( mehr als 25 % Eigentümerschaft) - Vorstandsmitglieder und Führungskräfte - Andere autorisierte Mitglieder des Kontos Wichtig: Bei dem Unterzeichner muss es sich um eine existierende Person handeln, die mit dem Konto verknüpft ist. Nur Personen, die eine dokumentierte Beziehung zur juristischen Person haben, können Bescheinigungsdokumente unterzeichnen. ### Fehlerbehebung Der digitale Nachweis führt bestimmte Fehlerszenarien ein, die Sie berücksichtigen müssen: #### Ungültiger Unterzeichner Tritt auf, wenn der/die Unterzeichner/in nicht mit dem Konto verknüpft ist oder keine Berechtigung hat. ```shell { "requirements": { "errors": [{ "requirement": "documents.proof_of_ultimate_beneficial_ownership.files", "code": "invalid_signator", "reason": "Unauthorized attestation signer. The signer must have a documented relationship with the legal entity." }, { "requirement": "documents.proof_of_ultimate_beneficial_ownership.signer", "code": "invalid_signator", "reason": "Unauthorized attestation signer. The signer must have a documented relationship with the legal entity." }] } } ``` #### Dokument fehlgeschlagen Tritt auf, wenn das hochgeladene Dokument unlesbar oder falsch ist. ```shell { "requirements": { "past_due": ["documents.proof_of_registration.files"], "errors": [{ "requirement": "documents.proof_of_registration.files", "code": "verification_document_failed_other", "reason": "Your team can contact Stripe to learn more about why identity verification failed." }] } } ``` #### Unterzeichner/in ohne Dateien eingereicht API-Fehler beim Übermitteln von Unterzeichnern ohne Dateien ```shell { "error": { "code": "invalid_signator", "message": "signer.person can only be provided when a file is also provided", "type": "invalid_request_error" } } ``` ### Ausblick 1. Aktualisieren Sie Ihre Integration, um Unterzeichnernamen bei der Verwendung von Bescheinigungsdokumenten einzuziehen. 1. Implementieren der Fehlerbehandlung für neue nachweisspezifische Fehlercodes. 1. Schulen Sie Ihr Support-Team in den neuen Nachweisanforderungen. #### UBO- und Geschäftsführerinformationen vorausfüllen (Private Vorschau) Optional können Sie auch eine API integrieren, die programmgesteuert die mit einer juristischen Person verbundenen UBOs oder Vorstandsmitglieder erkennt und vorab ausfüllt. Das verbundene Konto kann die Beziehung durch Bestätigung der erkannten Informationen überprüfen, anstatt durch Hochladen von Dokumenten oder digitale Beglaubigung. Dieser Pfad kann die Verifizierungsquoten erhöhen und Reibungsverluste reduzieren, ist jedoch nicht für alle Konten geeignet. Für Konten, bei denen Stripe die Beziehungen nicht vorab ausfüllen kann, müssen Sie weiterhin Dokumenten-Uploads oder digitale Beglaubigungen bearbeiten. Wenn Sie an einer Vorabausfüllung für die UBO- oder Vorstandsüberprüfung interessiert sind, melden Sie sich bitte unten an, um Ihr Interesse zu bekunden. ## Anforderungen zur Unternehmensregistrierung (KvK) in den Niederlanden **Gültig ab 14. Mai 2026** Anfang 2026 wurden Plattformen verpflichtet, von verbundenen Konten in den Niederlanden (NL) eine KvK-Nummer (Kamer van Koophandel) zu erfassen. Dabei handelt es sich um eine eindeutige 8-stellige Registrierungsnummer für Unternehmen. Im Rahmen dieser Änderung wurde der Unternehmenstyp `individual` mit dem Fehler `unsupported_business_type` eingeschränkt und Unternehmen ohne Rechtspersönlichkeit wurden verpflichtet, über `company.tax_id` eine KvK-Nummer anzugeben. Ab dem 14. Mai 2026 sind verbundene Konten, die Einzelpersonen oder Unternehmen ohne Rechtspersönlichkeit darstellen und keinen Zugriff auf ein von Stripe gehostetes Dashboard haben, nicht mehr zur Angabe einer KvK-Nummer verpflichtet. Verbundene Konten, die Einzelpersonen oder Unternehmen ohne Rechtspersönlichkeit darstellen und Zugriff auf das vollständige Stripe-Dashboard oder das Express-Dashboard haben, müssen weiterhin eine KvK-Nummer angeben. ### Was ändert sich? - `business_type: "individual"` wird jetzt für verbundene Konten in den Niederlanden unterstützt, die keinen Zugriff auf ein von Stripe gehostetes Dashboard haben. Der Fehler `unsupported_business_type` wird für diese Konten nicht mehr angezeigt. - Die Unternehmenstypen `unincorporated_partnership` und `unincorporated_non_profit` verlangen für verbundene Konten ohne Zugriff auf ein von Stripe gehostetes Dashboard nicht mehr, dass `company.tax_id` die KvK-Nummer enthält. ### Das müssen Sie erledigen Es besteht kein Handlungsbedarf. Sie müssen keine Änderungen an Ihrer Integration vornehmen. Für bestehende verbundene Konten, die von dieser Änderung betroffen sind: - Stripe löscht den Fehler `unsupported_business_type` für einzelne Konten automatisch aus `requirements.errors`. - Alle Funktionseinschränkungen (wie `card_payments` oder `transfers`), die mit diesem Fehler verbunden sind, werden automatisch aufgehoben. - Konten, die Einzelpersonen oder Unternehmen ohne Rechtspersönlichkeit darstellen und aufgrund einer fehlenden KvK-Nummer eingeschränkt waren, werden ebenfalls automatisch entsperrt. ## Neue Fehlercodes ### Verifizierungsfehlercodes (Private preview) Der neue Fehlercode `verification_data_not_found` kann im Array `requirements.errors` des Objekts `Konto` erscheinen. Dieser Fehler signalisiert, dass Stripe keine Informationen (wie Daten zu UBO oder Vorstand/Führungskräften) von externen Verifizierungsanbietern unter Verwendung der bekannten Angaben zur juristischen Person des verbundenen Kontos abrufen konnte. Dies kann verschiedene Ursachen haben, häufig liegt es jedoch daran, dass die Kontoinhaber ihre Informationen falsch eingegeben haben… Dieser Fehler „Daten nicht gefunden“ unterscheidet sich von den bestehenden Verifizierungsfehlercodes: - **`verification_missing_owners`**: Weist darauf hin, dass bekannte Inhaber/innen in dem Konto fehlen. - **`verification_failed_keyed_match`**: Weist auf eine Diskrepanz zwischen den übermittelten Informationen und den Überprüfungsquellen hin. ```shell // Example: verification_data_not_found error { "requirements": { "errors": [{ "requirement": "owners", "code": "verification_data_not_found", "reason": "Stripe was unable to retrieve ownership or director information from third-party providers based on the current legal entity details. Verify that the business information on the account is correct." }] } } ``` Um diesen Fehler zu beheben, bitten Sie das verbundene Konto, seine Angaben zur juristischen Person (Unternehmensname, Registrierungsnummer, Adresse) zu überprüfen und zu korrigieren. Wenn die Angaben aktualisiert werden, versucht Stripe automatisch, sie erneut zu überprüfen. Sollten die Kontoinformationen korrekt sein oder sollte Stripe die aktualisierten Informationen weiterhin nicht verifizieren können, verwenden Sie bitte eine manuelle Verifizierungsmethode, wie beispielsweise das Hochladen von Dokumenten oder eine digitale Bescheinigung. ## Testen Sie können Testkonten erstellen, die Sie beim Entwickeln und Testen Ihrer Integration verwenden können. Testkonten können verschiedene Verifizierungsergebnisse simulieren, sodass Sie sehen können, wie die API Anforderungen und Fehler für jeden Fall zurückgibt. Die folgenden Beispiele helfen Ihnen bei der Vorbereitung auf die bevorstehenden Änderungen der EU-Anforderungen. Weitere Informationen zu Connect-Tests im Allgemeinen finden Sie unter [Stripe Connect testen](https://docs.stripe.com/connect/testing.md). ### Testkonto erstellen Erstellen Sie ein `Testkonto`, indem Sie mit Ihrem [Sandbox-Geheimschlüssel](https://docs.stripe.com/keys.md) eine POST-Anfrage an die Accounts API senden. Um auf die neuen Anforderungen zuzugreifen, bevor sie für Konten außerhalb des Test-Modus freigegeben werden, legen Sie einen Header fest, der eine Vorschauversion der API aktiviert. Aktivieren Sie die experimentelle Onboarding-Vorschaufunktion und aktivieren Sie die Vorschauversion, wenn Sie eine Funktion anfordern. Im Folgenden finden Sie ein Beispiel dafür: ```shell curl https://api.stripe.com/v1/accounts \ -u sk_test_123: \ -H "Stripe-Version: 2026-01-28.preview;experimental_onboarding_preview=v2" \ -d 'type'='custom' \ -d 'country'='ES' \ -d 'capabilities[card_payments][requested]'='true' \ -d 'capabilities[card_payments][preview]'='true' \ -d 'capabilities[transfers][requested]'='true' \ -d 'capabilities[transfers][preview]'='true' ``` Die folgenden Beispiele zeigen, wie Sie verschiedene Situationen simulieren, indem Sie Werte verwenden, die bestimmte Antworten für Testkonten auslösen. ### Ein Konto einer Einzelperson testen In diesem Beispiel wird ein Konto erstellt, für das keine Beziehungsüberprüfung erforderlich ist, da es sich bei der Art der Geschäftseinheit um eine `Einzelperson` handelt. Erstellen Sie ein Testkonto gemäß [den vorherigen Anweisungen](https://docs.stripe.com/connect/upcoming-requirements-updates.md#create-a-test-account) und legen Sie dann die grundlegenden Unternehmensdaten fest: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d business_type=individual \ -d "business_profile[mcc]"=5995 \ -d "business_profile[url]"="https://accessible.stripe.com" ``` Die Antwort enthält die grundlegenden Anforderungen für eine Einzelperson. Sie können diese Anforderungen erfüllen, indem Sie eine/n Vertreter/in erstellen: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123/persons \ -u sk_test_123: \ -d "first_name=Marie" \ -d "last_name=Dupont" \ -d "dob[year]=1901" \ -d "dob[month]=1" \ -d "dob[day]=1" \ -d "address[line1]=address_full_match" \ -d "address[city]=Madrid" \ -d "address[postal_code]=28009" \ -d "address[country]=ES" \ -d "email=test@example.com" \ -d "phone=%2B35366666666" \ -d "nationality=ES" \ -d "relationship[representative]=true" ``` Die Angabe des Geburtsdatums 01.01.1901 löst in einer Sandbox eine erfolgreiche Identitätsprüfung aus. Weitere Ergebnisauslöser finden Sie unter [Test-Geburtsdaten](https://docs.stripe.com/connect/testing.md#test-dobs). Ebenso wird durch Festlegen der ersten Zeile der Adresse auf die Zeichenfolge `address_full_match` eine erfolgreiche Verifizierung der Adresse ausgelöst. Weitere Ergebnisauslöser finden Sie unter [Test-Unternehmensadressen](https://docs.stripe.com/connect/testing.md#test-validation-addresses). Die Antwort zeigt, dass die Anforderungen der Einzelperson jetzt als ausstehend gelten. Wenn Sie einen Moment warten und dann das `Konto` abrufen, können Sie sehen, dass diese Anforderungen als erfüllt markiert wurden: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123 ``` Die einzigen verbleibenden Anforderungen betreffen das Bankkonto (`external_account`) und die Allgemeinen Geschäftsbedingungen (AGB). Um die Anforderungen bezüglich der Allgemeinen Geschäftsbedingungen zu erfüllen, legen Sie für den Hash des `Kontos` `tos_acceptance` fest: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d "tos_acceptance[date]=1540248693" \ -d "tos_acceptance[ip]=10.0.0.1" ``` Um die Anforderungen bezüglich des Bankkontos zu erfüllen, erstellen Sie ein Testbankkonto für das `Konto`. Geben Sie [eine Test-Bankkontonummer an, die dem Land entspricht](https://docs.stripe.com/connect/testing.md#account-numbers): ```shell curl https://api.stripe.com/v1/accounts/acct_test_123/external_accounts \ -u sk_test_123: \ -d "external_account[object]=bank_account" \ -d "external_account[account_number]=ES0700120345030000067890" \ -d "external_account[country]=ES" \ -d "external_account[currency]=EUR" ``` ### Ein Konto eines Unternehmens testen In diesem Beispiel wird ein Konto erstellt, das den Anforderungen an die Beziehungsüberprüfung unterliegt, da es sich bei der Art der Geschäftseinheit um ein `Unternehmen` handelt. > Das Vereinigte Königreich verlangt eine Verifizierung sowohl der letztendlichen wirtschaftlichen Eigentümern/Eigentümerinnen als auch der Vorstandsmitglieder. Wenn Sie verbundene Konten im Vereinigten Königreich haben, sollten Sie Tests mit Konten durchführen, die als Land `GB` angegeben haben. Erstellen Sie ein Testkonto gemäß [den vorherigen Anweisungen](https://docs.stripe.com/connect/upcoming-requirements-updates.md#create-a-test-account) und legen Sie dann die grundlegenden Unternehmensdaten fest: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d business_type=company \ -d "business_profile[mcc]"=5995 \ -d "business_profile[url]"="https://accessible.stripe.com" \ -d "company[name]=Test company" \ -d "company[phone]=628123456787" \ -d "company[address][line1]=address_full_match" \ -d "company[address][city]=Madrid" \ -d "company[address][postal_code]=28009" \ -d "company[address][country]=ES" \ -d "company[tax_id]=000000000" ``` Die Angabe der Steueridentifikationsnummer `000000000` löst eine erfolgreiche Verifizierung des Unternehmens aus. Weitere Ergebnisauslöser finden Sie unter [Test-Steueridentifikationsnummern für Unternehmen](https://docs.stripe.com/connect/testing.md#test-business-tax-ids). Geben Sie als Nächstes einen Vertreter/eine Vertreterin an. ```shell curl https://api.stripe.com/v1/accounts/acct_test_123/persons \ -u sk_test_123: \ -d "first_name=Adam" \ -d "last_name=" \ -d "dob[year]=1901" \ -d "dob[month]=1" \ -d "dob[day]=1" \ -d "address[line1]=address_full_match" \ -d "address[city]=Madrid" \ -d "address[postal_code]=28009" \ -d "address[country]=ES" \ -d "email=test@example.com" \ -d "phone=%2B35366666666" \ -d "nationality=ES" \ -d "relationship[representative]=true" \ -d "relationship[title]=CEO" ``` Nachdem der Verifizierungsprozess für den/die Vertreter/in abgeschlossen ist, können Sie die verbleibenden Anforderungen mit einer GET-Anfrage einsehen: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: ``` Die Anforderungen im Array `requirements.currently_due` listen die Details auf, die wir bezüglich der Inhaber/innen des `Kontos` benötigen. Das Array `requirements.alternatives` kann optionale Informationen enthalten, die Sie bereitstellen können, um bestimmte Anforderungen zu erfüllen. Dies gilt beispielsweise für die folgenden Angaben: ```json { "alternative_fields_due": [ "company.owners_provided", "documents.proof_of_ultimate_beneficial_ownership.files", "owners.first_name", "owners.last_name" ], "original_fields_due": [ "company.owners_provided", "owners.first_name", "owners.last_name" ] } ``` Sie können die unter `alternative_fields_due` aufgeführten Felder als weitere Möglichkeit angeben, die Anforderungen in der entsprechenden Liste `original_fields_due` zu erfüllen. In diesem Beispiel enthält `alternative_fields_due` die Eigenschaften in `original_fields_due` und zudem `documents.proof_of_ultimate_beneficial_ownership.files`. Das bedeutet, dass die ursprünglichen Informationen erforderlich sind, aber Sie zur Unterstützung des Verifizierungsprozesses auch ein Dokument vorlegen können, das die letztendliche wirtschaftliche Eigentümerschaft nachweist. Um die Anforderungen bezüglich des Inhabers/der Inhaberin zu erfüllen, erstellen Sie zwei Personen und kennzeichnen Sie sie als Inhaber/innen. Die Namen in diesem Beispiel sind fest codierte Werte für Testkonten, die die Steueridentifikationsnummer `000000000` verwenden. ```shell curl https://api.stripe.com/v1/accounts/acct_test_123/persons \ -u sk_test_123: \ -d "first_name=Marie" \ -d "last_name=Dupont" \ -d "dob[year]=1901" \ -d "dob[month]=1" \ -d "dob[day]=1" \ -d "address[line1]=address_full_match" \ -d "address[city]=Madrid" \ -d "address[postal_code]=28009" \ -d "address[country]=ES" \ -d "email=owner@example.com" \ -d "relationship[owner]=true" curl https://api.stripe.com/v1/accounts/acct_test_123/persons \ -u sk_test_123: \ -d "first_name=Louis" \ -d "last_name=Martin" \ -d "dob[year]=1901" \ -d "dob[month]=1" \ -d "dob[day]=1" \ -d "address[line1]=address_full_match" \ -d "address[city]=Madrid" \ -d "address[postal_code]=28009" \ -d "address[country]=ES" \ -d "email=owner@example.com" \ -d "relationship[owner]=true" ``` Geben Sie an, dass Sie alle Inhaber/innen des `Kontos` erstellt haben, indem Sie `company.owners_provided` auf „true“ setzen: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d "company[owners_provided]=true" ``` Durch Beantwortung dieser Anfrage werden alle Anforderungen bezüglich der Inhaber/innen aus dem `Konto` entfernt. ### Test-Fallback zur Dokumentverifizierung Die Anforderungen bezüglich der Inhaber/innen eines `Kontos` bleiben `current_due` (oder `pending_verification`, wenn die Verifizierung läuft), bis die Verifizierung erfolgreich ist. Wenn die Verifizierung fehlschlägt, besteht eine Ihrer Optionen darin, ein Dokument hochzuladen. Dieses Beispiel zeigt, wie Sie dies mithilfe der API tun können. Erstellen Sie ein Testkonto gemäß [den vorherigen Anweisungen](https://docs.stripe.com/connect/upcoming-requirements-updates.md#create-a-test-account) und legen Sie dann die grundlegenden Unternehmensdaten fest. Geben Sie die Steueridentifikationsnummer `222221001` an, was ein Fehlschlagen der Verifizierung der Eigentümerin oder des Eigentümers auslöst. Weitere Ergebnisauslöser finden Sie unter [Steueridentifikationsnummern von Unternehmen testen](https://docs.stripe.com/connect/testing.md#test-business-tax-ids). ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d business_type=company \ -d "business_profile[mcc]"=5995 \ -d "business_profile[url]"="https://accessible.stripe.com" \ -d "company[name]=Test company" \ -d "company[phone]=628123456787" \ -d "company[address][line1]=address_full_match" \ -d "company[address][city]=Madrid" \ -d "company[address][postal_code]=28009" \ -d "company[address][country]=ES" \ -d "company[tax_id]=222221001" ``` Geben Sie als Nächstes einen Vertreter/eine Vertreterin an: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123/persons \ -u sk_test_123: \ -d "first_name=Marie" \ -d "last_name=Dupont" \ -d "dob[year]=1901" \ -d "dob[month]=1" \ -d "dob[day]=1" \ -d "address[line1]=address_full_match" \ -d "address[city]=Madrid" \ -d "address[postal_code]=28009" \ -d "address[country]=ES" \ -d "email=test@example.com" \ -d "phone=%2B35366666666" \ -d "nationality=ES" \ -d "relationship[representative]=true" \ -d "relationship[title]=CEO" ``` Erstellen Sie dann einen Inhaber/eine Inhaberin: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123/persons \ -u sk_test_123: \ -d "first_name=Adam" \ -d "last_name=Smith" \ -d "dob[year]=1901" \ -d "dob[month]=1" \ -d "dob[day]=1" \ -d "address[line1]=address_full_match" \ -d "address[city]=Madrid" \ -d "address[postal_code]=28009" \ -d "address[country]=ES" \ -d "email=owner@example.com" \ -d "relationship[owner]=true" ``` Geben Sie an, dass Sie die Erstellung der Inhaber/innen abgeschlossen haben, indem Sie `company.owners_provided` auf „true“ setzen: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d "company[owners_provided]=true" ``` Wenn Sie sich das `Account` ansehen, können Sie feststellen, dass die Anforderungen bezüglich der Inhaber/innen bestehen bleiben und das Array `requirements.errors` einen Eintrag mit einer `requirement` bezüglich der `owners` und einem `code` namens `verification_failed_other` enthält. Das bedeutet, dass Stripe die Inhaber/innen anhand der angegebenen Informationen des Unternehmens nicht verifizieren konnte. > Wenn Sie die Version der privaten Vorschau der API verwenden, lautet der Fehlercode [verification_data_not_found](https://docs.stripe.com/changelog/clover/2025-10-29/accounts-verification-data-error.md) statt `verification_failed_other`. Wenn Sie diese Fehlermeldung für ein echtes `Konto` erhalten, überprüfen Sie, ob Sie die Angaben für die korrekte juristische Person eingegeben haben. In diesem Beispiel wird davon ausgegangen, dass die Angaben korrekt sind und dass Sie ein Dokument einreichen müssen, um sie zu verifizieren. [Verwenden Sie für ein echtes `Account` die Files API, um ein Dokument hochzuladen](https://docs.stripe.com/file-upload.md), und aktualisieren Sie dann das `Account` mit dem in der Antwort zurückgegebenen Token. Verwenden Sie in diesem Beispiel das Test-Token `file_relationship_document_success`. Weitere Ergebnisauslöser finden Sie unter [Beziehungsdokument-Token testen](https://docs.stripe.com/connect/testing.md#test-relationship-document-tokens). ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d "documents[proof_of_ultimate_beneficial_ownership][files][]"=file_relationship_document_success ``` Wenige Augenblicke nach der Aktualisierung des `Kontos` können Sie die aktuellen Anforderungen abrufen und sehen, dass die Anforderungen bezüglich der Inhaber/innen erfüllt wurden. ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: ``` ### Ein Unternehmen ohne zutreffende Inhaber/innen testen Wenn ein Unternehmen keine Inhaber/innen mit Anteilen von mehr als 25 % aufweist, benötigt Stripe stattdessen Informationen zum Vorstand. Dieses Beispiel zeigt, wie Sie Informationen zum Vorstand angeben. Erstellen Sie ein Testkonto gemäß [den vorherigen Anweisungen](https://docs.stripe.com/connect/upcoming-requirements-updates.md#create-a-test-account) und legen Sie dann die grundlegenden Unternehmensdaten fest. Geben Sie die Steueridentifikationsnummer `000000000` an, wodurch die erfolgreiche Verifizierung des Unternehmens ausgelöst wird. ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d business_type=company \ -d "business_profile[mcc]"=5995 \ -d "business_profile[url]"="https://accessible.stripe.com" \ -d "company[name]=Test company" \ -d "company[phone]=628123456787" \ -d "company[address][line1]=address_full_match" \ -d "company[address][city]=Madrid" \ -d "company[address][postal_code]=28009" \ -d "company[address][country]=ES" \ -d "company[tax_id]=000000000" ``` Geben Sie als Nächstes einen Vertreter/eine Vertreterin an: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123/persons \ -u sk_test_123: \ -d "first_name=Marie" \ -d "last_name=Dupont" \ -d "dob[year]=1901" \ -d "dob[month]=1" \ -d "dob[day]=1" \ -d "address[line1]=address_full_match" \ -d "address[city]=Madrid" \ -d "address[postal_code]=28009" \ -d "address[country]=ES" \ -d "email=test@example.com" \ -d "phone=%2B35366666666" \ -d "nationality=ES" \ -d "relationship[representative]=true" \ -d "relationship[title]=CEO" ``` Um anzugeben, dass das Unternehmen keine relevanten Inhaber/innen hat, setzen Sie `company.owners_provided` auf „true“, ohne Inhaber/innen zu erstellen. Um ein bestehendes `Testkonto`, das Inhaber/innen aufweist, erneut zu verwenden, können Sie alle bestehenden Inhaber/innen entfernen. ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d "company[owners_provided]=true" ``` Das Array `requirements.alternatives` enthält eine Reihe von Eigenschaften für den Vorstand als Alternative zu den Eigenschaften der Inhaber/innen. Der Prozess zur Erstellung eines Vorstands ähnelt dem Prozess zur Erstellung eines Inhabers/einer Inhaberin: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123/persons \ -u sk_test_123: \ -d "first_name=Adam" \ -d "last_name=Smith" \ -d "dob[year]=1901" \ -d "dob[month]=1" \ -d "dob[day]=1" \ -d "address[line1]=address_full_match" \ -d "address[city]=Madrid" \ -d "address[postal_code]=28009" \ -d "address[country]=ES" \ -d "email=owner@example.com" \ -d "relationship[director]=true" \ -d "relationship[title]=President" ``` Geben Sie an, dass Sie die Erstellung von Vorstandsmitgliedern abgeschlossen haben, indem Sie `company.directors_provided` auf „true“ setzen: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d "company[directors_provided]=true" ``` Um eine erfolgreiche Beziehungsüberprüfung zu simulieren, legen Sie für `company.name` die Zeichenfolge `match_name_relationships` fest: ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d "company[name]=match_name_relationships" ``` ### Andere Testszenarien Folgende Tests sind ebenfalls nützlich: - Eine juristische Person des Typs `non_profit`, für die eine Verifizierung des Vorstands erforderlich ist (eine Verifizierung der letztendlich wirtschaftlichen Eigentümer/innen ist nicht möglich). - Erfüllung der Verifizierungsanforderungen bezüglich des Vorstands mithilfe eines Dokuments. - Unternehmen im Vereinigten Königreich, für die sowohl eine Verifizierung der letztendlich wirtschaftlichen Eigentümer/innen als auch eine Verifizierung des Vorstands erforderlich ist. #### Programm - Brasilien *Zuletzt aktualisiert: 27. April 2026* ## Grundlegendes zu den Änderungen an den Verifizierungsanforderungen Zur Anpassung an die Vorschriften der brasilianischen Zentralbank (BCB) gemäß Circular BCB 3978/20 aktualisiert Stripe seine Verifizierungsanforderungen für Know Your Customer (KYC), Know Your Business (KYB) und wirtschaftlich Eigentümer/innen (UBO). Wenn Ihre verbundenen Konten in Brasilien betrieben werden, müssen Sie möglicherweise Ihren Onboarding- und Sanierungsablauf aktualisieren. Wenn Sie die erforderlichen Aktualisierungen nicht vornehmen, wird der Zugriff Ihrer verbundenen Konten auf Zahlungen und Finanzdienstleistungen unterbrochen. ## Wahl eines Integrationsansatzes Stripe empfiehlt, Stripe-gehostetes oder eingebettetes Onboarding zu verwenden, um Anforderungen zur Geschäfts- und Identitätsverifizierung zu erfassen. Diese Optionen erfordern weniger Ressourcen für Implementierung und Wartung als die Nutzung des API-Onboardings. Die folgende Tabelle beschreibt die wichtigsten Unterschiede: - [Von Stripe gehostetes Onboarding](https://docs.stripe.com/connect/hosted-onboarding.md): (Empfohlen) Senden Sie Konten zu einem Stripe-gehosteten Flow, damit die erforderlichen Informationen übermittelt werden. - [Eingebettetes Onboarding](https://docs.stripe.com/connect/embedded-onboarding.md): (Empfohlen) Betten Sie von Stripe bereitgestellte Onboarding-Komponenten ein, mit denen Konten Informationen direkt aus Ihrer App an Stripe übermitteln können. - [API Onboarding](https://docs.stripe.com/connect/api-onboarding.md): Erstellen und verwalten Sie einen benutzerdefinierten Onboarding-Ablauf mithilfe der Stripe-APIs. | | **Von Stripe gehostetes Onboarding** | **Eingebettetes Onboarding** | **API-Onboarding** | | ------------------------------------------------------------ | -------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | Ideal für Folgendes | Plattformen, die möchten, dass Stripe das Onboarding übernimmt | Plattformen, die einen markeneigenen In-App-Onboarding-Ablauf wünschen | Plattformen, die die volle Kontrolle benötigen und diesen Ablauf aufbauen und pflegen können | | Anfänglicher Implementierungsaufwand | 3–4 Engineering-Wochen | 3–4 Engineering-Wochen | 30–40 Engineering-Wochen | | Laufende Bemühungen, Anforderungsaktualisierungen umzusetzen | Wird automatisch von Stripe erledigt | Wird automatisch von Stripe erledigt | Erfordert eine proaktive Überwachung auf bevorstehende Änderungen sowie technische Ressourcen, um den Onboarding-Ablauf für jede Änderung zu aktualisieren | | Anpassung | Von Stripe gehostete Schnittstelle mit Plattform-Branding | Hochgradig themenfähige Komponente, auf die Konten über die Plattform-App zugreifen | Die Plattform entwirft, erstellt und verwaltet die Benutzeroberfläche | | Bemühungen um Support weiterer Länder | Wird automatisch von Stripe erledigt | Wird automatisch von Stripe erledigt | Erfordert technische Ressourcen, um den Onboarding-Ablauf für jedes zusätzliche Land zu aktualisieren | Erfahren Sie mehr über [Onboarding-Optionen von Connect](https://docs.stripe.com/connect/onboarding.md) und die [Migration Ihrer API-basierten Onboarding- und Sanierungsabläufe auf von Stripe gehostete oder eingebettete Abläufe](https://docs.stripe.com/connect/migrate-from-api-onboarding.md). Plattformen, die von Stripe gehostetes oder eingebettetes Onboarding verwenden, müssen ihre Integrationen für diese Anforderungsaktualisierungen nicht anpassen – Stripe übernimmt dies automatisch für sie. Plattformen mit API-basiertem Onboarding müssen Anforderungsänderungen aktiv verfolgen und für jede Aktualisierung Engineering-Ressourcen bereitstellen. ## Übersicht der API-Integration Wenn Ihre Plattform API-basiertes Onboarding verwendet, müssen Sie Ihre Integration aktualisieren, um die folgenden Änderungen für verbundene Konten in Brasilien zu verarbeiten: - **KYC: Identitätsverifizierung für Einzelpersonen** – Erfassung von CPF, Geburtsdatum, Adresse und Lebenderkennung für alle Einzelkonten und Unternehmensvertreter/innen - **KYB: Identitätsverifizierung juristischer Personen** – Erfassung von CNPJ, dem rechtlichen Unternehmensnamen und der registrierten Adresse juristischer Personen; Handhabung der programmgesteuerten Verifizierung und der Dokumenten-Fallback-Abläufe - **Registrierungsstatus der Steueridentifikationsnummer** – Verarbeitung des Registrierungsstatus bei inaktiven oder ungültigen CPF- und CNPJ-Nummern - **UBO- und Beziehungsverifizierung** – Überprüfung, ob Geschäftsführer/innen oder Inhaber/innen rechtlich als solche eingetragen sind - **Finanzielle Kapazität** – Erfassung der monatlichen Einnahmen oder des Bruttoumsatzes aller brasilianischer Konten, bevor die Funktionen aktiviert werden können - **Neue Fehlercodes** – Verarbeitung neuer Verifizierungsfehlercodes im Array `requirements.errors` ## KYC: Identitätsverifizierung für Einzelpersonen Stripe stärkt die Identitätsverifizierung für Konten von Einzelpersonen in Brasilien, um die Anforderungen der brasilianischen Zentralbank (BCB) zu erfüllen. Verbundene Konten, bei denen es sich um Konten von Einzelpersonen handelt, sowie Vertreter/innen von Konten juristischer Personen müssen verifiziert werden – sie müssen möglicherweise im Rahmen des Onboardings zusätzliche Informationen angeben. Die folgenden Personen müssen überprüfbare KYC-Informationen bereitstellen: - **Unternehmensvertreter/innen**: Die Einzelperson, die die Allgemeinen Geschäftsbedingungen unterzeichnet und rechtlich für das Konto verantwortlich ist. - **Inhaber/innen**: Die Inhaber/innen juristischer Personen (sofern zutreffend). Stripe verwendet eine Kombination aus manuell eingegebenen Daten und Dokumentenprüfung, um die Identität aller Personen zu verifizieren. Darüber hinaus schreibt die brasilianische Regulierung eine Lebenderkennung (`proof_of_liveness`) vor, um zu bestätigen, dass die Person, die die Identitätsdokumente einreicht, physisch anwesend ist. Von Stripe gehostete und eingebettete Onboarding-Abläufe erledigen diesen Schritt automatisch. Wenn Ihre Plattform API-basiertes Onboarding verwendet, müssen Sie Nutzer/innen zu einem von Stripe gehosteten Verifizierungsschritt weiterleiten oder die eingebettete Komponente `` integrieren, um die Erfassung abzuschließen. Weitere Details finden Sie unter [Anforderungen an die Lebenderkennung verarbeiten](https://docs.stripe.com/connect/api-onboarding.md?accounts-namespace=v1&liveness=hosted#proof-of-liveness). **Altersanforderungen:** Unternehmensvertreter/innen müssen mindestens 18 Jahre alt sein. Inhaber/innen, Direktoren/Direktorinnen und leitende Angestellte müssen mindestens 16 Jahre alt sein. Für neue Nutzer/innen, die diese Anforderungen nicht erfüllen, werden keine Funktionen aktiviert. Bestehende Konten mit einem Unternehmensvertreter/einer Unternehmensvertreterin, der/die unter 16 Jahre alt ist, werden sofort bei der Migration der Plattform deaktiviert. ### Erforderliche Felder Für brasilianische Einzelkonten sind jetzt die folgenden Felder erforderlich: | Feld | Beschreibung | | ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | `person.first_name`, `person.last_name` | Vollständiger rechtsgültiger Name | | `person.id_number` | CPF (brasilianische Steueridentifikationsnummer für Einzelpersonen) | | `person.address.line1`, `.city`, `.postal_code`, `.country` | Brasilianische Wohnadresse. Alle Unternehmensvertreter/innen müssen in Brasilien ansässig sein und eine brasilianische Adresse angeben. | | `person.dob.day`, `.month`, `.year` | Geburtsdatum | | `person.verification.proof_of_liveness` | Selfie zur Lebenderkennung – Nur innerhalb von Stripe-gehosteten oder eingebetteten Abläufen unterstützt | | `person.verification.additional_document` | Optionale Dokumentenanforderung, wenn die Verifizierung der manuell eingegebenen Adresse fehlschlägt. | Es ist kein Feldname erforderlich, wenn Ihre Plattform bereits `person.id_number` erfasst. Stellen Sie sicher, dass Ihre Nutzeroberfläche speziell eine CPF erfasst – wir akzeptieren keine anderen ID-Typen (Reisepassnummern, ausländische Steueridentifikationsnummern) für brasilianische Konten. ### Erste Antwort auf Anforderungen Wenn ein neues Einzelkonto erstellt wird, enthält der Hash `requirements` Folgendes: ```json { "currently_due": [ "person.first_name", "person.last_name", "person.id_number", "person.dob.day", "person.dob.month", "person.dob.year", "person.address.line1", "person.address.city", "person.address.state", "person.address.country", "person.verification.proof_of_liveness" ], "pending_verification": [], "alternatives": [ { "original_fields_due": ["person.address.line1", "person.address.city", "person.address.state", "person.address.country"], "alternative_fields_due": ["person.verification.additional_document"] } ], "errors": [] } ``` ### Personendaten erfassen Verwenden Sie die Persons API, um individuelle Felder zu übermitteln: ```shell curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}}/persons/{{PERSON_ID}} \ -u "{{PLATFORM_SECRET_KEY}}:" \ -d "first_name=Maria" \ -d "last_name=Silva" \ -d "id_number=123.456.789-09" \ -d "dob[day]=15" \ -d "dob[month]=6" \ -d "dob[year]=1985" \ -d "address[line1]=Rua das Flores, 123" \ -d "address[city]=São Paulo" \ -d "address[state]=SP" \ -d "address[postal_code]=01310-100" \ -d "address[country]=BR" ``` ### Fehlerbehebung | Fehlercode | Auslöser | Sanierung | | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `verification_failed_id_number_inactive` | CPF gefunden, aber der Status ist inaktiv (zum Beispiel gesperrt, gelöscht, verstorben). | Der Nutzer/die Nutzerin muss den CPF-Status mit der brasilianischen Bundessteuerbehörde (Receita Federal) klären. Konten mit CPF-Status gelöscht, ungültig oder verstorben werden deaktiviert – dies kann nicht durch einen Dokumenten-Upload gelöst werden. | | `verification_failed_keyed_match` | Die CPF konnte weder in der programmgesteuerten Suche noch in der manuellen Prüfung verifiziert werden. | Der Nutzer/die Nutzerin reicht CPF und Ausweisdokument erneut ein; das Konto wird in die MVR-Warteschlange eingereiht. | | `verification_document_type_not_supported` | Das hochgeladene Dokument entspricht nicht dem angeforderten Typ, stammt aus dem falschen Land oder ist unleserlich. | Nutzer/in lädt einen akzeptablen behördlich ausgestellten brasilianischen Ausweis erneut hoch. | ## Identitätsverifizierung juristischer Personen für KYB Stripe aktualisiert die Anforderungen zur Unternehmensverifizierung für juristische Personen in Brasilien, um die AML-Vorschriften der brasilianischen Zentralbank (BCB) zu erfüllen. Diese Art der Verifizierung fällt in die übergeordnete Kategorie der Know-Your-Business-Anforderungen (KYB). Wenn Ihre verbundenen Konten Unternehmen umfassen, die in Brasilien eingetragen sind, müssen diese beim Onboarding möglicherweise zusätzliche Informationen angeben. Stripe verifiziert juristische Personen anhand der CNPJ (Cadastro Nacional da Pessoa Jurídica) – der nationalen Handelsregisternummer in Brasilien – sowie des Unternehmensnamens und der registrierten Adresse. Stripe versucht zunächst eine programmgesteuerte Verifizierung anhand des CNPJ-Registers der brasilianischen Regierung. Stimmen die eingegebenen Informationen nicht überein, kann das Konto die Anforderung durch das Hochladen eines Dokuments zur Verifizierung des Unternehmens (z. B. eines CNPJ-Zertifikats der Receita Federal) erfüllen. Zusätzlich zur Identitätsverifizierung verpflichten die brasilianischen AML-Vorschriften Stripe dazu, die finanzielle Leistungsfähigkeit eines verbundenen Kontos zu bewerten, bevor Zahlungen und Auszahlungen aktiviert werden. Alle brasilianischen Konten müssen ihren geschätzten monatlichen Umsatz oder ihr Einkommen angeben, bevor die Funktionen aktiviert werden. Diese Informationen dienen ausschließlich der regulatorischen Überwachung und werden beim Onboarding nicht eigenständig verifiziert. ### Erforderliche Felder Die folgenden Felder sind für Konten brasilianischer juristischer Personen erforderlich: | Feld | Beschreibung | | ----------------------------------------------------- | -------------------------------------------------------------------------------------------- | | `company.tax_id` | CNPJ (14-stellige brasilianische Handelsregisternummer). | | `company.name` | Rechtsgültiger Unternehmensname – muss mit dem CNPJ-Register übereinstimmen. | | `company.address.line1`, `.city`, `.postal_code` | Registrierte brasilianische Geschäftsadresse. | | `company.verification.document` | Zunächst optional; erst erforderlich, wenn die programmgesteuerte Verifizierung fehlschlägt. | | `business_profile.monthly_estimated_revenue.amount` | Monatlicher Bruttoumsatz in BRL. | | `business_profile.monthly_estimated_revenue.currency` | Muss `brl` lauten. | ### Erste Antwort auf Anforderungen ```json { "currently_due": [ "company.tax_id", "company.name", "company.address.line1", "company.address.city", "company.address.postal_code", "business_profile.monthly_estimated_revenue.amount", "business_profile.monthly_estimated_revenue.currency" ], "pending_verification": [], "alternatives": [ { "original_fields_due": [ "company.tax_id", "company.name", "company.address.line1", "company.address.city", "company.address.postal_code" ], "alternative_fields_due": [ "company.tax_id", "company.name", "company.address.line1", "company.address.city", "company.address.postal_code", "company.verification.document" ] } ], "errors": [] } ``` Das Array `alternatives` gibt an, dass die Plattform, wenn die programmgesteuerte CNPJ-Verifizierung fehlschlägt, dies durch die zusätzliche Angabe eines `company.verification.document` lösen kann. ### Unternehmensdaten erfassen ```shell curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}} \ -u "{{PLATFORM_SECRET_KEY}}:" \ -d "company[tax_id]=12.345.678/0001-99" \ -d "company[name]=Empresa Exemplo Ltda" \ -d "company[address][line1]=Avenida Paulista, 1000" \ -d "company[address][city]=São Paulo" \ -d "company[address][postal_code]=01310-100" \ -d "company[address][country]=BR" \ -d "business_profile[monthly_estimated_revenue][amount]=5000000" \ -d "business_profile[monthly_estimated_revenue][currency]=brl" ``` Nach dem Einreichen der Steueridentifikationsnummer, des Namens und der Adresse des Unternehmens wechseln die Anforderungen in den Status `pending_verification`, während Stripe die Daten mit dem CNPJ-Register verifiziert: ```json { "currently_due": [], "pending_verification": [ "company.tax_id", "company.name", "company.address.line1", "company.address.city", "company.address.postal_code" ], "alternatives": [], "errors": [] } ``` Warten Sie auf einen Webhook `account.updated`, bevor Sie fortfahren. Wenn die Verifizierung erfolgreich ist, werden alle Felder aus den Anforderungen entfernt. Wenn die Verifizierung fehlschlägt, lesen Sie den Abschnitt zur Fehlerbehandlung weiter unten. ### Registrierungsstatus der Steueridentifikationsnummer Zusätzlich zur Verifizierung der CNPJ anhand von Unternehmensdaten überprüft Stripe den Registrierungsstatus der CNPJ (und der CPF des Unternehmensvertreters/der Unternehmensvertreterin) anhand der brasilianischen Behördenunterlagen. Sie können die Steueridentifikationsnummer nicht mehr ändern, sobald Sie sie einmal festgelegt haben. | Typ der juristischen Person | Bestanden | Fehlgeschlagen | Sofortiges Offboarding erforderlich | | --------------------------- | ------------------------------------------------------------- | ------------------------------------ | -------------------------------------------------------------------------------------------------- | | Einzelpersonen (CPF) | Regulär | Gesperrt, Regularisierung ausstehend | Gelöscht, ungültig, verstorben | | Juristische Personen (CNPJ) | Aktiv (Ativa), Regularisierung ausstehend (Ativa não regular) | Gesperrt (Suspensa) | Aufgelöst (Baixada), gelöscht (Baixada), ungeeignet (Inapta), ungültig (Nula), im Ausland ansässig | Konten mit einer gesperrten CPF oder CNPJ werden beim Onboarding als gültig behandelt, müssen ihren Status jedoch innerhalb von etwa 30 Tagen bereinigen. Sollte keine Bereinigung erfolgen, werden die Zahlungsfunktionen eingeschränkt. Bei Konten mit einem Status, der ein Offboarding erfordert (gelöscht, ungültig, verstorben, aufgelöst, ungeeignet), werden alle Funktionen sofort deaktiviert und können auch nicht durch das Hochladen von Dokumenten behoben werden. ### Finanzielle Leistungsfähigkeit Die brasilianischen AML-Vorschriften verpflichten Stripe, die geschätzte finanzielle Leistungsfähigkeit eines verbundenen Kontos einzuziehen, bevor Zahlungen und Auszahlungen aktiviert werden. Dies gilt für alle brasilianischen Konten – sowohl für Einzelpersonen als auch für juristische Personen. `monthly_estimated_revenue.amount` wird in der kleinsten Währungseinheit (Centavos) angegeben. Beispiel: 50.000 BRL = `5000000`. Wir erfassen die Werte ausschließlich für die regulatorische Überwachung und verifizieren sie beim Onboarding nicht eigenständig. ### URL und Produktbeschreibung Die brasilianischen Vorschriften verpflichten Stripe dazu, die Aktivitäten aller Unternehmen nachzuvollziehen. Die Anforderungen variieren je nach Kontotyp: | Kontotyp | Anforderung | | ------------------- | --------------------------------------------------------------------------------------- | | Direkt und Standard | Erfordert sowohl `business_profile.url` als auch `business_profile.product_description` | | Custom und Express | Erfordert `business_profile.url` oder `business_profile.product_description` | ### Fehlerbehebung | Fehlercode | Auslöser | Sanierung | | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `verification_failed_keyed_match` | CNPJ nicht gefunden oder der Unternehmensname bzw. die Adresse stimmt nicht mit dem CNPJ-Register überein. | Geben Sie den korrekten rechtsgültigen Namen und die registrierte Adresse erneut ein, oder laden Sie `company.verification.document` hoch. | | `verification_failed_id_number_status_not_found` | CNPJ gefunden, aber der Steuerstatus konnte nicht abgerufen werden. | Erneut einreichen oder ein Dokument zur Verifizierung des Unternehmens hochladen. | | `verification_failed_id_number_inactive` | CNPJ gefunden, aber der Status ist inaktiv (z. B. gesperrt, aufgelöst). | Bei eine dem Status „Gesperrt“ erhält das Konto eine Kulanzfrist, um den Status bei der Receita Federal zu bereinigen. Bei dem Status „Aufgelöst“, „Gelöscht“, „Ungeeignet“ oder „Ungültig“ wird das Konto deaktiviert – dies lässt sich nicht durch das Hochladen von Dokumenten lösen. | | `verification_document_type_not_supported` | Das hochgeladene Unternehmensdokument ist unleserlich oder entspricht nicht dem erforderlichen Typ. | Laden Sie ein akzeptables Dokument zur Verifizierung des Unternehmens hoch. | | `verification_document_name_mismatch` | Der Unternehmensname im Dokument stimmt nicht mit dem eingegebenen Namen überein. | Geben Sie den rechtsgültigen Namen genau so ein, wie er auf dem CNPJ-Zertifikat erscheint. | | `verification_document_id_number_mismatch` | Die Steueridentifikationsnummer im Dokument stimmt nicht mit der eingegebenen CNPJ überein, oder der Status der Steueridentifikationsnummer wurde nicht gefunden bzw. ist inaktiv. | Laden Sie ein aktuelles CNPJ-Zertifikat der Receita Federal erneut hoch. | | `verification_document_address_mismatch` | Die Adresse im Dokument stimmt nicht mit der eingegebenen Adresse überein. | Geben Sie die Adresse erneut ein, sodass sie mit der registrierten Adresse im CNPJ-Zertifikat übereinstimmt. | ## UBO- und Beziehungsverifizierung Die brasilianische AML-Verordnung (Circular BCB 3978/20) schreibt vor, dass alle Unternehmensvertreter/innen als rechtlich eingetragene Vertreter/innen des Unternehmens identifiziert und verifiziert werden müssen. Stripe verifiziert dies in zwei Schritten: 1. **Programmgesteuerter Namensabgleich**: Der vollständige Name des Vertreters/der Vertreterin wird mit der Antwort des CNPJ-Registers abgeglichen. 1. **Fallback – Dokumentenprüfung**: Schlägt die programmgesteuerte Verifizierung fehl, muss der Vertreter/die Vertreterin ein akzeptables Beziehungsdokument (bei einfachen Eigentümerstrukturen) oder eine Bescheinigung (bei komplexen Eigentümerstrukturen) hochladen. > Eine einfache Eigentümerstruktur liegt vor, wenn das Unternehmen direkt von einer oder mehreren Einzelpersonen gehalten wird. Bei einer komplexen Eigentümerstruktur hingegen gibt es Zwischenebenen wie Holdinggesellschaften, Trusts oder Tochtergesellschaften, die zwischen dem operativen Geschäft und den wirtschaftlichen Eigentümern/Eigentümerinnen stehen. ### Akzeptable Beziehungsdokumente (für einfache Eigentümerstrukturen) Akzeptable Dokumente für Brasilien finden Sie unter [Akzeptable Verifizierungsdokumente](https://docs.stripe.com/acceptable-verification-documents.md?country=BR&document-type=entity#select-a-country-to-view-its-requirements). Dokumente müssen Folgendes enthalten: (a) den Namen der juristischen Person und die CNPJ, (b) eine ausdrückliche Ernennung als Inhaber/in oder Vorstand mit vollständigem Namen und CPF der Person sowie einem gültigen Mandat und © die Unterschrift des Unternehmensvertreters/der Unternehmensvertreterin. Plattformen können Verifizierungsdokumente im Auftrag verbundener Konten nur dann hochladen, wenn die Plattform die schriftliche Zustimmung des verbundenen Kontos erhalten hat, die von einem gesetzlichen Vertreter/einer gesetzlichen Vertreterin mit ausdrücklicher Handlungsvollmacht unterzeichnet wurde. Die Plattform muss außerdem eine Vollmacht oder ein Gründungsdokument einreichen, aus dem diese Vollmachten hervorgehen. ### Bescheinigung (für komplexe Eigentümerstrukturen) Unternehmen mit komplexen Eigentümerstrukturen müssen eine Bescheinigung als PDF-Dokument herunterladen und ausfüllen und es anschließend bei Stripe hochladen. ## Testen Verwenden Sie den [Test-Modus](https://docs.stripe.com/connect/testing.md), um zu überprüfen, ob Ihre Integration alle KYC/KYB-Status verarbeitet. ### Test: Erfolgreiche KYC-Prüfung (Einzelperson) ```shell # Create test account curl https://api.stripe.com/v1/accounts \ -u "{{TEST_SECRET_KEY}}:" \ -H "Stripe-Version: 2026-03-25.dahlia;experimental_onboarding_preview=v2" \ -d "type=custom" \ -d "country=BR" \ -d "capabilities[transfers][requested]=true" # Submit person data (use test CPF: 000.000.001-91 for success) curl https://api.stripe.com/v1/accounts/{{ACCT_ID}}/persons/{{PERSON_ID}} \ -u "{{TEST_SECRET_KEY}}:" \ -d "first_name=Maria" \ -d "last_name=Silva" \ -d "id_number=000.000.001-91" \ -d "dob[day]=15" \ -d "dob[month]=6" \ -d "dob[year]=1985" \ -d "address[line1]=Rua das Flores, 123" \ -d "address[city]=São Paulo" \ -d "address[state]=SP" \ -d "address[postal_code]=01310-100" \ -d "address[country]=BR" ``` Um den Test auf erfolgreiche KYC-Prüfung abzuschließen, ist weiterhin ein `proof_of_liveness` erforderlich. Weitere Informationen finden Sie unter [Anforderungen an die Lebenderkennung verwalten](https://docs.stripe.com/connect/api-onboarding.md?accounts-namespace=v1&liveness=hosted#proof-of-liveness). ### Test: CPF inaktiv (`verification_document_id_number_mismatch`) ```shell curl https://api.stripe.com/v1/accounts/{{ACCT_ID}}/persons/{{PERSON_ID}} \ -u "{{TEST_SECRET_KEY}}:" \ -d "id_number=000.000.002-00" ``` Erwarteter Fehler in den Anforderungen: ```json { "code": "verification_document_id_number_mismatch", "reason": "", "requirement": "person.id_number" } ``` ### Test: Erfolgreiche KYB-Prüfung (juristische Person) ```shell # Create test company account curl https://api.stripe.com/v1/accounts \ -u "{{TEST_SECRET_KEY}}:" \ -H "Stripe-Version: 2026-03-25.dahlia;experimental_onboarding_preview=v2" \ -d "type=custom" \ -d "country=BR" \ -d "business_type=company" \ -d "capabilities[transfers][requested]=true" # Submit company data (use test CNPJ: 00.000.000/0001-91 for success) curl https://api.stripe.com/v1/accounts/{{ACCT_ID}} \ -u "{{TEST_SECRET_KEY}}:" \ -d "company[tax_id]=00.000.000/0001-91" \ -d "company[name]=Empresa Teste Ltda" \ -d "company[address][line1]=Avenida Paulista, 1000" \ -d "company[address][city]=São Paulo" \ -d "company[address][postal_code]=01310-100" \ -d "company[address][country]=BR" \ -d "business_profile[monthly_estimated_revenue][amount]=5000000" \ -d "business_profile[monthly_estimated_revenue][currency]=brl" ``` ### Test: CNPJ-Abgleich fehlgeschlagen (`verification_failed_keyed_match`) ```shell curl https://api.stripe.com/v1/accounts/{{ACCT_ID}} \ -u "{{TEST_SECRET_KEY}}:" \ -d "company[tax_id]=00.000.000/0002-00" \ -d "company[name]=Wrong Name Ltda" ``` Erwartete Fehler in den Anforderungen: ```json [ { "code": "verification_failed_keyed_match", "requirement": "company.tax_id" }, { "code": "verification_failed_keyed_match", "requirement": "company.name" }, { "code": "verification_failed_keyed_match", "requirement": "company.address.line1" } ] ``` Beheben Sie den Fehler, indem Sie ein Dokument zur Verifizierung des Unternehmens hochladen: ```shell # 1. Upload CNPJ certificate PDF curl https://files.stripe.com/v1/files \ -u "{{TEST_SECRET_KEY}}:" \ -F "file=@/path/to/cnpj_certificate.pdf" \ -F "purpose=account_requirement" # 2. Attach to account curl https://api.stripe.com/v1/accounts/{{ACCT_ID}} \ -u "{{TEST_SECRET_KEY}}:" \ -d "company[verification][document][front]={{FILE_ID}}" ``` #### Programm - US *Letzte Aktualisierung: 23. September 2025* ## Was sich ändert - **Erforderliche Informationen, die von verbundenen Konten erfasst werden:** Wir aktualisieren die Informationen, die wir von Einzelunternehmen, gemeinnützigen Organisationen und Ein-Personen-LLC benötigen, und vereinfachen die Art und Weise, wie wir die Zustimmung von gesetzlichen Vertreterinnen und Vertretern für Konten einholen, die von Minderjährigen eröffnet wurden. Darüber hinaus ist jetzt für alle Arten von juristischen Personen eine E-Mail-Adresse für die/den Kontovertreter/in erforderlich und eine Änderung für staatliche Stellen und öffentliche Unternehmen. - **Verifizieren von Unternehmensinformationen und Bereitstellen detaillierter Verifizierungsantworten:** Wir aktualisieren unsere Kriterien für gültige Geschäftsinformationen und führen neue Verifizierungsfehlercodes ein für den Fall, dass wir die bereitgestellten Informationen nicht akzeptieren oder verifizieren können. - **Schwellenwert, ab dem wir Steueridentifikationsnummern (TIN) überprüfen:** Für verbundene Custom- und Express-Konten senken wir den Schwellenwert für das Zahlungsvolumen, bei dem wir TINs überprüfen, um sie an die aktuellen Schwellenwerte für die Steuerberichterstattung auf Bundesebene anzupassen. - **Vorausfüllung von Zahlungsbeschreibungen in der Abrechnung und deren Präfixe:** Wenn keine Zahlungsbeschreibung in der Abrechnung angegeben wurde, hat sich die Logik zur Vorabausfüllung dahingehend geändert, dass entweder der Profilname des Unternehmens, die Unternehmens-URL oder der Name der juristischen Person des verbundenen Kontos verwendet wird. Diese Änderungen betreffen alle Benutzer mit einer angeforderten [card_payments](https://docs.stripe.com/api/accounts/object.md#account_object-capabilities-card_payments)-Funktion in den USA. ## Erforderliche Informationen, die von verbundenen Konten erfasst werden Neue gesammelte Informationen und neue Felder zur API hinzugefügt: - Unternehmen, die [company.structure](https://docs.stripe.com/api/accounts/create.md#create_account-company-structure) von `sole_proprietorship` und `single_member_llc` sind, müssen ihre Geschäftsadresse („Firmenadresse“) angeben. Falls die Geschäftsadresse mit der Privatadresse des/der Verantwortlichen identisch ist, können Ihre verbundenen Konten für beide die gleichen Werte angeben. - Juristische Personen, bei denen es sich um eine [company.structure](https://docs.stripe.com/api/accounts/create.md#create_account-company-structure) von `government_instrumentality`, `tax_exempt_government_instrumentality`, `governmental_unit`, `public_company` und `public_corporation`, `public_partnership` handelt, müssen eine E-Mail-Adresse für den/die Kontovertreter/in angeben. Diese Anforderung gilt jetzt für alle Arten von juristischen Personen. - Um die Einholung der Zustimmung eines/einer Erziehungsberechtigten für von Minderjährigen eröffneten Konten zu vereinfachen, wurde die [Persons API](https://docs.stripe.com/api/persons.md) mit dem neuen Beziehungstyp `legal_guardian` sowie dem Feld `additional_tos_acceptances` aktualisiert, um die Zustimmung des/der Erziehungsberechtigten zu den Stripe-Nutzungsbedingungen zu erfassen. Wenn das Geburtsdatum des Kontovertreters/der Kontovertreterin zeigt, dass es sich bei der Einzelperson um eine/einen Minderjährigen handelt, wird eine Kontoanforderung ausgelöst, um einen `legal_guardian` hinzuzufügen, bevor das Konto aktiviert werden kann. ## Verifizieren von Unternehmensinformationen und Bereitstellen detaillierter Verifizierungsantworten ### Aktualisierungen der Informationen, die wir bereits erfassen Wir fordern die folgenden Informationen von Ihren verbundenen Konten an: | Feld | Aktualisierte Anforderungen | Weitere Überlegungen | | ------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | | SSN oder ITIN, die von in den USA ansässigen Verantwortlichen erfasst werden | Beim Onboarding sind für alle verbundenen Konten die letzten vier Ziffern erforderlich (einschließlich verbundener Konten der Typen Custom und Express) | Dies ist das aktuelle Verhalten für verbundene Standard-Konten | | SSN oder ITIN, erfasst von in den USA ansässigen Inhaber/innen | Letzte vier Ziffern erforderlich, sobald Zahlungsvolumen für alle Kontotypen (einschließlich verbundener Custom- und Express-Konten) 500.000 USD übersteigt | Siehe *Notiz vollständige 9-stellige SSN* unten | | Nationales Ausweis- oder Verifizierungsdokument, erfasst von nicht in den USA ansässigen Vertretern | Nationales Ausweis- oder Verifizierungsdokument beim Onboarding für alle Kontotypen (einschließlich verbundener Custom und Express Konten) | Gilt nur für nicht in den USA ansässige Vertreter/innen | | Nationales Ausweis- oder Verifizierungsdokument, erfasst von nicht in den USA ansässigen Inhaber/innen | Nationales Ausweis- oder Verifizierungsdokument, sobald das Zahlungsvolumen 500.000 USD für alle Kontotypen übersteigt (einschließlich verbundener Custom- und Express-Konten) | Gilt nur für nicht in den USA ansässige Inhaber/innen | > Wenn wir die vollständige neunstellige Sozialversicherungsnummer für eine mit Ihrem Konto verknüpfte Einzelperson anhand der bereits bereitgestellten Informationen nicht programmgesteuert abrufen können, müssen Sie die vollständigen neun Ziffern angeben. ### Neue Fehlercodes für Verifizierungen Wenn wir die von Ihren verbundenen Konten bereitgestellten Informationen nicht verifizieren können, zeigen wir detaillierte Verifizierungsantworten als neue Fehlercodes im Array [requirements.errors](https://docs.stripe.com/api/accounts/object.md#account_object-requirements-errors) des Accounts-Objekts ein. [Dokumentation anzeigen](https://docs.stripe.com/connect/handling-api-verification.md#validation-and-verification-errors). #### Synchrone Fehler | Feld | Neuer Fehlercode | Fehlermeldung | | ---------------------------------------------------- | ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Produktbeschreibung | `invalid_product_description_length` | Ihre Produktbeschreibung muss mindestens 10 Zeichen lang sein. | | Produktbeschreibung | `invalid_product_description_url_match` | Ihre Produktbeschreibung muss sich von Ihrer URL unterscheiden. | | Zahlungsbeschreibung in der Abrechnung (vollständig) | `invalid_statement_descriptor_length` | Ihre Zahlungsbeschreibung in der Abrechnung muss zwischen 5 und 22 Zeichen lang sein. | | Zahlungsbeschreibung in der Abrechnung (vollständig) | `invalid_statement_descriptor_business_mismatch` | Ihre Zahlungsbeschreibung in der Abrechnung muss Ihrem Unternehmensnamen, dem Namen Ihrer juristischen Person oder Ihrer URL ähneln. | | Zahlungsbeschreibung in der Abrechnung (vollständig) | `invalid_statement_descriptor_denylisted` | Allgemeine oder bekannte Zahlungsbeschreibungen in der Abrechnung werden nicht unterstützt. | | Zahlungsbeschreibung in der Abrechnung (kurz) | `invalid_statement_descriptor_prefix_mismatch` | Das Präfix der Zahlungsbeschreibung in der Abrechnung muss Ihrer Zahlungsbeschreibung, Ihrem Unternehmensnamen, dem Namen Ihrer juristischen Person oder Ihrer URL ähneln. | | Zahlungsbeschreibung in der Abrechnung (kurz) | `invalid_statement_descriptor_prefix_denylisted` | Allgemeine oder bekannte Präfixe von Zahlungsbeschreibungen in der Abrechnung werden nicht unterstützt. | | LE-Firmenname | `invalid_company_name_denylisted` | Allgemeine oder bekannte Firmennamen werden nicht unterstützt. | | Name des Unternehmensprofils (DBA) | `invalid_business_profile_name_denylisted` | Allgemeine oder bekannte Firmennamen werden nicht unterstützt. | | Name des Unternehmensprofils (DBA) | `invalid_business_profile_name` | Geschäftsprofilnamen müssen aus erkennbaren Wörtern bestehen. | | Geburtsdatum der Person | `invalid_dob_age_under_minimum` | Die Person muss mindestens 13 Jahre alt sein. | | Geburtsdatum der Person | `invalid_dob_age_over_maximum` | Das Geburtsdatum muss innerhalb der letzten 120 Jahren liegen. | | Telefonnummer der Person | `invalid_phone_number` | Die Telefonnummer scheint ungültig zu sein. Vergewissern Sie sich, dass Sie sie im richtigen Format angegeben haben. | | Geschäftliche LE-Telefonnummer | `invalid_phone_number` | Die Telefonnummer scheint ungültig zu sein. Vergewissern Sie sich, dass Sie sie im richtigen Format angegeben haben. | | TaxID des Unternehmens | `invalid_tax_id_format` | Die Steuer-IDs müssen aus einem eindeutigen Satz von 9 Ziffern ohne Bindestriche oder andere Sonderzeichen bestehen. | | URL | `invalid_url_format` | Verwenden Sie das Format https://example.com | | URL | `invalid_url_denylisted` | Allgemeine Unternehmens-URLs werden nicht unterstützt. | #### Asynchrone Fehler | Feld | Neuer Fehlercode | Fehlermeldung | | ---- | --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | URL | `invalid_url_website_inaccessible` | Wir konnten diese URL nicht aufrufen. Vergewissern Sie sich, dass sie verfügbar ist und richtig eingegeben wurde, oder geben Sie eine andere URL an. | | URL | `invalid_url_website_business_information_mismatch` | Die Unternehmensinformationen auf Ihrer Website müssen mit den Angaben übereinstimmen, die Sie gegenüber Stripe gemacht haben. | | URL | `invalid_url_website_incomplete` | Auf Ihrer Website scheinen einige erforderliche Informationen zu fehlen. Erfahren Sie mehr über die Anforderungen an Websites. | | URL | `invalid_url_website_other` | Wir konnten Ihr Unternehmen mit der von Ihnen angegebenen URL nicht verifizieren. Stellen Sie sicher, dass sie korrekt eingegeben wurde, oder geben Sie eine andere URL an. | | URL | `invalid_url_web_presence_detected` | Da Sie eine Website, eine App, eine Social-Media-Seite oder ein Online-Profil verwenden, um Produkte oder Dienstleistungen zu verkaufen, müssen Sie eine URL Ihres Unternehmens angeben. | ### Aktualisierung des Schwellenwerts, ab dem wir Steueridentifikationsnummern (TINs) überprüfen Zur Angleichung an die IRS-Meldeschwellen für die Formulare 1099-K, 1099-NEC und 1099-MISC aktualisieren wir den Schwellenwert, ab dem wir die TIN überprüfen, auf den Zeitpunkt, an dem Ihr Zahlungsvolumen 600 USD erreicht, oder innerhalb von 30 Tagen nach der ersten Zahlung, je nachdem, was zuerst eintritt. ### So werden Zahlungsbeschreibungen in der Abrechnung und deren Präfixe vorausgefüllt Sofern nicht angegeben, wird die Zahlungsbeschreibung in der Abrechnung mit den folgenden bereitgestellten Feldern vorausgefüllt (in dieser Reihenfolge): [business_profile.name](https://docs.stripe.com/api/accounts/object.md#account_object-business_profile-name) (“doing business as”), [business_profile.url](https://docs.stripe.com/api/accounts/object.md#account_object-business_profile-url), der Name der juristischen Person (entweder [individual.first_name](https://docs.stripe.com/api/accounts/object.md#account_object-individual-first_name) + [individual.last_name](https://docs.stripe.com/api/accounts/object.md#account_object-individual-last_name) oder [company.name](https://docs.stripe.com/api/accounts/object.md#account_object-company-name))`. Wenn das Präfix der Zahlungsbeschreibung nicht angegeben ist, wird es mit den ersten 10 Zeichen der Zahlungsbeschreibung vorausgefüllt. #### Programm - Singapore *Letzte Aktualisierung: 21. Mai 2025* ## Empfehlungen für die Integration Welche Änderungen Sie an der Integration vornehmen müssen, hängt davon ab, wie Sie die Onboarding-Informationen von Ihren verbundenen Konten einholen. Planen Sie auch die Aktualisierung Ihrer internen und externen Dokumentation zu den Verifizierungsanforderungen und schulen Sie Ihre Support-Teams, um etwaige Fragen Ihrer Nutzer/innen zu beantworten. > Stripe empfiehlt dringend, zum Erfassen von Unternehmensinformationen und Informationen zur Identitätsprüfung [von Stripe gehostetes](https://docs.stripe.com/connect/hosted-onboarding.md) oder [eingebettetes Onboarding](https://docs.stripe.com/connect/embedded-onboarding.md) zu verwenden. Von Stripe gehostetes und eingebettetes Onboarding bietet eine geführte Erfahrung mit zusätzlichen Informationen über wirtschaftliche Eigentümer/innen und Vorstandsmitglieder, die derzeit in der API nicht verfügbar sind. Diese Informationen werden aus staatlichen Datenbanken abgerufen und reduzieren die von verbundenen Konten erfassten Verifizierungsinformationen. ### Integrationsübersicht Ab Mitte März können Sie mit dem [future_requirements](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements)-Hash eine Vorschau auf anstehende neue Anforderungen und deren Frist für Ihre verbundenen Konten anzeigen. Sie können Unterbrechungen der Funktionen Ihrer verbundenen Konten vermeiden, indem Sie vor `current_deadline` die Erfassung aktualisierter Informationen planen. Neue verbundene Custom-Konten, die ab April 2025 erstellt werden, müssen ebenfalls die neuen Verifizierungsanforderungen erfüllen. Erkennen Sie Änderungen des Kontostatus, indem Sie das Ereignis account.updated überwachen. Auf unserer [FAQ-Seite](https://support.stripe.com/questions/singapore-verification-requirements-for-custom-connected-accounts-faq) finden Sie weitere Informationen zu den Zeitplänen. Achten Sie darauf, dass Ihre Integration so eingerichtet ist, dass [Verifizierungsaktualisierungen](https://docs.stripe.com/connect/handle-verification-updates.md) beim Onboarding neuer Konten und beim Erfassen aktualisierter Informationen von bestehenden Konten verarbeitet werden können. Insbesondere bei eingebetteten oder von Stripe gehosteten Onboarding-Abläufen können Sie das Verhalten so anpassen, dass optional [future_requirements](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements) im Voraus erfasst werden. Legen Sie für von Stripe gehostetes Onboarding den `collection_options.future_requirements`-Parameter beim [Erstellen eines Kontolinks](https://docs.stripe.com/api/account_links/create.md#create_account_link-collection_options) auf `include` fest. Legen Sie für das eingebettete Onboarding das Feld „futureRequirements“ des [`collectionOptions`](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md#requirements-collection-options)-Attributs auf `include` fest. ### Übersicht über die Anforderungen | Typ der juristischen Person | Verifizierung der letztendlichen wirtschaftlichen Berechtigten (UBO) | Angaben zur Unternehmensleitung einholen | Befugnisnachweis (PoA) | Vollmachtsschreiben | | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ---------------------- | --------------------------------- | | Einzelpersonen | Trifft nicht zu | Trifft nicht zu | Trifft nicht zu | Trifft nicht zu | | Einzelunternehmen | Trifft nicht zu | Trifft nicht zu | Gilt immer | Trifft nicht zu | | Private Unternehmen | Erforderlich für Inhaber/innen mit 25 % oder mehr Beteiligung* Ausnahme kann gewährt werden | Gilt immer | Gilt immer | Alternative, wenn PoA fehlschlägt | | Partnerschaften | Für alle Partner/innen und Manager/innen und jede andere Person mit einer Beteiligung von 25 % oder mehr erforderlich Ausnahme kann gewährt werden | Trifft nicht zu | Gilt immer | Alternative, wenn PoA fehlschlägt | | Regierungsstellen** | Trifft nicht zu | Trifft nicht zu | Gilt immer | Gilt immer | | Öffentliche Unternehmen** | Befreit | Gilt immer | Gilt immer | Alternative, wenn PoA fehlschlägt | | Gemeinnützige Organisationen | Alle Vorstandsmitglieder und Führungskräfte in Schlüsselpositionen Ausnahme kann gewährt werden | Trifft nicht zu | Gilt immer*** | Alternative, wenn PoA fehlschlägt | > In Fällen, in denen es keine Eigentümer/innen gibt, die 25 % oder mehr besitzen, werden alle Vorstandsmitglieder als wirtschaftliche Eigentümer/innen behandelt. > > \** Staatliche Einrichtungen und öffentliche Unternehmen sind neue Unternehmenstypen in Singapur. Kontaktieren Sie den [Stripe-Support](https://support.stripe.com/), um Zugriff anzufordern. > > \*** Gemeinnützige Organisationen, die nicht auf charities.gov.sg aufgeführt sind, müssen ein [proof_of_ultimate_beneficial_ownership](https://docs.stripe.com/api/accounts/update.md#update_account-documents-proof_of_ultimate_beneficial_ownership)-Dokument hochladen, in dem alle Direktoren und Führungskräfte in Schlüsselpositionen angegeben sind. ## Unterstützte Unternehmenstypen und -strukturen Je nach Unternehmenstyp haben Sie unterschiedliche Verifizierungsanforderungen. Beim Unternehmenstyp `company` können Sie das Unternehmen Ihrer Nutzerin/Ihres Nutzers weitergehend klassifizieren, indem Sie die rechtliche (Unternehmens-)Struktur bestimmen. Eine Unternehmensstruktur beschreibt die Einzelheiten einer Geschäftseinheit, zum Beispiel das Tagesgeschäft, steuerliche Belastungen, die Haftung und Organisationsformen. Sie können sie mithilfe des Felds [company.structure](https://docs.stripe.com/api/accounts/create.md#create_account-company-structure) im Account-Objekt klassifizieren. Ein Unternehmen wird standardmäßig als privat betrachtet, wenn keine Informationen zu [company.structure](https://docs.stripe.com/api/accounts/create.md#create_account-company-structure) angegeben werden. In Übereinstimmung mit den Richtlinien von Singapur müssen alle Unternehmensarten auf [ACRA](https://www.acra.gov.sg/) registriert sein. Dies sind die vorgeschlagenen Zuordnungen für den Übergang von der `business_type`-only-Klassifizierung zu [business_type](https://docs.stripe.com/api/accounts/object.md#account_object-business_type) und [company.structure](https://docs.stripe.com/api/accounts/create.md#create_account-company-structure). | Bestehender Unternehmenstyp | Kombination aus neuem Unternehmenstyp und Unternehmensstruktur | Beschreibung | | --------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `individual` | Typ: `individual`, Struktur: `nil` | Eine einzelne Person, die einer Geschäftstätigkeit nachgeht, aber nicht in einer Unternehmensstruktur tätig ist. | | `sole_prop` | Typ: `company`, Struktur: `sole_proprietorship` | Unternehmen ohne Rechtspersönlichkeit, die einer Einzelperson gehören. Das Unternehmen ist als Einzelunternehmen auf [ACRA](https://www.acra.gov.sg/how-to-guides/before-you-start/choosing-a-business-structure) registriert. | | `company` / `corporation` | Typ: `company`, Struktur: `private_company` | Eine Verbindung oder Beziehung zwischen zwei oder mehr Einzelpersonen, Corporations (Aktiengesellschaften), Trusts oder Personengesellschaften, die sich zusammenschließen, um ein Gewerbe oder ein Geschäft zu betreiben. Das Unternehmen ist als Unternehmen auf [ACRA](https://www.acra.gov.sg/how-to-guides/before-you-start/choosing-a-business-structure) registriert, einschließlich Gesellschaften mit beschränkter Haftung. | | `partnership` | Typ: `company`, Struktur: `private_partnership` | Eine Verbindung oder Beziehung zwischen zwei oder mehr Einzelpersonen, Corporations (Aktiengesellschaften), Trusts oder Personengesellschaften, die sich zusammenschließen, um ein Gewerbe oder ein Geschäft zu betreiben. Das Unternehmen ist bei [ACRA](https://www.acra.gov.sg/how-to-guides/before-you-start/choosing-a-business-structure) als Personengesellschaft registriert. | | `public_company` | Typ: `company`, Struktur: `public_company` | Ein Unternehmen, das seine Wertpapiere einer breiten Öffentlichkeit zum Kauf anbietet. Diese Unternehmensstruktur ist eingeschränkt. Wenden Sie sich an den [Stripe-Support](https://support.stripe.com/), um weitere Informationen zu ihrer Verwendung zu erhalten. Das Unternehmen ist bei [ACRA](https://www.acra.gov.sg/how-to-guides/before-you-start/choosing-a-business-structure) als Unternehmen registriert. | | `non_profit` | Typ: `non_profit`, Struktur: `nil` | Eine Organisation, die zu einem anderen Zweck als der Erzielung von Gewinnen tätig ist, häufig mit dem Ziel, soziale, pädagogische, karitative oder andere gemeinschaftliche Ziele zu fördern. | > Wenn es sich bei dem Unternehmen um eine gemeinnützige Organisation handelt, die bei ACRA registriert ist, gelten die Anforderungen für den bei ACRA registrierten Unternehmenstyp. ## Verifizierung der Unternehmensvertretung ### Verbesserte Identitätsprüfung In Singapur ist für alle Unternehmenstypen eine erweiterte Identitätsprüfung mit [Singpass MyInfo](https://www.singpass.gov.sg/main/individuals/), einem beliebten Anbieter digitaler Identitäten, erforderlich. Wenn die Nutzer/innen keinen Zugriff auf Myinfo haben, müssen sie ihre Identität mit [Stripe Identity](https://docs.stripe.com/identity.md) verifizieren. Für den erfolgreichen Abschluss der erweiterten Identitätsverifizierung mit SingPass MyInfo oder Stripe Identity ist eine Integration mit [Connect Onboarding oder Embedded Onboarding](https://docs.stripe.com/connect/custom/onboarding.md) erforderlich. Wenn Sie die Stripe-API für das Onboarding von verbundenen Konten verwenden, müssen Sie Ihre Formulare aktualisieren, um die neuen erforderlichen Verifizierungsinformationen von Ihren Nutzern/Nutzerinnen einzuholen, und sie im letzten Schritt an Connect Onboarding weiterleiten, um bei Bedarf die erweiterte Identitätsprüfung durchzuführen. ### Verifizierung der Adresse Für alle Unternehmen ist die Verifizierung der Adresse des Unternehmensvertreters/der Unternehmensvertreterin erforderlich. Wenn Stripe die Adresse nicht verifizieren kann, müssen Sie einen [Adressnachweis](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=address) einholen. ## Nachweis der Verifizierung der Autorität Stripe muss überprüfen, ob der/die [Kontovertreter/in über ausreichende Befugnisse](https://support.stripe.com/questions/representative-authority-verification) verfügt, um ein Konto im Namen der juristischen Person zu eröffnen. Wenn wir dies nicht programmgesteuert überprüfen können, müssen Sie den/die Vertreter/in durch eine Person mit ausreichenden Befugnissen ersetzen. Wenn eine Person mit ausreichenden Befugnissen nicht der/die Unternehmensvertreter/in sein kann, können Sie diese Person mit der Position [„Autorisierer/in“](https://docs.stripe.com/api/persons/update.md#update_person-relationship-authorizer) hinzufügen. Das Unternehmen muss dann ein von dem/der [Autorisierer/in](https://docs.stripe.com/api/persons/update.md#update_person-relationship-authorizer) unterzeichnetes [Autorisierungsschreiben](https://b.stripecdn.com/content/Letter_of_authorization_for_Stripe_Singapore.pdf) vorlegen, das es dem/der Unternehmensvertreter/in gestattet, das Konto zu verwalten. Diese muss als [company_authorization](https://docs.stripe.com/api/persons/update.md#update_person-documents-company_authorization) des Vertreters/der Vertreterin angegeben werden. Sie müssen dem Konto den [Vor-](https://docs.stripe.com/api/persons/object.md#person_object-first_name) und [Nachnamen](https://docs.stripe.com/api/persons/object.md#person_object-last_name) der genehmigenden Person sowie eine Kopie ihres [Ausweisdokuments](https://docs.stripe.com/api/persons/update.md#update_person-verification-document) hinzufügen. > Stripe akzeptiert derzeit nur die bereitgestellte Vorlage für ein [Autorisierungsschreiben](https://b.stripecdn.com/content/Letter_of_authorization_for_Stripe_Singapore.pdf). ``` { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "future_requirements": { "past_due": [ "authorizer.first_name", "authorizer.last_name", "authorizer.id_document", "{{REPRESENTATIVE_ID}}.documents.company_authorization.files" ], "alternatives": [ { "original_fields_due": [ "authorizer.first_name", "authorizer.last_name", "authorizer.id_document", "{{REPRESENTATIVE_ID}}.documents.company_authorization.files" ], "alternative_fields_due": [ "{{REPRESENTATIVE_ID}}.first_name", "{{REPRESENTATIVE_ID}}.last_name", "{{REPRESENTATIVE_ID}}.id_number" ] } ], "errors": [ { "code": "verification_failed_representative_authority", "requirement": "authorizer.first_name", "reason": "..." }, { "code": "verification_failed_representative_authority", "requirement": "authorizer.last_name", "reason": "..." }, ... ], ... }, ... } ``` Darüber hinaus kann die Anforderung des Autorisierungsbriefs dokumentbezogene Fehler wie `verification_document_name_mismatch` oder `verification_document_type_not_supported` anzeigen. Stellen Sie sicher, dass Sie mit [Dokumentverifizierungsfehlern](https://docs.stripe.com/connect/handling-api-verification.md#handle-document-verification-problems) und den [Fehlercodes „Neue Verifizierungsfehler“](https://docs.stripe.com/connect/upcoming-requirements-updates.md#new-verification-error-codes) umgehen können. ## Verifizierung der juristische Person Für alle Unternehmen ist eine Verifizierung des Firmennamens, der UEN und der Art der juristischen Person erforderlich. Wenn Stripe die Existenz des Unternehmens nicht verifizieren kann, müssen Sie ein Unternehmensdokument einholen. Stripe muss auch überprüfen, ob der Unternehmenstyp und die Unternehmensstruktur mit den Aufzeichnungen der lokalen Regierung übereinstimmen. Wenn der [Unternehmenstyp](https://docs.stripe.com/api/accounts/object.md#account_object-company-structure) oder die [Unternehmensstruktur](https://docs.stripe.com/api/accounts/object.md#account_object-business_type) nicht übereinstimmen, wird ein `verification_legal_entity_structure_mismatch`-Fehler generiert, und der Unternehmenstyp oder die Unternehmensstruktur muss aktualisiert werden, oder es wird ein Unternehmensdokument benötigt, um die juristische Person zu verifizieren. ``` { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "future_requirements": { "past_due": [ "company.verification.document" ], "errors": [ { "code": "verification_legal_entity_structure_mismatch", "requirement": "company.verification.document", "reason": "Business type or structure seems to be incorrect. Provide the correct business type and structure for this account." }, ... ], ... }, ... } ``` ## Verifizierung der letztendlichen wirtschaftlichen Eigentümerschaft ### Ermitteln von Inhaberinnen/Inhabern basierend auf dem Entitätstyp #### Private Unternehmen Stripe definiert jede Person mit einem Anteil von 25 % oder mehr als letztendlich wirtschaftlich Berechtigte/n (UBO) und versucht, alle diese Personen zu identifizieren. Wir empfehlen, das [von Stripe gehostete](https://docs.stripe.com/connect/hosted-onboarding.md) oder [eingebettete Onboarding](https://docs.stripe.com/connect/embedded-onboarding.md) zu verwenden, damit Ihre Nutzer/innen eine Vorschau anzeigen und die Inhaber/innen bestätigen können. Alternativ können Sie alle UBOs erfassen und dem Konto mithilfe der [Inhaberposition](https://docs.stripe.com/api/persons/object.md) in der API hinzufügen. Wenn Stripe diese Personen nicht ermitteln kann, muss ein Unternehmen einen [Nachweis über das letztendliche wirtschaftliche](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship) Eigentum einreichen, um seine Eigentumsstruktur zu bescheinigen. Dies muss Eigentumsnachweise für alle Holdinggesellschaften umfassen, die 25 % oder mehr Anteile an dem verbundenen Konto besitzen. Das von Stripe gehostete oder eingebettete Onboarding versucht automatisch, diese Dokumente zu erfassen, oder Sie können sie mithilfe der v1/accounts API erfassen und übermitteln. Sie müssen alle wirtschaftlich Berechtigten des Kontos hinzufügen, die auf dem Nachweis des letztendlichen wirtschaftlichen Eigentums aufgeführt sind. > Verbundene Konten können eine einzige Bescheinigung [letztendlich wirtschaftliche Berechtigung](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship) als Alternative zu einem Dokument für das Unternehmen und einem weiteren für jedes Holdingunternehmen mit signifikanten Beteiligungen einreichen. > > Wenn keine der Eigentümer/innen 25 % oder mehr des Unternehmens besitzen, gelten alle Vorstandsmitglieder, die in behördlichen Aufzeichnungen aufgeführt sind (und für eine Vorschau auf von Stripe gehostetem oder eingebettetem Onboarding verfügbar sind), als UBOs und müssen dem Konto hinzugefügt werden. #### Partnerschaften Partnerschaften müssen die Beziehung zwischen dem Unternehmen und allen Partnern, Managern und allen anderen Personen, die mindestens 25 % der Anteile besitzen, verifizieren. Diese Personen müssen dem Konto mit der [Inhaberposition](https://docs.stripe.com/api/persons/object.md#person_object-relationship-owner) in der API hinzugefügt werden. #### Gemeinnützige Organisationen Bei gemeinnützigen Organisationen gelten alle wichtigen Führungskräfte und Direktoren als letztendlich wirtschaftliche Berechtigte (Ultimate Beneficial Owners). Dies umfasst: - Präsident/in - Direktor/in - CEO - Schatzmeister - Sekretär/in oder Generalsekretär/in - Vorsitzender - Treuhänder/in - Neu hinzugefügte Positionen - Und jede dieser Positionen in einer Assistenten-, Stellvertreter- oder Vizefunktion. Stripe versucht, alle Vorstandsmitglieder und Führungskräfte von in Singapur registrierten Wohltätigkeitsorganisationen zu identifizieren, was auf von Stripe gehostetem oder eingebettetem Onboarding in der Vorschau angezeigt und bestätigt werden kann. Alle anderen gemeinnützigen Organisationen müssen einen [Nachweis über das letztendliche wirtschaftliche Eigentum](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship) erbringen und die aufgeführten Personen müssen dem Konto mit der [Vorstandsposition](https://docs.stripe.com/api/persons/object.md#person_object-relationship-director) in der API hinzugefügt werden. ### Integrationsdetails [Vorname](https://docs.stripe.com/api/persons/object.md#person_object-first_name), [Nachname](https://docs.stripe.com/api/persons/object.md#person_object-last_name), [ID-Nummer](https://docs.stripe.com/api/persons/update.md#update_person-id_number) und [Aliasnamen](https://docs.stripe.com/api/persons/object.md#person_object-full_name_aliases) aller natürlichen Personen, die letztlich die juristische Person besitzen oder verwalten, müssen dem Konto mit der Position des [Inhabers/der Inhaberin](https://docs.stripe.com/api/persons/object.md#person_object-relationship-owner) oder [Geschäftsführers/Geschäftsführerin](https://docs.stripe.com/api/persons/object.md#person_object-relationship-director) in der API hinzugefügt werden. UBOs werden je nach Unternehmenstyp unterschiedlich definiert. Die Verifizierung der wirtschaftlichen Eigentümerschaft ist für private Unternehmen, Personengesellschaften und gemeinnützige Organisationen erforderlich. Wenn wir den/die wirtschaftliche/n Eigentümer/in nicht erfolgreich verifizieren können, müssen Sie ein [Ausweisdokument](https://docs.stripe.com/api/persons/update.md#update_person-verification-document) für den/die nicht verifizierte/n wirtschaftliche/n Eigentümer/in einholen. ``` { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "future_requirements": { "past_due": [ "{{REPRESENTATIVE_ID}}.verification.document" ], "errors": [ { "code": "verification_failed_keyed_identity", "requirement": "{{REPRESENTATIVE_ID}}.verification.document", "reason": "..." }, ... ], ... }, ... } ``` Wenn Stripe feststellt, dass in dem Konto Eigentümer/innen, Geschäftsführer/innen oder Unterlagen von Holdinggesellschaften fehlen, wird das `documents.proof_of_ultimate_beneficial_ownership.files`-Feld in [future_requirements](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements) zurückgegeben. Eine vollständige Liste der akzeptierten Dokumente für Singapur finden Sie unter [Akzeptierte Verifizierungsdokumente](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship). Das von Stripe gehostete und eingebettete Onboarding zeigt eine Liste der fehlenden [Eigentümer/innen](https://docs.stripe.com/api/persons/object.md#person_object-relationship-owner) und [Geschäftsführer/innen](https://docs.stripe.com/api/persons/object.md#person_object-relationship-director) an, sodass der/die Nutzer/in sie durch Anklicken zu seinem/ihrem Konto hinzufügen kann. Durch das Hinzufügen der vorgeschlagenen Personen wird die UBO-Anforderung für Unternehmen ohne Holdinggesellschaften in ihrer Eigentümerstruktur erfüllt. Bei Unternehmen mit Holdinggesellschaften versucht Stripe, die Inhaber/innen zu verifizieren. Wenn das nicht möglich ist, werden die Nutzer/innen aufgefordert, entweder eine [Bescheinigung über die letztendliche wirtschaftliche Eigentümerschaft](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship) oder relevante [Eigentumsdokumente](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship) hochzuladen, um die endgültigen wirtschaftlichen Eigentümer/innen des Kontos zu ermitteln. (Dies gilt auch für andere Unternehmensformen, zum Beispiel gemeinnützige Organisationen.) Konten mit fehlenden wirtschaftlichen Eigentümern/Eigentümerinnen weisen einen `verification_missing_owners`-Fehlercode im Fehler-Hash der [future_requirements](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements-errors) auf. Auf ähnliche Weise wird für Konten mit fehlenden Geschäftsführer/innen ein `verification_document_directors_mismatch`-Fehlercode angezeigt. Schließlich weisen Konten, für die Stripe zusätzliche Informationen zu ihrer Eigentümerschaft benötigt, einen `verification_requires_additional_proof_of_registration`-Fehlercode auf. ``` { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "future_requirements": { "past_due": [ "documents.proof_of_ultimate_beneficial_ownership.files", ], "errors": [ { "code": "verification_missing_owners", "requirement": "documents.proof_of_ultimate_beneficial_ownership.files", "reason": "..." }, ... ], ... }, ... } ``` ### Ausnahmen Unter bestimmten Umständen muss eine Geschäftseinheit möglicherweise keine Angaben zur Eigentümerschaft machen. Um sich für eine Ausnahme zu qualifizieren, muss im Feld [company.ownership_exemption_reason](https://docs.stripe.com/api/accounts/update.md#update_account-company-ownership_exemption_reason) ein gültiger Grund angegeben werden. Gültige Gründe für eine Ausnahmen sind unter anderem: - `qualified_entity_exceeds_ownership_threshold`: Wenn eine Regierung, ein börsennotiertes Unternehmen oder ein Finanzinstitut mindestens 75 % des Unternehmens besitzt, muss das Unternehmen keine Angaben zu den Eigentumsverhältnissen machen. - `qualifies_as_financial_institution`: Unternehmen, bei denen es sich um Finanzinstitute handelt, die [der Aufsicht der Währungsbehörde von Singapur](https://eservices.mas.gov.sg/fid/institution?sector=Banking&category=Finance%20Company) unterliegen, müssen keine Eigentumsdaten weitergeben. ``` { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "future_requirements": { "past_due": [ "documents.proof_of_ultimate_beneficial_ownership.files", ], "alternatives": [ { "original_fields_due": [ "documents.proof_of_ultimate_beneficial_ownership.files", ], "alternative_fields_due": [ "company.ownership_exemption_reason", ] } ], ... }, ... } ``` Nachdem Sie einen Ausnahmegrund eingereicht haben, prüfen wir die Angaben der Geschäftseinheit. Während dieser Überprüfung wird die Anforderung in [future_requirements.pending_verification](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements-pending_verification) verschoben. Wenn Stripe feststellt, dass die Geschäftseinheit nicht für die Ausnahme infrage kommt, zeigen wir eine Fehlermeldung an und die Eigentumsanforderung bleibt bestehen: ``` { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "future_requirements": { "past_due": [ "documents.proof_of_ultimate_beneficial_ownership.files", ], "alternatives": [ { "original_fields_due": [ "documents.proof_of_ultimate_beneficial_ownership.files", ], "alternative_fields_due": [ "company.ownership_exemption_reason", ] } ], "errors": [ { "code": "verification_rejected_ownership_exemption_reason", "reason": "The ownership exemption reason was rejected.", "requirement": "company.ownership_exemption_reason" } ], ... }, ... } ``` ## Angaben zur Unternehmensleitung einholen Sie müssen die [Vornamen](https://docs.stripe.com/api/persons/update.md#update_person-id_number), [Nachnamen](https://docs.stripe.com/api/persons/object.md#person_object-last_name), [ID-Nummern](https://docs.stripe.com/api/persons/object.md#person_object-first_name) und [Aliasnamen](https://docs.stripe.com/api/persons/object.md#person_object-full_name_aliases) aller [Geschäftsführer/innen](https://docs.stripe.com/api/persons/object.md#person_object-relationship-director) erfassen und übermitteln, die in den behördlichen Registrierungsunterlagen des verbundenen Kontos aufgeführt sind, für private Unternehmen, börsennotierte Unternehmen und gemeinnützige Organisationen. Außerdem könnten Sie aufgefordert werden, zu bestätigen, dass die Liste der Geschäftsführer/innen aktuell und korrekt ist, indem Sie die Felder `company.directorship_declaration.ip`, `company.directorship_declaration.date` und optional die Felder `company.directorship_declaration.user_agent` in der API festlegen. Wenn eine Abweichung in der Ihrer Liste der Geschäftsführer/innen festgestellt wird, fordert Stripe möglicherweise eine neue Erklärung an, indem Sie die Anforderungen `company.directorship_declaration.ip`, `company.directorship_declaration.date` im Anforderungsfeld zurückgeben. ## Neue Fehlercodes für Verifizierungen Wenn Stripe die von Ihren verbundenen Konten bereitgestellten Informationen nicht verifizieren kann, werden Details der Verifizierungsantworten als neue Fehlercodes in das [requirements.errors-Array](https://docs.stripe.com/api/accounts/object.md#account_object-requirements-errors) des Accounts-Objekts aufgenommen. Mit der API-Version vom [31.03.2025](https://docs.stripe.com/upgrades.md#2025-03-31) werden die folgenden Fehlercodes eingeführt. Bei früheren API-Versionen wird stattdessen der Code `verification_failed_other` zurückgegeben. Alternativ können Sie Ihrer API-Integration einen Beta-Header hinzufügen, der die neuen Fehlercodes bereitstellt, ohne dass Sie Ihre API-Version ändern müssen. Wenden Sie sich an den [Stripe-Support](https://support.stripe.com/), um Zugriff auf diesen Beta-Header zu erhalten. | Fehlercode | Fehlerbeschreibung | | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `verification_legal_entity_structure_mismatch` | Der Unternehmenstyp oder die Unternehmensstruktur scheint inkorrekt. Geben Sie den korrekten Unternehmenstyp und die korrekte Unternehmensstruktur für dieses Konto an. | | `verification_failed_representative_authority` | Wir konnten die Befugnis des Kontovertreters/der Kontovertreterin nicht verifizieren. Fügen Sie dem Konto eine autorisierende Person hinzu und legen Sie ein von dieser Person unterzeichnetes Autorisierungsschreiben vor. Weitere Informationen finden Sie in unserem Support-Artikel zur [Verifizierung der Vertreterautorität](https://support.stripe.com/questions/representative-authority-verification). | | `verification_failed_authorizer_authority` | Wir konnten die Befugnis der angegebenen autorisierenden Person nicht verifizieren. Bitte ändern Sie die autorisierende Person in jemanden, der/die als Bevollmächtigte/r registriert ist. Weitere Informationen finden Sie in unserem Support-Artikel zur [Verifizierung der Vertreterautorität](https://support.stripe.com/questions/representative-authority-verification). | | `verification_rejected_ownership_exemption_reason` | Der Grund für die Ausnahme der Eigentümerschaft wurde abgelehnt. Wählen Sie einen anderen Ausnahmegrund aus oder laden Sie stattdessen einen Nachweis der letztendlichen wirtschaftlich Berechtigten hoch. | | `information_missing` | Sehen Sie sich die Fehlermeldung an, um zu verstehen, welche Informationen im Dokument oder in den eingegebenen Daten fehlten. Sofern es sich um Holdinggesellschaften mit einem erheblichem Anteil handelt, enthält der Fehlercode auch die fehlenden Holding-Unternehmen, die wir identifiziert haben. Weitere Informationen finden Sie im Support-Artikel zur [Verifizierung der wirtschaftlichen Eigentümerschaft für Holdinggesellschaften](https://support.stripe.com/questions/beneficial-ownership-verification-for-holding-companies). | | `verification_missing_owners` | Es wurden keine Unternehmensinhaber/innen angegeben. Machen Sie Angaben zu allen Unternehmensinhaberinnen und -inhabern oder laden Sie sie ein, damit sie diese Informationen selbst bereitstellen können. Die von uns als fehlend identifizierten Inhaber/innen sind: [Name1, Name2]. | | `verification_missing_directors` | Im Konto fehlen Vorstandsmitglieder. Nehmen Sie Änderungen am Konto vor und laden Sie ein Registrierungsdokument mit den derzeit gültigen Vorstandsmitgliedern hoch. | | `verification_document_directors_mismatch` | Geschäftsführer/innen aus dem Dokument fehlen im Konto. Aktualisieren Sie das Konto und laden Sie ein Registrierungsdokument mit den derzeitigen Geschäftsführern/Geschäftsführerinnen hoch. | ## See also - [Connect Onboarding für Custom-Konten](https://docs.stripe.com/connect/custom/hosted-onboarding.md) - [Onboarding-Lösungen für Custom-Konten](https://docs.stripe.com/connect/custom/onboarding.md) - [Konten aktualisieren](https://docs.stripe.com/connect/updating-service-agreements.md) - [Abwicklung der Identitätsprüfung mit der API](https://docs.stripe.com/connect/handling-api-verification.md) - [Identitätsprüfung bei Custom-Konten testen](https://docs.stripe.com/connect/testing-verification.md)