# 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). - **Vorstand:** Ein Vorstandsmitglied oder eine leitende Person, die für die Leitung des Unternehmens verantwortlich ist (z. B. CEO, COO, geschäftsführender Direktor). 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 | Gemeinnützige Organisationen haben normalerweise keine UBOs | | Regierungsbehörde, Regierungsstelle, Einzelperson, Einzelunternehmer, börsennotiertes Unternehmen | k. A. | Nur Identitätsprüfung | ### UBO- und Vorstandsinformationen Stripe versucht, die Beziehung der Person zu überprüfen, indem es wichtige Eigenschaften der Person mit den Eigenschaften der juristischen Person abgleicht. | Unternehmen | Wichtige Eigenschaften | | ------------------ | ----------------------------------------------------------------------------------------------- | | Person | - Vorname - Nachname - 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 Ab 2026 setzen wir strengere Anforderungen an den Unternehmenstyp für Konten in den Niederlanden (NL) durch, um die Einhaltung der niederländischen Vorschriften zu gewährleisten. Dies betrifft insbesondere die Erfassung der KvK (Kamer van Koophandel), der eindeutigen 8-stelligen Handelsregisternummer, die für Unternehmen in den Niederlanden erforderlich ist. ### Was ändert sich? #### Unternehmenstyp „Einzelperson“ wird nicht länger unterstützt Der Unternehmenstyp `individual` wird für niederländische Konten nicht mehr unterstützt. Dies betrifft: Bestehende und neue NL-Konten mit`business_type: "individual"` und`business_type: "sole_proprietorship"` **Warum das wichtig ist:** In den Niederlanden muss jedes Unternehmen eine KvK-Nummer (Handelskammer) angeben. Unser Unternehmenstyp „Einzelperson“ erhält keine KvK-Nummer, was ihn nicht-konform macht. #### Neuer Fehlercode: `unsupported_business_type` Bei Konten mit ungültigen Unternehmenstypen wird ein neuer Fehler in den Anforderungen angezeigt: ```shell // Account with unsupported business type { "id": "acct_123", "business_type": "individual", "country": "NL", "requirements": { "past_due": ["business_type"], "errors": [{ "requirement": "business_type", "code": "unsupported_business_type", "reason": "Business type isn't supported in merchant country. 'individual' isn't a supported business type in country NL." }] } } ``` #### Erfassen der KvK-Registrierung für Konten ohne eigene Rechtspersönlichkeit Bestehende und neue NL-Konten mit den folgenden Unternehmenstypen und -strukturen sind erforderlich, um die KvK-Registrierung zu ermöglichen. - `business_type: "company"` und `business_structure: "unincorporated_partnership"` - `business_type: "non_profit"` und `business_structure: "unincorporated_non_profit"` **Warum das wichtig ist:** Nicht eingetragene Konten sind **derzeit** nicht verpflichtet, eine KvK-Nummer anzugeben, was gegen die niederländischen Compliance-Anforderungen verstößt. Alle Unternehmen in den Niederlanden müssen ihre KvK-Registrierung vorlegen. ### Lösung #### Für bestehende Konten Bestehende NL-Konten mit dem Unternehmenstyp `individual` müssen auf `company` mit der Struktur `sole_proprietorship` aktualisiert werden. Nur so kann die Compliance gewährleistet werden, wenn wir mit der Einführung dieser neuen Anforderung beginnen: ```shell // Update existing account curl -X POST https://api.stripe.com/v1/accounts/acct_123 \ -u sk_test_123: \ -d "business_type=company" \ -d "company[structure]=sole_proprietorship" \ -d "company[tax_id]=12345678" // KvK number // Successful response { "id": "acct_123", "business_type": "company", "company": { "structure": "sole_proprietorship", "tax_id": "12345678" }, "requirements": { "past_due": [], // business_type requirement resolved "errors": [] } } ``` #### Zur Erstellung eines neuen Kontos Bei dem Versuch, ein niederländisches Konto mit de Unternehmenstyp `individual` zu erstellen, wird der Fehler unsupported_Unternehmen_type zurückgegeben. ```shell // This will fail curl -X POST https://api.stripe.com/v1/accounts \ -u sk_test_123: \ -d "country=NL" \ -d "type=custom" \ -d "business_type=individual" // Response { "id": "acct_123", "business_type": "individual", "country": "NL", "requirements": { "past_due": ["business_type"], "errors": [{ "requirement": "business_type", "code": "unsupported_business_type", "reason": "Business type isn't supported in merchant country. 'individual' isn't a supported business type in country NL." }] } // Correct approach curl -X POST https://api.stripe.com/v1/accounts \ -u sk_test_123: \ -d "country=NL" \ -d "type=custom" \ -d "business_type=company" \ -d "company[structure]=sole_proprietorship" ``` ### Unterstützte Unternehmensstrukturen für NL Verwenden Sie für niederländische Konten die folgenden Kombinationen aus Unternehmenstyp und Struktur: | Unternehmenstyp | Struktur | KvK erforderlich | | --------------- | ---------------------------- | ---------------- | | `company` | `sole_proprietorship` | Ja | | `company` | `incorporated_partnership` | Ja | | `company` | `unincorporated_partnership` | Ja | | `company` | `private_corporation` | Ja | | `company` | `public_corporation` | Ja | | `non_profit` | Verschiedene Strukturen | Ja | ### Auswirkungen auf die Funktionen Bei Konten mit einem Fehler bei dem `unsupported_business_type` werden ihre Funktionen eingeschränkt, bis der Unternehmenstyp aktualisiert wird: ```shell { "capabilities": { "card_payments": "inactive", "transfers": "inactive" }, "requirements": { "disabled_reason": "requirements.past_due", "past_due": ["business_type"] } } ``` Bei Konten, die ihre KvK-Registrierung nicht angegeben haben, wird ihre`card_payments`-Funktion eingeschränkt, bis diese Informationen bereitgestellt werden: ```shell { "capabilities": { "card_payments": "inactive" }, "requirements": { "disabled_reason": "requirements.past_due", "past_due": ["company.tax_id"] } } ``` ### Checkliste für die Umsetzung Für Plattformen mit verbundenen NL-Konten: 1. **Vorhandene Konten prüfen** ```javascript // Find affected accounts const accounts = await stripe.accounts.list({ limit: 100, // Filter for NL accounts in your system }); const affected = accounts.data.filter(a => a.country === 'NL' && a.business_type === 'individual' ); ``` 1. **Aktualisieren von Abläufen der Kontoerstellung** - Entfernen Sie die Option `individual` für NL-Konten - Standardmäßig auf `company` mit`sole_proprietorship` - KvK-Nummer erfassen (company.tax_id) 1. **Umgang mit dem neuen Fehlercode** ```javascript if (account.requirements.errors.some(e => e.code === 'unsupported_business_type')) { // Prompt user to update business type // Guide them to select appropriate structure // Collect KvK number } ``` 1. **Kommunizieren Sie mit betroffenen verbundenen Konten** - Erklären Sie, warum die Änderung notwendig ist - Orientierungshilfe bei der Auswahl der richtigen Unternehmensstruktur - Helfen Sie ihnen, ihre KvK-Nummer zu finden ### Testen Testen Sie Ihre Implementierung mit den folgenden Szenarien: ```javascript // Test updating to valid business type const updated = await stripe.accounts.update('acct_test_123', { business_type: 'company', company: { structure: 'sole_proprietorship', tax_id: '12345678' // Test KvK } }); ``` ### Weitere Überlegungen #### Freiberufler/innen In den Niederlanden müssen sich auch Freiberufler/innen als Unternehmen (eenmanszaak) registrieren und eine KvK-Nummer erhalten. Diese Personen sollten also `Unternehmen` →`sole_proprietorship` auswählen. #### So finden Sie die KvK-Nummer für verbundene Konten Die KvK-Nummer befindet sich auf der Anmeldebescheinigung der Handelskammer (uittreksel Kamer van Koophandel). #### Abwärtskompatibilität In älteren API-Versionen wird `unsupported_business_type` als`invalid_value_other` mit einem Feld `detailed_code` angezeigt, das den spezifischen Fehler enthält. ## 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 - 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)