# 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.
2. Ü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.
2. Sie können die eingegebenen Informationen für Geburtsdatum, Name, Adresse und id_number überprüfen und die korrekten Informationen erneut eingeben.
3. Sie können ein Dokument hochladen, das mit ihrem Namen und ihrer Adresse übereinstimmt
4. Sie können Stripe Identity abschließen

Diese vier Pfade werden als `past_due`-Felder und `alternatives` angezeigt:

```shell
> curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB -u sk_test_123:

{
  "requirements": {
    // 1. They can check the information they've entered for dob, name, and address, and re-enter the correct information.
    "past_due": [
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.first_name",
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.last_name",
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.*"
    ],
    "alternatives": [
      // 2. They can check the information they entered for dob, name, address and id_number and re-key correct information.
      {
        "original_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.first_name",
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.last_name",
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.*"
        ],
        "alternative_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number"
        ]
      },
      // 3. They can upload document that matches their name and address
      {
        "original_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.first_name",
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.last_name",
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.*"
        ],
        "alternative_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.verification.additional_document"
        ]
      },
      // 4. They can complete Stripe Identity
      {
        "original_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.first_name",
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.last_name",
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.*"
        ],
        "alternative_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.proof_of_liveness"
        ]
      }
    ]
  }
}
```

**Fehler bei eingegebenen Feldern** Wenn zuvor bei der Verarbeitung von eingegebenen Feldern ein Verifizierungsfehler auftrat, wurden Dokumentfelder auf `past_due` gesetzt und es traten Fehler auf ihnen auf. In Zukunft kehren die eingegebenen Felder zu`past_due` zurück. Felder wie`id_number` verbleiben in`alternative_fields_due`.

Wenn z. B. Name, Geburtsdatum und Adresse ursprünglich `past_due` sind, und nach der Einreichung stimmen Name und Geburtsdatum überein, während Name und Adresse dies nicht tun, dann kehren Name und Adresse zurück zu`past_due`, während das Geburtsdatum entfernt wird.

In diesem Fall werden Fehler in den Feldern in `past_due` und`alternative_fields_due` angezeigt.

```shell

> curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB -u sk_test_123:
{
  "requirements": {
    "past_due": [
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.name",
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.address"
    ],
    "alternatives": [
      {
        "original_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.name",
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.address"
        ],
        "alternative_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number"
        ]
      },
      {
        "original_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.name",
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.address"
        ],
        "alternative_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.proof_of_liveness"
        ]
      },
      {
        "original_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.name",
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.address"
        ],
        "alternative_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.verification.additional_document"
        ]
      }
    ],
    "errors": [
      {
        "code": "verification_failed_keyed_identity",
        "reason": "Identity information could not be verified.",
        "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.name"
      },
      {
        "code": "verification_failed_keyed_identity",
        "reason": "Identity information could not be verified.",
        "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.address"
      },
      {
        "code": "verification_failed_keyed_identity",
        "reason": "Identity information could not be verified.",
        "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number"
      }
    ]
  }
}
```

### Konten mit hohem Risiko

Für das Risikomodell von Stripe ist eine KYC-Verifizierung für UBOs nur bei Konten erforderlich, die als hoch risikoreich eingestuft werden. Hängen Sie für Tests `_high_risk` an den Unternehmensnamen an, um eine Risikoeinstufung zu erzwingen. Auf diese Weise können Sie den gesamten KYC-Verifizierungsablauf für Eigentümer/innen testen, einschließlich der Anforderungen und Fehler, die Ihre Integration handhaben muss.

Dieses Beispiel zeigt, wie Sie ein Testkonto mit hohem Risiko erstellen und Eigentümer/innen hinzufügen:

```curl
// Creating a connected account in Spain
curl https://api.stripe.com/v1/accounts \
  -u sk_test_123: \
  -H "Stripe-Version: 2025-08-27.basil;experimental_onboarding_preview=v2" \
  -d 'type'='custom' \
  -d 'country'='ES' \
  -d 'capabilities[card_payments][requested]'='true' \
  -d 'capabilities[card_payments][preview]'='true' \
  -d 'capabilities[transfers][requested]'='true'
{
  "id": "acct_123",
  ...
  "requirements": {...}
 ...
}

// Set the business name to enforce the account to be high risk
curl https://api.stripe.com/v1/accounts/acct_123 \
  -u sk_test_123: \
  -d "business_profile[name]"="example_high_risk"
```

```curl
curl https://api.stripe.com/v1/accounts/acct_123/persons \
  -u sk_test_123: \
  -d first_name=Marie \
  -d last_name=Dupont \
  -d "dob[day]"=1 \
  -d "dob[month]"=1 \
  -d "dob[year]"=1901 \
  -d "relationship[owner]=true" \
  -d "address[line1]"="address_no_match" \
  -d "address[city]"="Madrid" \
  -d "address[postal_code]"="28001"
{
  "id": "person_123",
  ...
}
```

```curl
curl https://api.stripe.com/v1/accounts/acct_123 \
  -u sk_test_123: \
  -d "company[owners_provided]"="true"
```

Nachdem Stripe die KYC-Verifizierung der Eigentümerin oder des Eigentümers durchgeführt hat, spiegeln die Konto-Anforderungen das Ergebnis wider. Wenn der Name der Eigentümerin oder des Eigentümers übereinstimmt, die Adresse aber nicht (ausgelöst durch die Verwendung der Testadresse `address_no_match`), umfassen die Anforderungen `verification_failed_keyed_identity`-Fehler in den Feldern der Eigentümerin oder des Eigentümers:

```json
{
  "requirements": {
    "past_due": [
      "people.person_123.address.city",
      "people.person_123.address.line1",
      "people.person_123.address.postal_code",
      "people.person_123.first_name",
      "people.person_123.last_name"
    ],
    "errors": [
      {
        "code": "verification_failed_keyed_identity",
        "requirement": "people.person_123.address.city"
      },
      {
        "code": "verification_failed_keyed_identity",
        "requirement": "people.person_123.address.line1"
      },
      {
        "code": "verification_failed_keyed_identity",
        "requirement": "people.person_123.address.postal_code"
      },
      {
        "code": "verification_failed_keyed_identity",
        "requirement": "people.person_123.first_name"
      },
      {
        "code": "verification_failed_keyed_identity",
        "requirement": "people.person_123.last_name"
      }
    ],
    "alternatives": [
      {
        "original_fields_due": [
          "people.person_123.address.city",
          "people.person_123.address.line1",
          "people.person_123.address.postal_code",
          "people.person_123.first_name",
          "people.person_123.last_name"
        ],
        "alternative_fields_due": [
          "people.person_123.verification.additional_document"
        ]
      },
      {
        "original_fields_due": [
          "people.person_123.address.city",
          "people.person_123.address.line1",
          "people.person_123.address.postal_code",
          "people.person_123.first_name",
          "people.person_123.last_name"
        ],
        "alternative_fields_due": [
          "people.person_123.verification.proof_of_liveness"
        ]
      }
    ]
  }
}
```

Um diese Anforderungen zu erfüllen, müssen Sie entweder die Identitätsangaben der Eigentümerin oder des Eigentümers erneut übermitteln oder eine der alternativen Anforderungen erfüllen (`additional_document` hochladen oder `proof_of_liveness` ausfüllen).

## Beziehungsüberprüfung für UBOs und Geschäftsführer/innen

Stripe verbessert seinen Prozess zur Überprüfung von wirtschaftlichen Eigentümern (UBOs) und Vorständen. Die europäischen Vorschriften verlangen eine Überprüfung der Beziehung von UBOs und Vorständen zur juristischen Person:

- **UBO:** Eine Einzelperson, die (direkt oder indirekt) mehr als 25 % einer juristischen Person besitzt oder kontrolliert (z. B. Unternehmen, Kapitalgesellschaften, LLCs und Partnerschaften).
- **Vorstandsmitglied**: Ein Mitglied des Verwaltungsrats des Unternehmens oder jede andere leitende Person, die für das Management des Unternehmens verantwortlich ist. (Beispiele hierfür sind CEO, COO, President, Geschäftsführer, geschäftsführender Vorstand usw.)

Die folgende Tabelle zeigt die Beziehungen, die für jeden juristischen Personentyp verifiziert werden müssen:

| Typ der juristischen Person | Zu überprüfende Beziehungen | Hinweis |
| --- | --- | --- |
| Unternehmen, Kapitalgesellschaft, LLC, Personengesellschaft | UBOs, falls zutreffend; ansonsten Vorstände | Nur Vereinigtes Königreich: sowohl UBOs als auch Geschäftsführer/innen |
| Wohltätige Organisation | Vorstandsmitglieder | Die meisten gemeinnützigen Organisationen haben keine UBOs |
| Privatperson oder Einzelunternehmer/in | k. A. | k. A. |
| Regierungsstelle oder Behörde | k. A. | Um von der Bereitstellung von UBO-Informationen befreit zu werden, müssen Regierungsstellen den in [diesem Support-Artikel](https://support.stripe.com/questions/business-verification-requirements-for-government-entities) beschriebenen Prozess befolgen. |
| Börsennotiertes Unternehmen | k. A. | Um von der Bereitstellung von UBO-Informationen befreit zu werden, müssen börsennotierte Unternehmen den in [diesem Support-Artikel](https://support.stripe.com/questions/business-verification-requirements-for-publicly-traded-companies) beschriebenen Prozess befolgen. |

### UBO- und Vorstandsinformationen

UBOs und Vorstandsmitglieder müssen die folgenden Informationen bereitstellen:

- Vollständiger Name
- Geburtsdatum
- Adresse
- E-Mail-Adresse
- Titel (nur Vorstandsmitglieder)

Stripe versucht, die Beziehung der Person zu überprüfen, indem es die folgenden zentralen Eigenschaften der Person mit der juristischen Person abgleicht:

| Unternehmen | Wichtige Eigenschaften |
| --- | --- |
| Person | - Vorname
- Nachname
- (Falls angegeben) Ausweisnummer |
| Juristische Person | - Name
- Adresse
- Steueridentifikationsnummer
- Umsatzsteuer-ID
- Registrierungsnummer |

Für eine erfolgreiche Verifizierung muss möglicherweise nur ein Teil der Eigenschaften übereinstimmen.

Stripe versucht, Beziehungen auf folgende Weise zu überprüfen:

| Methode | Beschreibung | Beispielanforderungen |
| --- | --- | --- |
| Drittanbieter | Wenn ein Drittanbieter verfügbar ist, versucht Stripe automatisch, alle Beziehungen auf dem Konto zu verifizieren. | - `owners.first_name`
- `owners.last_name`
- `company.tax_id` |
| Offizielles Dokument | Sie können ein Dokument zum Nachweis der wirtschaftlichen Berechtigung für Inhaber/innen und ein Dokument zum Nachweis der Registrierung für Geschäftsführer/innen vorlegen. Die [akzeptierten Dokumente](https://docs.stripe.com/acceptable-verification-documents.md) variieren je nach Land. | - `owners.first_name`
- `owners.last_name`
- `company.name`
- `company.address.line1`
- `company.address.city`
- `company.address.state`
- `documents.proof_of_ultimate_beneficial_ownership` |
| Digitale Bescheinigung | Sie können die folgenden PDF-Vorlagen verwenden, um digitale Bescheinigungen für Ihre Beziehungen bereitzustellen:
- [Vorlage für digitale UBO-Bescheinigungen](https://docs.stripecdn.com/6e82842bfc01bd0b1c46d77f7d46b69673a9ca965ed2ad9ef53139f98abdbbaf.pdf)
- [Vorlage zur digitalen Bescheinigung des Vorstands](https://docs.stripecdn.com/715ffef45157ff700bc368a4011659ee23bc8ba3c68746c5c15948a6eee1591f.pdf) | - `owners.id_number`
- `company.tax_id`
- `documents.proof_of_ultimate_beneficial_ownership`
- `documents.proof_of_ultimate_beneficial_ownership.signer` |

### Identifizieren Sie die Anforderungen zur Überprüfung von Beziehungen mithilfe der API

Wenn Sie die Anforderungen für ein `Konto` abrufen, stellen die ursprünglichen und alternativen Verifizierungsoptionen Kombinationen aus den wichtigsten Informationen und den verfügbaren Verifizierungsmethoden dar. In den meisten Fällen gibt es mindestens drei Optionen zur Verifizierung von Eigentümerinnen und Eigentümern oder Geschäftsführerinnen und Geschäftsführern.

Der folgende Code zeigt ein Beispiel für ein verbundenes Konto mit Anforderungen an den Eigentümer. Bestimmte Optionen und die Reihenfolge, in der sie angezeigt werden, können je nach Konto variieren.

```shell
// Example with owner requirements
> curl https://api.stripe.com/v1/accounts/acct_1234 \
  -u sk_test_123:

{
  "id": "acct_1234",
  "past_due": {
    // third-party provider option
    "currently_due": [
      "owners.first_name",
      "owners.last_name",
      "company.owners_provided",
      "company.tax_id"
    ],
    "alternatives": [
      {
        "original_fields_due": [
          "owners.first_name",
          "owners.last_name",
          "company.owners_provided",
          "company.tax_id"
        ],
        // official document option
        "alternative_fields_due": [
          "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_due": [
          "owners.first_name",
          "owners.last_name",
          "company.owners_provided",
          "company.tax_id"
        ],
        // digital attestation option
        "alternative_fields_due": [
          "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_due": [
          "owners.first_name",
          "owners.last_name",
          "company.owners_provided",
          "company.tax_id"
        ],
        // third-party provider option for directors
        "alternative_fields_due": [
          "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_due": [
          "owners.first_name",
          "owners.last_name",
          "company.tax_id"
        ],
        // third-party provider option for directors
        "alternative_fields_due": [
          "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` (Public 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

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.

2. 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"
   }
   ```

3. 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.
2. Implementieren der Fehlerbehandlung für neue nachweisspezifische Fehlercodes.
3. 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.

### Interessiert an frühem Zugang zur Stripe UBO-/Vorstands-Vorausfüllung?

Enter your email to request access.

```bash
curl https://docs.stripe.com/preview/register \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Referer: https://docs.stripe.com/connect/upcoming-requirements-updates" \
  -d '{"email": "EMAIL", "preview": "risk_requirements_beta_preview"}'
```

## Anforderungen zur Unternehmensregistrierung (KvK) in den Niederlanden

**Gültig ab 14. Mai 2026**

Anfang 2026 wurden Plattformen verpflichtet, von verbundenen Konten in den Niederlanden (NL) eine KvK-Nummer (Kamer van Koophandel) zu erfassen. Dabei handelt es sich um eine eindeutige 8-stellige Registrierungsnummer für Unternehmen. Im Rahmen dieser Änderung wurde der Unternehmenstyp `individual` mit dem Fehler `unsupported_business_type` eingeschränkt und Unternehmen ohne Rechtspersönlichkeit wurden verpflichtet, über `company.tax_id` eine KvK-Nummer anzugeben.

Ab dem 14. Mai 2026 sind verbundene Konten, die Einzelpersonen oder Unternehmen ohne Rechtspersönlichkeit darstellen und keinen Zugriff auf ein von Stripe gehostetes Dashboard haben, nicht mehr zur Angabe einer KvK-Nummer verpflichtet.

Verbundene Konten, die Einzelpersonen oder Unternehmen ohne Rechtspersönlichkeit darstellen und Zugriff auf das vollständige Stripe-Dashboard oder das Express-Dashboard haben, müssen weiterhin eine KvK-Nummer angeben.

### Was ändert sich?

- `business_type: "individual"` wird jetzt für verbundene Konten in den Niederlanden unterstützt, die keinen Zugriff auf ein von Stripe gehostetes Dashboard haben. Der Fehler `unsupported_business_type` wird für diese Konten nicht mehr angezeigt.
- Die Unternehmenstypen `unincorporated_partnership` und `unincorporated_non_profit` verlangen für verbundene Konten ohne Zugriff auf ein von Stripe gehostetes Dashboard nicht mehr, dass `company.tax_id` die KvK-Nummer enthält.

### Das müssen Sie erledigen

Es besteht kein Handlungsbedarf. Sie müssen keine Änderungen an Ihrer Integration vornehmen.

Für bestehende verbundene Konten, die von dieser Änderung betroffen sind:

- Stripe löscht den Fehler `unsupported_business_type` für einzelne Konten automatisch aus `requirements.errors`.
- Alle Funktionseinschränkungen (wie `card_payments` oder `transfers`), die mit diesem Fehler verbunden sind, werden automatisch aufgehoben.
- Konten, die Einzelpersonen oder Unternehmen ohne Rechtspersönlichkeit darstellen und aufgrund einer fehlenden KvK-Nummer eingeschränkt waren, werden ebenfalls automatisch entsperrt.

## Neue Fehlercodes

### Verifizierungsfehlercodes (Public 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 öffentlichen Vorschau der API verwenden, lautet der Fehlercode [verification_data_not_found](https://docs.stripe.com/changelog/clover/2025-10-29/accounts-verification-data-error.md) statt `verification_failed_other`.

Wenn Sie diese Fehlermeldung für ein echtes `Konto` erhalten, überprüfen Sie, ob Sie die Angaben für die korrekte juristische Person eingegeben haben. In diesem Beispiel wird davon ausgegangen, dass die Angaben korrekt sind und dass Sie ein Dokument einreichen müssen, um sie zu verifizieren.

[Verwenden Sie für ein echtes `Account` die Files API, um ein Dokument hochzuladen](https://docs.stripe.com/file-upload.md), und aktualisieren Sie dann das `Account` mit dem in der Antwort zurückgegebenen Token. Verwenden Sie in diesem Beispiel das Test-Token `file_relationship_document_success`. Weitere Ergebnisauslöser finden Sie unter [Beziehungsdokument-Token testen](https://docs.stripe.com/connect/testing.md#test-relationship-document-tokens).

```shell
curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d "documents[proof_of_ultimate_beneficial_ownership][files][]"=file_relationship_document_success
```

Wenige Augenblicke nach der Aktualisierung des `Kontos` können Sie die aktuellen Anforderungen abrufen und sehen, dass die Anforderungen bezüglich der Inhaber/innen erfüllt wurden.

```shell
curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123:
```

### Ein Unternehmen ohne zutreffende Inhaber/innen testen

Wenn ein Unternehmen keine Inhaber/innen mit Anteilen von mehr als 25 % aufweist, benötigt Stripe stattdessen Informationen zum Vorstand. Dieses Beispiel zeigt, wie Sie Informationen zum Vorstand angeben.

Erstellen Sie ein Testkonto gemäß [den vorherigen Anweisungen](https://docs.stripe.com/connect/upcoming-requirements-updates.md#create-a-test-account) und legen Sie dann die grundlegenden Unternehmensdaten fest. Geben Sie die Steueridentifikationsnummer `000000000` an, wodurch die erfolgreiche Verifizierung des Unternehmens ausgelöst wird.

```shell
curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d business_type=company \
  -d "business_profile[mcc]"=5995 \
  -d "business_profile[url]"="https://accessible.stripe.com" \
  -d "company[name]=Test company" \
  -d "company[phone]=628123456787" \
  -d "company[address][line1]=address_full_match" \
  -d "company[address][city]=Madrid" \
  -d "company[address][postal_code]=28009" \
  -d "company[address][country]=ES" \
  -d "company[tax_id]=000000000"
```

Geben Sie als Nächstes einen Vertreter/eine Vertreterin an:

```shell
curl https://api.stripe.com/v1/accounts/acct_test_123/persons \
  -u sk_test_123: \
  -d "first_name=Marie" \
  -d "last_name=Dupont" \
  -d "dob[year]=1901" \
  -d "dob[month]=1" \
  -d "dob[day]=1" \
  -d "address[line1]=address_full_match" \
  -d "address[city]=Madrid" \
  -d "address[postal_code]=28009" \
  -d "address[country]=ES" \
  -d "email=test@example.com" \
  -d "phone=%2B35366666666" \
  -d "nationality=ES" \
  -d "relationship[representative]=true" \
  -d "relationship[title]=CEO"
```

Um anzugeben, dass das Unternehmen keine relevanten Inhaber/innen hat, setzen Sie `company.owners_provided` auf „true“, ohne Inhaber/innen zu erstellen. Um ein bestehendes `Testkonto`, das Inhaber/innen aufweist, erneut zu verwenden, können Sie alle bestehenden Inhaber/innen entfernen.

```shell
curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d "company[owners_provided]=true"
```

Das Array `requirements.alternatives` enthält eine Reihe von Eigenschaften für den Vorstand als Alternative zu den Eigenschaften der Inhaber/innen. Der Prozess zur Erstellung eines Vorstands ähnelt dem Prozess zur Erstellung eines Inhabers/einer Inhaberin:

```shell
curl https://api.stripe.com/v1/accounts/acct_test_123/persons \
  -u sk_test_123: \
  -d "first_name=Adam" \
  -d "last_name=Smith" \
  -d "dob[year]=1901" \
  -d "dob[month]=1" \
  -d "dob[day]=1" \
  -d "address[line1]=address_full_match" \
  -d "address[city]=Madrid" \
  -d "address[postal_code]=28009" \
  -d "address[country]=ES" \
  -d "email=owner@example.com" \
  -d "relationship[director]=true" \
  -d "relationship[title]=President"
```

Geben Sie an, dass Sie die Erstellung von Vorstandsmitgliedern abgeschlossen haben, indem Sie `company.directors_provided` auf „true“ setzen:

```shell
curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d "company[directors_provided]=true"
```

Um eine erfolgreiche Beziehungsüberprüfung zu simulieren, legen Sie für `company.name` die Zeichenfolge `match_name_relationships` fest:

```shell
curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d "company[name]=match_name_relationships"
```

### Andere Testszenarien

Folgende Tests sind ebenfalls nützlich:

- Eine juristische Person des Typs `non_profit`, für die eine Verifizierung des Vorstands erforderlich ist (eine Verifizierung der letztendlich wirtschaftlichen Eigentümer/innen ist nicht möglich).
- Erfüllung der Verifizierungsanforderungen bezüglich des Vorstands mithilfe eines Dokuments.
- Unternehmen im Vereinigten Königreich, für die sowohl eine Verifizierung der letztendlich wirtschaftlichen Eigentümer/innen als auch eine Verifizierung des Vorstands erforderlich ist.

#### Programm - Brasilien

*Zuletzt aktualisiert am 1. Juli 2026*

## Grundlegendes zu den Änderungen an den Verifizierungsanforderungen

Zur Anpassung an die Vorschriften der brasilianischen Zentralbank (BCB) gemäß Circular BCB 3978/20 wird Stripe seine Verifizierungsanforderungen für Know Your Customer (KYC), Know Your Business (KYB) und wirtschaftlich Eigentümer/innen (UBO) aktualisieren.

Wenn Ihre verbundenen Konten in Brasilien betrieben werden, müssen Sie möglicherweise Ihren Onboarding- und Sanierungsablauf aktualisieren. Wenn Sie die erforderlichen Aktualisierungen nicht vornehmen, wird der Zugriff Ihrer verbundenen Konten auf Zahlungen und Finanzdienstleistungen unterbrochen.

## Wahl eines Integrationsansatzes

Stripe empfiehlt, Stripe-gehostetes oder eingebettetes Onboarding zu verwenden, um Anforderungen zur Geschäfts- und Identitätsverifizierung zu erfassen. Diese Optionen erfordern weniger Ressourcen für Implementierung und Wartung als die Nutzung des API-Onboardings. Die folgende Tabelle beschreibt die wichtigsten Unterschiede:

- [Von Stripe gehostetes Onboarding](https://docs.stripe.com/connect/hosted-onboarding.md): (Empfohlen) Senden Sie Konten zu einem Stripe-gehosteten Flow, damit die erforderlichen Informationen übermittelt werden.
- [Eingebettetes Onboarding](https://docs.stripe.com/connect/embedded-onboarding.md): (Empfohlen) Betten Sie von Stripe bereitgestellte Onboarding-Komponenten ein, mit denen Konten Informationen direkt aus Ihrer App an Stripe übermitteln können.
- [API Onboarding](https://docs.stripe.com/connect/api-onboarding.md): Erstellen und verwalten Sie einen benutzerdefinierten Onboarding-Ablauf mithilfe der Stripe-APIs.

|  | **Von Stripe gehostetes Onboarding** | **Eingebettetes Onboarding** | **API-Onboarding** |
| --- | --- | --- | --- |
| Ideal für Folgendes | Plattformen, die möchten, dass Stripe das Onboarding übernimmt | Plattformen, die einen markeneigenen In-App-Onboarding-Ablauf wünschen | Plattformen, die die volle Kontrolle benötigen und diesen Ablauf aufbauen und pflegen können |
| Anfänglicher Implementierungsaufwand | 3–4 Engineering-Wochen | 3–4 Engineering-Wochen | 30–40 Engineering-Wochen |
| Laufende Bemühungen, Anforderungsaktualisierungen umzusetzen | Wird automatisch von Stripe erledigt | Wird automatisch von Stripe erledigt | Erfordert eine proaktive Überwachung auf bevorstehende Änderungen sowie technische Ressourcen, um den Onboarding-Ablauf für jede Änderung zu aktualisieren |
| Anpassung | Von Stripe gehostete Schnittstelle mit Plattform-Branding | Hochgradig themenfähige Komponente, auf die Konten über die Plattform-App zugreifen | Die Plattform entwirft, erstellt und verwaltet die Benutzeroberfläche |
| Bemühungen um Support weiterer Länder | Wird automatisch von Stripe erledigt | Wird automatisch von Stripe erledigt | Erfordert technische Ressourcen, um den Onboarding-Ablauf für jedes zusätzliche Land zu aktualisieren |

Erfahren Sie mehr über [Onboarding-Optionen von Connect](https://docs.stripe.com/connect/onboarding.md) und die [Migration Ihrer API-basierten Onboarding- und Sanierungsabläufe auf von Stripe gehostete oder eingebettete Abläufe](https://docs.stripe.com/connect/migrate-from-api-onboarding.md).

Plattformen, die von Stripe gehostetes oder eingebettetes Onboarding verwenden, müssen ihre Integrationen für diese Anforderungsaktualisierungen nicht anpassen – Stripe übernimmt dies automatisch für sie. Plattformen mit API-basiertem Onboarding müssen Anforderungsänderungen aktiv verfolgen und für jede Aktualisierung Engineering-Ressourcen bereitstellen.

## Übersicht der API-Integration

Wenn Ihre Plattform API-basiertes Onboarding verwendet, müssen Sie Ihre Integration aktualisieren, um die folgenden Änderungen für verbundene Konten in Brasilien zu verarbeiten:

- **KYC: Identitätsverifizierung für Einzelpersonen**: Erfassung von CPF, Geburtsdatum, Adresse und Lebendigkeitsnachweis für alle Einzelkonten und Unternehmensvertreter/innen.
- **KYB: Identitätsverifizierung juristischer Personen**: Erfassung von CNPJ, dem rechtlichen Unternehmensnamen und der registrierten Adresse juristischer Personen; Handhabung der programmgesteuerten Verifizierung und der Dokumenten-Fallback-Abläufe.
- **Registrierungsstatus der Steueridentifikationsnummer**: Verarbeitung des Registrierungsstatus bei inaktiven oder ungültigen CPF- und CNPJ-Nummern.
- **Autorisierungsnachweis**: Verifizierung der Befugnis der Unternehmensvertreterin oder des Unternehmensvertreters zur Vertretung des Unternehmens; zu erbringen über einen programmgesteuerten Abgleich oder die Bescheinigung `company.representative_declaration`.
- **Verifizierung von UBO und Beziehung**: Verifizierung der Auflistung von Inhaber/innen (UBOs) und Vorständen im CNPJ-Register; zu erbringen über einen programmgesteuerten Namensabgleich, das Hochladen von Dokumenten oder den Inhaber-Vorstandszuweisung.
- **Finanzielle Leistungsfähigkeit**: Erfassen des monatlichen Einkommens oder Bruttoumsatzes.
- **Neue Fehlercodes**: Verarbeitung neuer Verifizierungsfehlercodes im Array `requirements.errors`.

## KYC: Identitätsverifizierung für Einzelpersonen

Stripe stärkt die Identitätsverifizierung für Konten von Einzelpersonen in Brasilien, um die Anforderungen der brasilianischen Zentralbank (BCB) zu erfüllen. Inhaber/innen verbundener Konten, bei denen es sich Einzelpersonen handelt, sowie Vertreter/innen von Konten juristischer Personen müssen verifiziert werden – sie müssen möglicherweise im Rahmen des Onboardings zusätzliche Angaben machen.

Die folgenden Personen müssen überprüfbare KYC-Informationen bereitstellen:

- **Unternehmensvertreter/innen**: Die Einzelperson, die die Allgemeinen Geschäftsbedingungen unterzeichnet und rechtlich für das Konto verantwortlich ist.
- **Inhaber/innen**: Die Inhaber/innen juristischer Personen (sofern zutreffend).

Stripe verwendet eine Kombination aus manuell eingegebenen Daten und Dokumentenprüfung, um die Identität aller Personen zu verifizieren. Darüber hinaus schreibt die brasilianische Regulierung eine Lebenderkennung (`proof_of_liveness`) vor, um zu bestätigen, dass die Person, die die Identitätsdokumente einreicht, physisch anwesend ist. Von Stripe gehostete und eingebettete Onboarding-Abläufe erledigen diesen Schritt automatisch. Wenn Ihre Plattform API-basiertes Onboarding verwendet, müssen Sie Nutzer/innen zu einem von Stripe gehosteten Verifizierungsschritt weiterleiten oder die eingebettete Komponente `<stripe-connect-kyc-details>` integrieren, um die Erfassung abzuschließen. Weitere Details finden Sie unter [Anforderungen an die Lebenderkennung verarbeiten](https://docs.stripe.com/connect/api-onboarding.md?accounts-namespace=v1&liveness=hosted#proof-of-liveness).

**Altersanforderungen:** Unternehmensvertreter/innen müssen mindestens 18&nbsp;Jahre alt sein. Inhaber/innen, Direktoren/Direktorinnen und leitende Angestellte müssen mindestens 18&nbsp;Jahre alt sein. Für neue Nutzer/innen, die diese Anforderungen nicht erfüllen, werden keine Funktionen aktiviert. Bestehende Konten mit einem Unternehmensvertreter/einer Unternehmensvertreterin, der/die unter 18&nbsp;Jahre alt ist, werden sofort bei der Migration der Plattform deaktiviert.

### Erforderliche Felder

Für brasilianische Einzelkonten sind jetzt die folgenden Felder erforderlich:

| Feld | Beschreibung |
| --- | --- |
| `person.first_name`, `person.last_name` | Vollständiger rechtsgültiger Name. |
| `person.id_number` | CPF (brasilianische Steueridentifikationsnummer für Einzelpersonen). |
| `person.address.line1`, `.city`, `.postal_code`, `.country` | Brasilianische Wohnadresse. Alle Unternehmensvertreter/innen müssen in Brasilien ansässig sein und eine brasilianische Adresse angeben. |
| `person.dob.day`, `.month`, `.year` | Geburtsdatum. |
| `person.verification.proof_of_liveness` | Selfie als Lebendigkeitsnachweis. (Nur für von Stripe gehostete und eingebettete Onboarding-Abläufe) |
| `person.verification.additional_document` | Optionale Dokumentenanforderung, wenn die Verifizierung der manuell eingegebenen Adresse fehlschlägt. |

Stellen Sie sicher, dass Ihre Nutzeroberfläche speziell eine CPF erfasst&nbsp;– wir akzeptieren für brasilianische Konten keine anderen Ausweisarten (Passnummern, ausländische Steuernummern).

### Erste Antwort auf Anforderungen

Wenn ein neues Einzelkonto erstellt wird, enthält der Hash `requirements` Folgendes:

```json
{
  "currently_due": [
    "person.first_name",
    "person.last_name",
    "person.id_number",
    "person.dob.day",
    "person.dob.month",
    "person.dob.year",
    "person.address.line1",
    "person.address.city",
    "person.address.state",
    "person.address.country",
    "person.verification.proof_of_liveness"
  ],
  "pending_verification": [],
  "alternatives": [
    {
      "original_fields_due": ["person.address.line1", "person.address.city", "person.address.state", "person.address.country"],
      "alternative_fields_due": ["person.verification.additional_document"]
    }
  ],
  "errors": []
}
```

### Personendaten erfassen

Verwenden Sie die Persons API, um individuelle Felder zu übermitteln:

```shell
curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}}/persons/{{PERSON_ID}} \
  -u "{{PLATFORM_SECRET_KEY}}:" \
  -d "first_name=Maria" \
  -d "last_name=Silva" \
  -d "id_number=123.456.789-09" \
  -d "dob[day]=15" \
  -d "dob[month]=6" \
  -d "dob[year]=1985" \
  -d "address[line1]=Rua das Flores, 123" \
  -d "address[city]=São Paulo" \
  -d "address[state]=SP" \
  -d "address[postal_code]=01310-100" \
  -d "address[country]=BR"
```

### Fehlerbehebung

| Fehlercode | Auslöser | Sanierung |
| --- | --- | --- |
| `verification_failed_id_number_inactive` | CPF gefunden, aber der Status ist inaktiv (zum Beispiel gesperrt, gelöscht, verstorben). | Nutzer/innen müssen den CPF-Status mit der brasilianischen Bundessteuerbehörde (Receita Federal) klären. Bei Konten mit storniertem, ungültigem oder als verstorben gemeldetem CPF-Status kann Stripe deren Funktionen deaktivieren. |
| `verification_failed_keyed_match` | Die CPF konnte weder in der programmgesteuerten Suche noch in der manuellen Prüfung verifiziert werden. | Der Nutzer/die Nutzerin reicht CPF und Ausweisdokument erneut ein; das Konto wird in die MVR-Warteschlange eingereiht. |
| `verification_document_type_not_supported` | Das hochgeladene Dokument entspricht nicht dem angeforderten Typ, stammt aus dem falschen Land oder ist unleserlich. | Nutzer/in lädt einen akzeptablen behördlich ausgestellten brasilianischen Ausweis erneut hoch. |

## Identitätsverifizierung juristischer Personen für KYB

Stripe aktualisiert die Anforderungen zur Unternehmensverifizierung für juristische Personen in Brasilien, um die AML-Vorschriften der brasilianischen Zentralbank (BCB) zu erfüllen. Diese Art der Verifizierung fällt in die übergeordnete Kategorie der Know-Your-Business-Anforderungen (KYB). Wenn Ihre verbundenen Konten Unternehmen umfassen, die in Brasilien eingetragen sind, müssen sie beim Onboarding möglicherweise zusätzliche Angaben machen.

Stripe verifiziert juristische Personen anhand der CNPJ (Cadastro Nacional da Pessoa Jurídica)&nbsp;– der nationalen Handelsregisternummer in Brasilien&nbsp;– sowie des Unternehmensnamens und der registrierten Adresse. Stripe versucht zunächst eine programmgesteuerte Verifizierung anhand des CNPJ-Registers der brasilianischen Regierung. Stimmen die eingegebenen Informationen nicht überein, kann das Konto die Anforderung durch das Hochladen eines Dokuments zur Verifizierung des Unternehmens (z.&nbsp;B. eines CNPJ-Zertifikats der Receita Federal) erfüllen.

Zusätzlich zur Identitätsverifizierung verpflichten die brasilianischen AML-Vorschriften Stripe dazu, die finanzielle Leistungsfähigkeit eines verbundenen Kontos zu bewerten, bevor Zahlungen und Auszahlungen aktiviert werden. Alle brasilianischen Konten müssen ihren geschätzten monatlichen Umsatz oder ihr Einkommen angeben, bevor die Funktionen aktiviert werden. Diese Informationen dienen ausschließlich der regulatorischen Überwachung und werden beim Onboarding nicht eigenständig verifiziert.

### Erforderliche Felder

Die folgenden Felder sind für Konten brasilianischer juristischer Personen erforderlich:

| Feld | Beschreibung |
| --- | --- |
| `company.tax_id` | CNPJ (14-stellige brasilianische Handelsregisternummer). |
| `company.name` | Rechtsgültiger Unternehmensname&nbsp;– muss mit dem CNPJ-Register übereinstimmen. |
| `company.address.line1`, `.city`, `.postal_code` | Registrierte brasilianische Geschäftsadresse. |
| `company.verification.document` | Zunächst optional; erst erforderlich, wenn die programmgesteuerte Verifizierung fehlschlägt. |
| `business_profile.monthly_estimated_revenue.amount` | Monatlicher Bruttoumsatz in BRL. |
| `business_profile.monthly_estimated_revenue.currency` | Muss `brl` lauten. |

### Erste Antwort auf Anforderungen

```json
{
  "currently_due": [
    "company.tax_id",
    "company.name",
    "company.address.line1",
    "company.address.city",
    "company.address.postal_code",
    "business_profile.monthly_estimated_revenue.amount",
    "business_profile.monthly_estimated_revenue.currency"
  ],
  "pending_verification": [],
  "alternatives": [
    {
      "original_fields_due": [
        "company.tax_id",
        "company.name",
        "company.address.line1",
        "company.address.city",
        "company.address.postal_code"
      ],
      "alternative_fields_due": [
        "company.tax_id",
        "company.name",
        "company.address.line1",
        "company.address.city",
        "company.address.postal_code",
        "company.verification.document"
      ]
    }
  ],
  "errors": []
}
```

Das Array `alternatives` gibt an, dass die Plattform, wenn die programmgesteuerte CNPJ-Verifizierung fehlschlägt, dies durch die zusätzliche Angabe eines `company.verification.document` lösen kann.

### Unternehmensdaten erfassen

```shell
curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}} \
  -u "{{PLATFORM_SECRET_KEY}}:" \
  -d "company[tax_id]=12.345.678/0001-99" \
  -d "company[name]=Empresa Exemplo Ltda" \
  -d "company[address][line1]=Avenida Paulista, 1000" \
  -d "company[address][city]=São Paulo" \
  -d "company[address][postal_code]=01310-100" \
  -d "company[address][country]=BR" \
  -d "business_profile[monthly_estimated_revenue][amount]=5000000" \
  -d "business_profile[monthly_estimated_revenue][currency]=brl"
```

Nach dem Einreichen der Steueridentifikationsnummer, des Namens und der Adresse des Unternehmens wechseln die Anforderungen in den Status `pending_verification`, während Stripe die Daten mit dem CNPJ-Register verifiziert:

```json
{
  "currently_due": [],
  "pending_verification": [
    "company.tax_id",
    "company.name",
    "company.address.line1",
    "company.address.city",
    "company.address.postal_code"
  ],
  "alternatives": [],
  "errors": []
}
```

Warten Sie auf einen Webhook `account.updated`, bevor Sie fortfahren. Wenn die Verifizierung erfolgreich ist, werden alle Felder aus den Anforderungen entfernt. Wenn die Verifizierung fehlschlägt, lesen Sie den Abschnitt zur Fehlerbehandlung weiter unten.

### Registrierungsstatus der Steueridentifikationsnummer

Zusätzlich zur Verifizierung der CNPJ anhand von Unternehmensdaten überprüft Stripe den Registrierungsstatus der CNPJ (und der CPF des Unternehmensvertreters/der Unternehmensvertreterin) anhand der brasilianischen Behördenunterlagen. Sie können die Steueridentifikationsnummer nicht mehr ändern, sobald Sie sie einmal festgelegt haben.

| Typ der juristischen Person | Bestanden | Fehlgeschlagen | Sofortiges Offboarding erforderlich |
| --- | --- | --- | --- |
| Einzelpersonen (CPF) | Regulär | Gesperrt, Regularisierung ausstehend | Gelöscht, ungültig, verstorben |
| Juristische Personen (CNPJ) | Aktiv (Ativa), Regularisierung ausstehend (Ativa não regular) | Gesperrt (Suspensa) | Aufgelöst (Baixada), gelöscht (Baixada), ungeeignet (Inapta), ungültig (Nula), im Ausland ansässig |

Konten mit einer gesperrten CPF oder CNPJ werden beim Onboarding als gültig behandelt, müssen ihren Status jedoch innerhalb von etwa 30&nbsp;Tagen bereinigen. Sollte keine Bereinigung erfolgen, werden die Zahlungsfunktionen eingeschränkt. Bei Konten mit einem Status, der ein Offboarding erfordert (gelöscht, ungültig, verstorben, aufgelöst, ungeeignet), werden alle Funktionen sofort deaktiviert und können auch nicht durch das Hochladen von Dokumenten behoben werden.

### Finanzielle Leistungsfähigkeit

Die brasilianischen AML-Vorschriften verpflichten Stripe, die geschätzte finanzielle Leistungsfähigkeit eines verbundenen Kontos einzuziehen, bevor Zahlungen und Auszahlungen aktiviert werden. Dies gilt für alle brasilianischen Konten&nbsp;– sowohl für Einzelpersonen als auch für juristische Personen.

`monthly_estimated_revenue.amount` wird in der kleinsten Währungseinheit (Centavos) angegeben. Beispiel: 50.000&nbsp;BRL&nbsp;=&nbsp;`5000000`. Wir erfassen die Werte ausschließlich für die regulatorische Überwachung und verifizieren sie beim Onboarding nicht eigenständig.

### Fehlerbehebung

| Fehlercode | Auslöser | Sanierung |
| --- | --- | --- |
| `verification_failed_keyed_match` | CNPJ nicht gefunden oder der Unternehmensname bzw. die Adresse stimmt nicht mit dem CNPJ-Register überein. | Geben Sie den korrekten rechtsgültigen Namen und die registrierte Adresse erneut ein, oder laden Sie `company.verification.document` hoch. |
| `verification_failed_id_number_status_not_found` | CNPJ gefunden, aber der Steuerstatus konnte nicht abgerufen werden. | Erneut einreichen oder ein Dokument zur Verifizierung des Unternehmens hochladen. |
| `verification_failed_id_number_inactive` | CNPJ gefunden, aber der Status ist inaktiv (z.&nbsp;B. gesperrt, aufgelöst). | Bei eine dem Status „Gesperrt“ erhält das Konto eine Kulanzfrist, um den Status bei der Receita Federal zu bereinigen. Bei dem Status „Aufgelöst“, „Gelöscht“, „Ungeeignet“ oder „Ungültig“ wird das Konto deaktiviert&nbsp;– dies lässt sich nicht durch das Hochladen von Dokumenten lösen. |
| `verification_document_type_not_supported` | Das hochgeladene Unternehmensdokument ist unleserlich oder entspricht nicht dem erforderlichen Typ. | Laden Sie ein akzeptables Dokument zur Verifizierung des Unternehmens hoch. |
| `verification_document_name_mismatch` | Der Unternehmensname im Dokument stimmt nicht mit dem eingegebenen Namen überein. | Geben Sie den rechtsgültigen Namen genau so ein, wie er auf dem CNPJ-Zertifikat erscheint. |
| `verification_document_id_number_mismatch` | Die Steueridentifikationsnummer im Dokument stimmt nicht mit der eingegebenen CNPJ überein, oder der Status der Steueridentifikationsnummer wurde nicht gefunden bzw. ist inaktiv. | Laden Sie ein aktuelles CNPJ-Zertifikat der Receita Federal erneut hoch. |
| `verification_document_address_mismatch` | Die Adresse im Dokument stimmt nicht mit der eingegebenen Adresse überein. | Geben Sie die Adresse erneut ein, sodass sie mit der registrierten Adresse im CNPJ-Zertifikat übereinstimmt. |

## Autorisierungsnachweis

Alle Konten, die keinen `Einzelpersonen` in Brasilien gehören, erfordern die Verifizierung des Autorisierungsnachweises (PoA). Damit wird bestätigt, dass der/die Unternehmensvertreter/in autorisiert ist, im Namen des Unternehmens zu handeln.

Stripe unternimmt zunächst den Versuch einer programmgesteuerten Verifizierung durch einen Abgleich des Namens der Vertreterin oder des Vertreters mit dem CNPJ-Register. Wenn der Name der Vertreterin oder des Vertreters mit einer autorisierten Person im Register übereinstimmt, ist die Verifizierung automatisch erfolgreich und es sind keine weiteren Maßnahmen erforderlich. Schlägt die programmgesteuerte Überprüfung fehl, muss der/die Vertreter/in die Bescheinigung `company.representative_declaration` einreichen.

### Alternative zu den ursprünglichen Anforderungen

Für das `Konto` eines Unternehmens enthält das Array [alternatives](https://docs.stripe.com/api/accounts/object.md#account_object-requirements-alternatives) die erforderlichen Felder für die Vertretererklärung:

```json
{
  "alternatives": [
    {
      "original_fields_due": ["representative.first_name", "representative.last_name"],
      "alternative_fields_due": [
        "company.representative_declaration.date",
        "company.representative_declaration.ip",
        "representative.first_name",
        "representative.last_name"
      ]
    }
  ]
}
```

Wenn der erste von Stripe unternommene Versuch der Verifizierung von `representative.first_name` und `representative.last_name` fehlschlägt, muss die Plattform oder das Konto das Datum und die IP-Adresse der Bescheinigung der Vertreterin oder des Vertreters angeben. Vor- und Nachname sind ebenfalls weiterhin erforderlich (sowohl in `original_fields_due` als auch in `alternative_fields_due`).

### Fehlerstatus bei fehlgeschlagener programmgesteuerter Verifizierung

Wenn der angegebene Name nicht mit dem CNPJ-Register übereinstimmt, enthält das Array [requirements.errors](https://docs.stripe.com/api/accounts/object.md#account_object-requirements-errors) die für `person` spezifischen Anforderungen mit den Fehlercodes `verification_failed_representative_authority`. Außerdem wird das Array `alternatives` aktualisiert, um auf die `person`-ID in `original_fields_due` zu verweisen:

```json
{
  "errors": [
    { "requirement": "people.{{PERSON_ID}}.first_name", "code": "verification_failed_representative_authority" },
    { "requirement": "people.{{PERSON_ID}}.last_name", "code": "verification_failed_representative_authority" }
  ],
  "alternatives": [
    {
      "original_fields_due": [
        "company.name",
        "company.tax_id",
        "people.{{PERSON_ID}}.first_name",
        "people.{{PERSON_ID}}.last_name"
      ],
      "alternative_fields_due": [
        "company.representative_declaration.date",
        "company.representative_declaration.ip"
      ]
    },
    {
      "original_fields_due": ["company.owners_provided", "owners.first_name", "owners.last_name"],
      "alternative_fields_due": [
        "company.directors_provided",
        "company.owners_provided",
        "directors.first_name",
        "directors.last_name"
      ]
    },
    {
      "original_fields_due": ["company.owners_provided", "owners.first_name", "owners.last_name"],
      "alternative_fields_due": [
        "company.directors_provided",
        "company.owners_provided",
        "directors.first_name",
        "directors.last_name",
        "documents.proof_of_registration.files"
      ]
    },
    {
      "original_fields_due": ["company.owners_provided", "owners.first_name", "owners.last_name"],
      "alternative_fields_due": [
        "company.owners_provided",
        "documents.proof_of_ultimate_beneficial_ownership.files",
        "owners.first_name",
        "owners.last_name"
      ]
    }
  ]
}
```

### Reichen Sie die Vertretererklärung ein

Um eine fehlgeschlagene programmgesteuerte PoA-Verifizierung zu beheben, reichen Sie die Vertretererklärung ein:

```shell
curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}} \
  -u "{{PLATFORM_SECRET_KEY}}:" \
  -d "company[representative_declaration][date]={{UNIX_TIMESTAMP}}" \
  -d "company[representative_declaration][ip]={{USER_IP_ADDRESS}}" \
  -d "company[representative_declaration][user_agent]={{USER_AGENT}}"
```

Das Feld `date` ist ein Unix-Zeitstempel, der den Zeitpunkt angibt, zu dem der/die Vertreter/in der Erklärung zugestimmt hat. Das Feld `ip` ist die IP-Adresse der Vertreterin oder des Vertreters zu diesem Zeitpunkt. Das Feld `user_agent` ist optional, wird aber empfohlen.

Nachdem die Erklärung abgegeben wurde, werden PoA-Fehler gelöscht und das Konto kann mit den verbleibenden Anforderungen (z.&nbsp;B. UBO-Verifizierung) fortfahren.

### Fehlerbehebung

| Fehlercode | Auslöser | Sanierung |
| --- | --- | --- |
| `verification_failed_representative_authority` | Der Name der Vertreterin oder des Vertreters stimmt mit keiner autorisierten Person im CNPJ-Register überein. | Senden Sie `company.representative_declaration` mit `date` (Unix-Zeitstempel) und `ip` (IP-Adresse der Vertreterin oder des Vertreters), um die Autorisierung zu bestätigen. |

## UBO- und Beziehungsverifizierung

Gemäß den brasilianischen AML-Vorschriften (Circular BCB&nbsp;3978/20) müssen Inhaber/innen (UBOs) und Vorstände juristischer Personen identifiziert und deren rechtmäßige Eintragung ins CNPJ-Register verifiziert werden.

### Geltungsbereich der Vorschriften

Die folgenden Unternehmenstypen unterliegen den AML-Vorschriften:

| Verifizierungstyp | Unternehmensstrukturen |
| --- | --- |
| Verifizierung der Inhaber/innen (UBO) | Mehrpersonen-LLC (MMLLC), private Kapitalgesellschaft, private Personengesellschaft |
| Verifizierung der Vorstandsmitglieder | Öffentliche Kapitalgesellschaft, Regierungsstelle, gemeinnützige Organisation |
| Außerhalb des Geltungsbereichs | Einzelpersonen, Einzelunternehmen (MEI) |

### Informationen in der richtigen Reihenfolge erfassen

Erfassen Sie zuerst die Informationen zur Inhaberin/zum Inhaber (UBO). Wenn das Konto keine Inhaber/innen hat, beispielsweise wenn alle Anteilseigner juristische Personen statt natürlicher Personen sind, erfassen Sie stattdessen die Informationen zum Vorstand. Diese Wasserfall-Logik hilft Stripe, die Inhaberstruktur des Kontos in der effizientesten Reihenfolge zu verifizieren.

### So funktioniert die Verifizierung

Stripe empfiehlt, Inhaber/innen und Vorstandsmitglieder wie folgt anzugeben:

1. **Programmgesteuertes Vorausfüllen** (Private Vorschau): Nach Abschluss der KYB-Verifizierung können Sie die Namen der Inhaber/innen oder Vorstandsmitglieder über die API zum Vorausfüllen abrufen. Wenn Sie Personen angeben, deren Namen übereinstimmen, erfolgt die Verifizierung über einen einseitigen Abgleich. Unter [Informationen zu Inhaber/innen und Vorstandsmitgliedern vorausfüllen](https://docs.stripe.com/connect/upcoming-requirements-updates.md#prefill-owner-and-director-information) können Sie sich registrieren.
2. **Ausweichoption Dokumente**: Wenn die vorausgefüllten Namen nicht übereinstimmen, laden Sie `documents.proof_of_ultimate_beneficial_ownership` (für Inhaber/innen) oder `documents.proof_of_registration` (für Vorstandsmitglieder) hoch.
3. **Vorstandszuweisung**: Wenn Inhaber/innen nicht verifiziert werden können (z.&nbsp;B. weil alle Inhaber juristische Personen und keine Einzelpersonen sind), lösen Sie dies stattdessen über `company.directors_provided` und Vorstandsmitglieder.

### Erforderliche Felder für Personen

| Feld | Beschreibung |
| --- | --- |
| `person.first_name`, `person.last_name` | Vollständiger rechtsgültiger Name (muss für die programmgesteuerte Verifizierung mit dem CNPJ-Register übereinstimmen). |
| `person.id_number` | CPF (brasilianische Steueridentifikationsnummer für Einzelpersonen). |
| `person.dob.day`, `.month`, `.year` | Geburtsdatum. |
| `person.address.line1`, `.city`, `.state`, `.postal_code` | Brasilianische Wohnadresse. |
| `person.email` | E-Mail-Adresse. |
| `person.political_exposure` | Erklärung zu politischer Exponiertheit (`none` oder `existing`). |
| `person.relationship.owner` oder `person.relationship.director` | Funktion im Konto (`owner` für UBOs, `director` für Vorstandsmitglieder). |
| `person.relationship.percent_ownership` | Optional; bei Auslassung wird die Person als UBO (Schwellenwert >25&nbsp;%) behandelt. |

### Alternativen zu den ursprünglichen Anforderungen für Unternehmen

Wenn ein Unternehmenskonto erstellt wird, enthält das Array `requirements.alternatives` Alternativen für die drei Verifizierungspfade (Vorstandszuweisung, Vorstandszuweisung + Dokument, Dokumenten-Upload zu Inhaber/innen):

```json
{
  "currently_due": [
    "company.owners_provided",
    "owners.first_name",
    "owners.last_name",
    "owners.id_number",
    "owners.dob.day",
    "owners.dob.month",
    "owners.dob.year",
    "owners.address.line1",
    "owners.address.city",
    "owners.address.state",
    "owners.address.postal_code",
    "owners.email",
    "owners.political_exposure"
  ],
  "alternatives": [
    {
      "original_fields_due": ["company.owners_provided", "owners.first_name", "owners.last_name"],
      "alternative_fields_due": [
        "company.directors_provided",
        "company.owners_provided",
        "directors.first_name",
        "directors.last_name"
      ]
    },
    {
      "original_fields_due": ["company.owners_provided", "owners.first_name", "owners.last_name"],
      "alternative_fields_due": [
        "company.directors_provided",
        "company.owners_provided",
        "directors.first_name",
        "directors.last_name",
        "documents.proof_of_registration.files"
      ]
    },
    {
      "original_fields_due": ["company.owners_provided", "owners.first_name", "owners.last_name"],
      "alternative_fields_due": [
        "company.owners_provided",
        "documents.proof_of_ultimate_beneficial_ownership.files",
        "owners.first_name",
        "owners.last_name"
      ]
    }
  ]
}
```

Die drei Alternativen stellen unterschiedliche Möglichkeiten dar, um die Anforderung der Inhaberverifizierung zu erfüllen:

- **Vorstandszuweisung**: Ersetzen Sie die Inhaberverifizierung durch das Angeben der Vorstandsmitglieder (`company.directors_provided`, `directors.first_name`, `directors.last_name`).
- **Vorstandszuweisung + Dokument**: Geben Sie die Vorstandsmitglieder an und laden Sie eine Datei vom Typ `documents.proof_of_registration` hoch.
- **Dokumenten-Upload zu Inhaber/innen**: Geben Sie die Namen der Inhaber/innen an und laden Sie eine Datei vom Typ `documents.proof_of_ultimate_beneficial_ownership` hoch.

### Informationen zu Inhaber/innen und Vorstandsmitgliedern vorausfüllen (Private Vorschau)

Optional können Sie eine API integrieren, die programmgesteuert die mit einer juristischen Person verbundenen Inhaber/innen oder Vorstandsmitglieder erkennt und vorausfüllt. Das verbundene Konto kann die Beziehung durch eine Bestätigung der erkannten Informationen verifizieren, anstatt durch das Hochladen von Dokumenten.

Dieser Pfad kann die Verifizierungsquoten erhöhen und Abläufe vereinfachen, ist jedoch nicht für alle Konten geeignet. Für Konten, bei denen Stripe die Beziehungen nicht vorausfüllen kann, müssen Sie weiterhin mit Dokumenten-Uploads oder Vorstandszuweisungen arbeiten.

Wenn Sie an der Vorausfüllfunktion für die Inhaber- oder Vorstandsverifizierung interessiert sind, teilen Sie uns das bitte mit, indem Sie sich unten registrieren.

### Sind Sie daran interessiert, frühzeitigen Zugriff auf das Vorausfüllen von UBOs und Vorstandsmitgliedern auf Stripe zu erhalten?

Enter your email to request access.

```bash
curl https://docs.stripe.com/preview/register \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Referer: https://docs.stripe.com/connect/upcoming-requirements-updates" \
  -d '{"email": "EMAIL", "preview": "risk_requirements_beta_preview"}'
```

### Programmgesteuerter Inhaberabgleich

Erstellen Sie Inhaber/innen, die natürliche Personen sind und deren Namen mit dem CNPJ-Register übereinstimmen. Prüfen Sie anschließend, dass Inhaber/innen angegeben wurden. Wenn der Name der Inhaberin oder des Inhabers übereinstimmt, wird die Verifizierung programmgesteuert abgeschlossen. Sie können optional die [API zum Vorausfüllen](https://docs.stripe.com/connect/upcoming-requirements-updates.md#prefill-owner-and-director-information) (Private preview) verwenden, um vor dem Erstellen von Personen Namensvorschläge abzurufen.

```shell
# Create owner with matching name
curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}}/persons \
  -u "{{PLATFORM_SECRET_KEY}}:" \
  -d "first_name=Maria" \
  -d "last_name=Santos" \
  -d "id_number=123.456.789-09" \
  -d "dob[day]=15" \
  -d "dob[month]=6" \
  -d "dob[year]=1985" \
  -d "address[line1]=Rua das Flores, 123" \
  -d "address[city]=São Paulo" \
  -d "address[state]=SP" \
  -d "address[postal_code]=01310-100" \
  -d "email=maria@example.com" \
  -d "political_exposure=none" \
  -d "relationship[owner]=true" \
  -d "relationship[percent_ownership]=26"

# Confirm owners provided
curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}} \
  -u "{{PLATFORM_SECRET_KEY}}:" \
  -d "company[owners_provided]=true"
```

Wenn der Name der Inhaberin oder des Inhabers mit dem Register übereinstimmt, wird die Verifizierung programmgesteuert abgeschlossen.

### Hochladen von Inhaberdokumenten

Wenn der Name der Inhaberin oder des Inhabers nicht mit dem CNPJ-Register übereinstimmt (oder die programmgesteuerte Verifizierung nicht aktiviert ist), wird der Fehler `verification_missing_owners` angezeigt. Laden Sie einen UBO-Nachweis hoch, um das Problem zu beheben:

```shell
# 1. Upload the relationship document
curl https://files.stripe.com/v1/files \
  -u "{{PLATFORM_SECRET_KEY}}:" \
  -F "file=@/path/to/ownership_document.pdf" \
  -F "purpose=account_requirement"

# 2. Attach to account
curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}} \
  -u "{{PLATFORM_SECRET_KEY}}:" \
  -d "documents[proof_of_ultimate_beneficial_ownership][files][0]={{FILE_ID}}"
```

### Vorstandszuweisung

Wenn die Inhaberin oder der Inhaber nicht verifiziert werden kann (z.&nbsp;B. wenn alle Anteilseigner/innen juristische Personen sind), beheben Sie das Problem, indem Sie stattdessen Vorstandsmitglieder angeben:

```shell
# Create director person
curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}}/persons \
  -u "{{PLATFORM_SECRET_KEY}}:" \
  -d "first_name=Carlos" \
  -d "last_name=Oliveira" \
  -d "id_number=987.654.321-00" \
  -d "dob[day]=20" \
  -d "dob[month]=3" \
  -d "dob[year]=1978" \
  -d "address[line1]=Av Brasil, 500" \
  -d "address[city]=Rio de Janeiro" \
  -d "address[state]=RJ" \
  -d "address[postal_code]=20040-020" \
  -d "email=carlos@example.com" \
  -d "political_exposure=none" \
  -d "relationship[director]=true"

# Confirm directors and owners provided
curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}} \
  -u "{{PLATFORM_SECRET_KEY}}:" \
  -d "company[directors_provided]=true" \
  -d "company[owners_provided]=true"
```

### Akzeptierte Dokumente

Welche Dokumente zum Nachweis der Inhaberschaft akzeptiert werden, hängt davon ab, ob die Eigentümerstruktur einfach (alle Anteilseigner/innen sind natürliche Personen) oder komplex (mindestens ein Anteilseigner ist selbst eine juristische Person) ist:

#### Einfache Eigentümerstrukturen

Laden Sie einen *contrato social* oder *estatuto social* hoch. Das Dokument muss Folgendes enthalten:

- Den Namen und die CNPJ der juristischen Person
- Den vollständigen Namen und die CPF (oder das Geburtsdatum bei Personen ohne inländischen Wohnsitz) aller Anteilseigner/innen
- Anteile an der Inhaberschaft
- Unterschriften
- Stempel des Handelsregisters (Junta Comercial)

#### Komplexe Eigentümerstrukturen

Laden Sie die Vorlage für das Stripe-Bestätigungsschreiben ([UBO-Vorlage](https://docs.stripecdn.com/6e82842bfc01bd0b1c46d77f7d46b69673a9ca965ed2ad9ef53139f98abdbbaf.pdf) oder [Vorstands-Vorlage](https://docs.stripecdn.com/715ffef45157ff700bc368a4011659ee23bc8ba3c68746c5c15948a6eee1591f.pdf)) herunter, füllen Sie sie aus und laden Sie sie hoch. Unternehmen mit Zwischenschichten (Holdinggesellschaften, Trusts, Tochtergesellschaften), die die letztendlichen wirtschaftlichen Eigentümer/innen von der Betreibergesellschaft trennen, müssen diesen Weg nutzen.

### Fehlerbehebung

| Fehlercode | Auslöser | Sanierung |
| --- | --- | --- |
| `verification_missing_owners` | Angegebene Namen von Inhaber/innen stimmen mit keiner Inhaberin bzw. keinem Inhaber im CNPJ-Register überein. | Fügen Sie Personen mit Namen hinzu, die mit dem Register übereinstimmen, oder laden Sie `documents.proof_of_ultimate_beneficial_ownership` hoch. |
| `verification_missing_directors` | Angegebene Namen von Vorstandsmitgliedern stimmen mit keinem Vorstandsmitglied im CNPJ-Register überein. | Fügen Sie Personen mit Namen hinzu, die mit dem Register übereinstimmen, oder laden Sie `documents.proof_of_registration` hoch. |
| `verification_data_not_found` | Für diese juristische Person konnten keine Inhaber- oder Vorstandsdaten aus dem CNPJ-Register abgerufen werden. | Laden Sie `documents.proof_of_ultimate_beneficial_ownership` (für Inhaber/innen) oder `documents.proof_of_registration` (für Vorstandsmitglieder) hoch. |
| `verification_document_type_not_supported` | Das hochgeladene Beziehungsdokument ist unlesbar oder nicht die richtige Art von Dokument. | Laden Sie ein akzeptiertes Dokument hoch (contrato social, estatuto social oder Stripe-Bestätigungsvorlage). |

## Testen

Verwenden Sie [Sandboxes](https://docs.stripe.com/connect/testing.md), um zu überprüfen, ob Ihre Integration alle KYC-/KYB-Status verarbeitet.

### Test: Erfolgreiche KYC-Prüfung (Einzelperson)

```shell
# Create test account
curl https://api.stripe.com/v1/accounts \
  -u "{{TEST_SECRET_KEY}}:" \
  -H "Stripe-Version: 2026-03-25.dahlia;experimental_onboarding_preview=v2" \
  -d "type=custom" \
  -d "country=BR" \
  -d "capabilities[transfers][requested]=true"

# Submit person data (use test CPF: 000.000.001-91 for success)
curl https://api.stripe.com/v1/accounts/{{ACCT_ID}}/persons/{{PERSON_ID}} \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "first_name=Maria" \
  -d "last_name=Silva" \
  -d "id_number=000.000.001-91" \
  -d "dob[day]=15" \
  -d "dob[month]=6" \
  -d "dob[year]=1985" \
  -d "address[line1]=Rua das Flores, 123" \
  -d "address[city]=São Paulo" \
  -d "address[state]=SP" \
  -d "address[postal_code]=01310-100" \
  -d "address[country]=BR"
```

Um den Test auf erfolgreiche KYC-Prüfung abzuschließen, ist weiterhin ein `proof_of_liveness` erforderlich. Weitere Informationen finden Sie unter [Anforderungen an die Lebenderkennung verwalten](https://docs.stripe.com/connect/api-onboarding.md?accounts-namespace=v1&liveness=hosted#proof-of-liveness).

### Test: CPF inaktiv (`verification_document_id_number_mismatch`)

```shell
curl https://api.stripe.com/v1/accounts/{{ACCT_ID}}/persons/{{PERSON_ID}} \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "id_number=000.000.002-00"
```

Erwarteter Fehler in den Anforderungen:

```json
{
  "code": "verification_document_id_number_mismatch",
  "reason": "",
  "requirement": "person.id_number"
}
```

### Test: Erfolgreiche KYB-Prüfung (juristische Person)

```shell
# Create test company account
curl https://api.stripe.com/v1/accounts \
  -u "{{TEST_SECRET_KEY}}:" \
  -H "Stripe-Version: 2026-03-25.dahlia;experimental_onboarding_preview=v2" \
  -d "type=custom" \
  -d "country=BR" \
  -d "business_type=company" \
  -d "capabilities[transfers][requested]=true"

# Submit company data (use test CNPJ: 00.000.000/0001-91 for success)
curl https://api.stripe.com/v1/accounts/{{ACCT_ID}} \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "company[tax_id]=00.000.000/0001-91" \
  -d "company[name]=Empresa Teste Ltda" \
  -d "company[address][line1]=Avenida Paulista, 1000" \
  -d "company[address][city]=São Paulo" \
  -d "company[address][postal_code]=01310-100" \
  -d "company[address][country]=BR" \
  -d "business_profile[monthly_estimated_revenue][amount]=5000000" \
  -d "business_profile[monthly_estimated_revenue][currency]=brl"
```

### Test: schlüsselbasierter CNPJ-Abgleich fehlgeschlagen (`verification_failed_keyed_match`)

```shell
curl https://api.stripe.com/v1/accounts/{{ACCT_ID}} \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "company[tax_id]=00.000.000/0002-00" \
  -d "company[name]=Wrong Name Ltda"
```

Erwartete Fehler in den Anforderungen:

```json
[
  { "code": "verification_failed_keyed_match", "requirement": "company.tax_id" },
  { "code": "verification_failed_keyed_match", "requirement": "company.name" },
  { "code": "verification_failed_keyed_match", "requirement": "company.address.line1" }
]
```

Beheben Sie den Fehler, indem Sie ein Dokument zur Verifizierung des Unternehmens hochladen:

```shell
# 1. Upload CNPJ certificate PDF
curl https://files.stripe.com/v1/files \
  -u "{{TEST_SECRET_KEY}}:" \
  -F "file=@/path/to/cnpj_certificate.pdf" \
  -F "purpose=account_requirement"

# 2. Attach to account
curl https://api.stripe.com/v1/accounts/{{ACCT_ID}} \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "company[verification][document][front]={{FILE_ID}}"
```

### Test: erfolgreiche programmgesteuerte PoA-Verifizierung

Verwenden Sie `match_representative` als Vornamen der Vertreterin oder des Vertreters mit einer non-magic CNPJ. Der Testanbieter gibt eine erfolgreiche Übereinstimmung zurück und es ist keine Bescheinigung erforderlich.

```shell
# Create company account
curl https://api.stripe.com/v1/accounts \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "type=custom" \
  -d "country=BR" \
  -d "business_type=company" \
  -d "company[structure]=private_company" \
  -d "company[tax_id]=123456789" \
  -d "company[name]=Empresa Teste Ltda" \
  -d "company[address][line1]=address_full_match" \
  -d "company[address][city]=São Paulo" \
  -d "company[address][state]=SP" \
  -d "company[address][postal_code]=01310-100" \
  -d "capabilities[card_payments][requested]=true"

# Create representative with magic first_name
curl https://api.stripe.com/v1/accounts/{{ACCT_ID}}/persons \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "first_name=match_representative" \
  -d "last_name=Silva" \
  -d "id_number=000000000" \
  -d "dob[day]=1" \
  -d "dob[month]=1" \
  -d "dob[year]=1901" \
  -d "address[line1]=address_full_match" \
  -d "address[city]=São Paulo" \
  -d "address[state]=SP" \
  -d "address[postal_code]=01310-100" \
  -d "email=rep@example.com" \
  -d "political_exposure=none" \
  -d "relationship[representative]=true" \
  -d "relationship[title]=CEO"
```

Erwartet: Keine Fehler vom Typ `verification_failed_representative_authority`. Die PoA-Verifizierung wird programmgesteuert abgeschlossen. Es verbleiben nur die UBO-Anforderungen.

### Test: fehlgeschlagene PoA-Verifizierung mit Ausweichoption für die Bescheinigung

Verwenden Sie `mismatch_representative` als Vornamen der Vertreterin oder des Vertreters. Die programmgesteuerte Prüfung schlägt fehl und die Namensfelder der Person weisen den Fehler `verification_failed_representative_authority` auf.

```shell
# Create company account
curl https://api.stripe.com/v1/accounts \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "type=custom" \
  -d "country=BR" \
  -d "business_type=company" \
  -d "company[structure]=private_company" \
  -d "company[tax_id]=000000000" \
  -d "company[name]=Empresa Teste Ltda" \
  -d "company[address][line1]=address_full_match" \
  -d "company[address][city]=São Paulo" \
  -d "company[address][state]=SP" \
  -d "company[address][postal_code]=01310-100" \
  -d "capabilities[card_payments][requested]=true"

# Create representative with mismatch magic first_name
curl https://api.stripe.com/v1/accounts/{{ACCT_ID}}/persons \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "first_name=mismatch_representative" \
  -d "last_name=Silva" \
  -d "id_number=000000000" \
  -d "dob[day]=1" \
  -d "dob[month]=1" \
  -d "dob[year]=1901" \
  -d "address[line1]=address_full_match" \
  -d "address[city]=São Paulo" \
  -d "address[state]=SP" \
  -d "address[postal_code]=01310-100" \
  -d "email=rep@example.com" \
  -d "political_exposure=none" \
  -d "relationship[representative]=true" \
  -d "relationship[title]=CEO"
```

Erwartete Fehler in den Anforderungen:

```json
[
  { "code": "verification_data_not_found", "requirement": "directors.first_name" },
  { "code": "verification_data_not_found", "requirement": "directors.last_name" },
  { "code": "verification_data_not_found", "requirement": "owners.first_name" },
  { "code": "verification_data_not_found", "requirement": "owners.last_name" },
  { "code": "verification_failed_representative_authority", "requirement": "people.{{PERSON_ID}}.first_name" },
  { "code": "verification_failed_representative_authority", "requirement": "people.{{PERSON_ID}}.last_name" }
]
```

Fehler vom Typ `verification_data_not_found` treten auf, da das CNPJ-Register keine UBO-Daten für die Test-CNPJ zurückgegeben hat. Beheben Sie das Problem, indem Sie die Vertretererklärung einreichen:

```shell
curl https://api.stripe.com/v1/accounts/{{ACCT_ID}} \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "company[representative_declaration][date]=1772226508" \
  -d "company[representative_declaration][ip]=162.211.155.69"
```

Nach dem Einreichen werden die PoA-Fehler behoben und es verbleiben nur die UBO-Anforderungen.

### Test: Anforderungen über programmgesteuerten Inhaberabgleich erfüllen

Verwenden Sie die CNPJ `222221003`, um den Fehler `verification_missing_owners` auszulösen. Erstellen Sie zur Behebung eine/n Inhaber/in mit einem Namen, der mit dem CNPJ-Register übereinstimmt. Sie können optional die [API zum Vorausfüllen](https://docs.stripe.com/connect/upcoming-requirements-updates.md#prefill-owner-and-director-information) (Private preview) verwenden, um die erwarteten Namen abzurufen.

```shell
# Create company with magic CNPJ for missing owners
curl https://api.stripe.com/v1/accounts \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "type=custom" \
  -d "country=BR" \
  -d "business_type=company" \
  -d "company[structure]=private_company" \
  -d "company[tax_id]=222221003" \
  -d "company[name]=Empresa Teste Ltda" \
  -d "company[address][line1]=address_full_match" \
  -d "company[address][city]=São Paulo" \
  -d "company[address][state]=SP" \
  -d "company[address][postal_code]=01310-100" \
  -d "capabilities[card_payments][requested]=true"

# Create owner with name matching the CNPJ registry
curl https://api.stripe.com/v1/accounts/{{ACCT_ID}}/persons \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "first_name=match_representative" \
  -d "last_name=match_representative" \
  -d "id_number=000000000" \
  -d "dob[day]=1" \
  -d "dob[month]=1" \
  -d "dob[year]=1901" \
  -d "address[line1]=address_full_match" \
  -d "address[city]=São Paulo" \
  -d "address[state]=SP" \
  -d "address[postal_code]=01310-100" \
  -d "email=owner@example.com" \
  -d "political_exposure=none" \
  -d "relationship[owner]=true" \
  -d "relationship[percent_ownership]=26"

# Confirm owners provided
curl https://api.stripe.com/v1/accounts/{{ACCT_ID}} \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "company[owners_provided]=true"
```

Erwartet: Nach dem Festlegen von `owners_provided` werden alle Inhaberanforderungen abgeschlossen. Es verbleiben keine Fehler vom Typ `verification_missing_owners`.

### Test: Anforderungen durch das Hochladen von Inhaberdokumenten erfüllen (`verification_missing_owners`)

Verwenden Sie die CNPJ `222221003` und erstellen Sie eine Inhaberin oder einen Inhaber mit einem abweichenden Namen. Wenn der Fehler `verification_missing_owners` angezeigt wird, laden Sie einen UBO-Nachweis hoch, um das Problem zu beheben.

```shell
# Create non-matching owner
curl https://api.stripe.com/v1/accounts/{{ACCT_ID}}/persons \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "first_name=Carlos" \
  -d "last_name=NonMatch" \
  -d "id_number=000000000" \
  -d "dob[day]=1" \
  -d "dob[month]=1" \
  -d "dob[year]=1901" \
  -d "address[line1]=address_full_match" \
  -d "address[city]=São Paulo" \
  -d "address[state]=SP" \
  -d "address[postal_code]=01310-100" \
  -d "email=carlos@example.com" \
  -d "political_exposure=none" \
  -d "relationship[owner]=true"

# Set owners_provided
curl https://api.stripe.com/v1/accounts/{{ACCT_ID}} \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "company[owners_provided]=true"
```

Erwartete Fehler nach der Auswertung:

```json
[
  { "code": "verification_missing_owners", "requirement": "owners.first_name" },
  { "code": "verification_missing_owners", "requirement": "owners.last_name" }
]
```

Beheben Sie das Problem, indem Sie ein Dokument hochladen:

```shell
# Upload relationship document
curl https://files.stripe.com/v1/files \
  -u "{{TEST_SECRET_KEY}}:" \
  -F "file=@/path/to/ownership_doc.pdf" \
  -F "purpose=account_requirement"

# Attach to account
curl https://api.stripe.com/v1/accounts/{{ACCT_ID}} \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "documents[proof_of_ultimate_beneficial_ownership][files][0]={{FILE_ID}}"
```

### Test: Anforderungen über Vorstandszuweisung erfüllen

Verwenden Sie die CNPJ `222221004`, um den Verifizierungspfad für Vorstandsmitglieder auszulösen. Erstellen Sie Vorstandsmitglieder mit Namen, die mit dem CNPJ-Register übereinstimmen. Sie können optional die [API zum Vorausfüllen](https://docs.stripe.com/connect/upcoming-requirements-updates.md#prefill-owner-and-director-information) (Private preview) verwenden, um die erwarteten Namen abzurufen.

```shell
# Create company with magic CNPJ for missing directors
curl https://api.stripe.com/v1/accounts \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "type=custom" \
  -d "country=BR" \
  -d "business_type=company" \
  -d "company[structure]=private_company" \
  -d "company[tax_id]=222221004" \
  -d "company[name]=Empresa Teste Ltda" \
  -d "company[address][line1]=address_full_match" \
  -d "company[address][city]=São Paulo" \
  -d "company[address][state]=SP" \
  -d "company[address][postal_code]=01310-100" \
  -d "capabilities[card_payments][requested]=true"

# Create director with name matching the CNPJ registry
curl https://api.stripe.com/v1/accounts/{{ACCT_ID}}/persons \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "first_name=match_representative" \
  -d "last_name=match_representative" \
  -d "id_number=000000000" \
  -d "dob[day]=1" \
  -d "dob[month]=1" \
  -d "dob[year]=1901" \
  -d "address[line1]=address_full_match" \
  -d "address[city]=São Paulo" \
  -d "address[state]=SP" \
  -d "address[postal_code]=01310-100" \
  -d "email=director@example.com" \
  -d "political_exposure=none" \
  -d "relationship[director]=true"

# Confirm directors and owners provided
curl https://api.stripe.com/v1/accounts/{{ACCT_ID}} \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "company[directors_provided]=true" \
  -d "company[owners_provided]=true"
```

Erwartet: Nach dem Festlegen von `directors_provided` und `owners_provided` werden die Vorstands- und Inhaberanforderungen abgeschlossen.

### Test: Hochladen eines ungültigen Dokuments beheben (`verification_document_type_not_supported`)

Laden Sie ein ungültiges Beziehungsdokument hoch, um den Fehler `verification_document_type_not_supported` auszulösen. Laden Sie anschließend ein gültiges Dokument hoch, um das Problem zu beheben.

```shell
# Upload invalid document (use file_relationship_document_invalid magic value)
curl https://api.stripe.com/v1/accounts/{{ACCT_ID}} \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "documents[proof_of_ultimate_beneficial_ownership][files][0]=file_relationship_document_invalid"
```

Erwartete Fehler nach der Auswertung:

```json
[
  { "code": "verification_document_type_not_supported", "requirement": "documents.proof_of_ultimate_beneficial_ownership.files" },
  { "code": "verification_missing_owners", "requirement": "owners.first_name" },
  { "code": "verification_missing_owners", "requirement": "owners.last_name" }
]
```

Die Fehler vom Typ `verification_missing_owners` bleiben bestehen, da das Hochladen eines ungültigen Dokuments die Namensabweichung nicht behebt. Beheben Sie das Problem, indem Sie ein gültiges Dokument hochladen:

```shell
curl https://api.stripe.com/v1/accounts/{{ACCT_ID}} \
  -u "{{TEST_SECRET_KEY}}:" \
  -d "documents[proof_of_ultimate_beneficial_ownership][files][0]=file_relationship_document_success"
```

#### Programm - Singapur

*Zuletzt aktualisiert am 12.&nbsp;Juni&nbsp;2026*

## Änderungen an den Verifizierungsanforderungen verstehen

Um den überarbeiteten Anforderungen der Monetary Authority of Singapore (MAS) PSN01 zu entsprechen, aktualisiert Stripe die Anforderungen an die Verifizierung von Unternehmen (Know Your Business, KYB) und den wirtschaftlichen Eigentümern/Eigentümerinnen (UBO).

Wenn Ihre verbundenen Konten in Singapur betrieben werden, müssen Sie möglicherweise Ihren Onboarding- und Sanierungsablauf aktualisieren. Wenn Sie die erforderlichen Aktualisierungen nicht vornehmen, wird der Zugriff Ihrer verbundenen Konten auf Zahlungen und Finanzdienstleistungen unterbrochen.

## Wahl eines Integrationsansatzes

Stripe empfiehlt, Stripe-gehostetes oder eingebettetes Onboarding zu verwenden, um Anforderungen zur Geschäfts- und Identitätsverifizierung zu erfassen. Diese Optionen erfordern weniger Ressourcen für Implementierung und Wartung als die Nutzung des API-Onboardings. Die folgende Tabelle beschreibt die wichtigsten Unterschiede:

- [Von Stripe gehostetes Onboarding](https://docs.stripe.com/connect/hosted-onboarding.md): (Empfohlen) Senden Sie Konten zu einem Stripe-gehosteten Flow, damit die erforderlichen Informationen übermittelt werden.
- [Eingebettetes Onboarding](https://docs.stripe.com/connect/embedded-onboarding.md): (Empfohlen) Betten Sie von Stripe bereitgestellte Onboarding-Komponenten ein, mit denen Konten Informationen direkt aus Ihrer App an Stripe übermitteln können.
- [API Onboarding](https://docs.stripe.com/connect/api-onboarding.md): Erstellen und verwalten Sie einen benutzerdefinierten Onboarding-Ablauf mithilfe der Stripe-APIs.

|  | **Von Stripe gehostetes Onboarding** | **Eingebettetes Onboarding** | **API-Onboarding** |
| --- | --- | --- | --- |
| Ideal für Folgendes | Plattformen, die möchten, dass Stripe das Onboarding übernimmt | Plattformen, die einen markeneigenen In-App-Onboarding-Ablauf wünschen | Plattformen, die die volle Kontrolle benötigen und diesen Ablauf aufbauen und pflegen können |
| Anfänglicher Implementierungsaufwand | 3–4 Engineering-Wochen | 3–4 Engineering-Wochen | 30–40 Engineering-Wochen |
| Laufende Bemühungen, Anforderungsaktualisierungen umzusetzen | Wird automatisch von Stripe erledigt | Wird automatisch von Stripe erledigt | Erfordert eine proaktive Überwachung auf bevorstehende Änderungen sowie technische Ressourcen, um den Onboarding-Ablauf für jede Änderung zu aktualisieren |
| Anpassung | Von Stripe gehostete Schnittstelle mit Plattform-Branding | Hochgradig themenfähige Komponente, auf die Konten über die Plattform-App zugreifen | Die Plattform entwirft, erstellt und verwaltet die Benutzeroberfläche |
| Bemühungen um Support weiterer Länder | Wird automatisch von Stripe erledigt | Wird automatisch von Stripe erledigt | Erfordert technische Ressourcen, um den Onboarding-Ablauf für jedes zusätzliche Land zu aktualisieren |

Erfahren Sie mehr über [Onboarding-Optionen von Connect](https://docs.stripe.com/connect/onboarding.md) und die [Migration Ihrer API-basierten Onboarding- und Sanierungsabläufe auf von Stripe gehostete oder eingebettete Abläufe](https://docs.stripe.com/connect/migrate-from-api-onboarding.md).

Plattformen, die von Stripe gehostetes oder eingebettetes Onboarding verwenden, müssen ihre Integrationen für diese Anforderungsaktualisierungen nicht anpassen&nbsp;– Stripe übernimmt dies automatisch für sie. Plattformen mit API-basiertem Onboarding müssen Anforderungsänderungen aktiv verfolgen und für jede Aktualisierung Engineering-Ressourcen bereitstellen.

## Übersicht der API-Integration

Wenn Ihre Plattform API-basiertes Onboarding verwendet, aktualisieren Sie Ihre Integration, um die folgenden Änderungen für verbundene Konten in Singapur zu verarbeiten:

- **KYB: Unternehmensdetails und Verifizierung der juristischen Person:** Erfassen Sie [Unternehmensdetails und Felder für die juristische Person](https://docs.stripe.com/connect/upcoming-requirements-updates.md#kyb-business-details-and-legal-entity-verification), einschließlich Gründungsdatum, Hauptniederlassung und Verwaltungsort.
- **Verifizierung der registrierten Adresse:** Verarbeiten Sie die [Verifizierung der registrierten Adresse](https://docs.stripe.com/connect/upcoming-requirements-updates.md#registered-address-verification), wenn Stripe die registrierte Adresse nicht automatisch verifizieren kann.
- **Constitution document verification:** Collect a [constitution document](https://docs.stripe.com/connect/upcoming-requirements-updates.md#constitution-document-verification) for companies, partnerships, and non-profits when required.
- **UBO- und Beziehungsverifizierung:** Erfassen Sie bei Bedarf [Informationen zur UBO- und Beziehungsverifizierung](https://docs.stripe.com/connect/upcoming-requirements-updates.md#ubo-and-relationship-verification) für Inhaber/innen, Geschäftsführer/innen und leitende Angestellte.

Vor der Durchsetzung können Sie [future_requirements](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements) überwachen, um eine Vorschau auf anstehende Anforderungen zu erhalten. Nachdem die Anforderungen aktiv geworden sind, überwachen Sie den `requirements`-Hash des Kontos und warten Sie auf den Webhook `account.updated`, um Änderungen an den Anforderungen zu erkennen.

Stellen Sie sicher, dass Ihre Integration so eingerichtet ist, dass sie [Verifizierungsaktualisierungen verarbeitet](https://docs.stripe.com/connect/handle-verification-updates.md), wenn Sie neues Onboarding für Konten durchführen und aktualisierte Informationen von bestehenden Konten erfassen.

## Zeitplan für Anforderungen

Der folgende Zeitplan erläutert die wichtigsten Meilensteine für diese Änderungen. Aktualisieren und testen Sie Ihre Integration frühzeitig, um Probleme beim Inkrafttreten der neuen Anforderungen zu vermeiden.

| Datum | Meilenstein | Beschreibung |
| --- | --- | --- |
| Juli&nbsp;2026 | Integrationsplanung starten | Machen Sie sich mit diesem Leitfaden und den Änderungen vertraut, um mit der Planung Ihrer Integrationsaktualisierungen zu beginnen. |
| September&nbsp;2026 | Die Einführung von `future_requirements` beginnt (API-Onboarding). | Für Plattformen, die API-Onboarding verwenden, beginnt Stripe sowohl für neue als auch für bestehende Konten mit dem Hinzufügen der neuen Anforderungen zu `future_requirements`. |
| 1.&nbsp;November&nbsp;2026 | Einführung der neuen Anforderungen beginnt | Stellen Sie sicher, dass Ihr aktualisierter Onboarding-Prozess bereit ist, die neuen Anforderungen zu erfassen. Ihr aktualisierter Prozess muss bis zum 1.&nbsp;November funktionieren, wenn Stripe mit der Einführung der neuen Anforderungen beginnt. Alle neuen Anforderungen werden Ende November wirksam. |

## KYB: Unternehmensdetails und Verifizierung der juristischen Person

Stripe aktualisiert die KYB-Anforderungen für Konten in Singapur, die keine [Einzelpersonen](https://docs.stripe.com/api/accounts/object.md#account_object-business_type) sind. Diese Anforderungen umfassen neue Felder für [Unternehmen](https://docs.stripe.com/api/accounts/object.md#account_object-company) und die Verifizierung von registrierten Unternehmensinformationen.

### Erforderliche Felder

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `company.registration_date` (New) | Objekt mit `day`, `month` und `year` | Datum der Unternehmensgründung. |
| `company.address` | [Address](https://docs.stripe.com/api/accounts/object.md#account_object-company-address)-Objekt | Registrierte Geschäftsadresse (neue Verifizierung der bestehenden Anforderung) |
| `company.principal_place_of_business` (New) | [Address](https://docs.stripe.com/api/accounts/object.md#account_object-company-address)-Objekt | Hauptstandort, an dem das Unternehmen seine Geschäftstätigkeit ausübt. |
| `company.administrative_address` (New) | [Address](https://docs.stripe.com/api/accounts/object.md#account_object-company-address)-Objekt | Standort, an dem das Unternehmen verwaltet wird. |

Wenn Adressen übereinstimmen, senden Sie dieselben Adresswerte für jede Adresse. Überspringen Sie keine davon.

Erstellen Sie ein Unternehmenskonto in Singapur. Verwenden Sie die zurückgegebene Konto-ID in den folgenden Beispielen.

```curl
curl https://api.stripe.com/v1/accounts \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d country=SG \
  -d type=custom \
  -d business_type=company \
  -d "capabilities[card_payments][requested]=true" \
  -d "capabilities[transfers][requested]=true"
```

### Erste Antwort auf Anforderungen

Der `requirements`-Hash des neuen Kontos enthält Einträge wie:

```json
{
  "currently_due": [
    "company.registration_date.day",
    "company.registration_date.month",
    "company.registration_date.year",
    "company.address.line1",
    "company.address.postal_code",
    "company.principal_place_of_business.line1",
    "company.principal_place_of_business.postal_code",
    "company.administrative_address.line1",
    "company.administrative_address.postal_code"
  ]
}
```

Die Felder in `currently_due` bleiben dort, bis Sie Werte dafür angeben.

### Unternehmensdetails erfassen

Das folgende Beispiel zeigt, wie die neuen Anforderungen gesendet werden:

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "company[registration_date][day]=20" \
  -d "company[registration_date][month]=3" \
  -d "company[registration_date][year]=2015" \
  --data-urlencode "company[address][line1]=60 Anson Road #05-01" \
  -d "company[address][postal_code]=079914" \
  --data-urlencode "company[principal_place_of_business][line1]=60 Anson Road #05-01" \
  -d "company[principal_place_of_business][postal_code]=079914" \
  --data-urlencode "company[administrative_address][line1]=1 Raffles Place #30-01" \
  -d "company[administrative_address][postal_code]=048616"
```

### Verifizierung der registrierten Adresse

Die registrierte Adresse (`company.address`) ist für Konten in Singapur bereits obligatorisch. Mit dieser Aktualisierung wird die Verifizierung der registrierten Adresse als Teil der Verifizierung der juristischen Person hinzugefügt.

Wenn Stripe die registrierte Adresse des Kontos nicht verifizieren kann, überprüfen Sie den `requirements`-Hash des Kontoobjekts. Dieser zeigt an, bei welchen Adressfeldern die Verifizierung fehlgeschlagen ist, listet `company.verification.document` als alternative Möglichkeit zur Erfüllung der Anforderung auf und enthält Details im [`errors`](https://docs.stripe.com/api/accounts/object.md#account_object-requirements-errors)-Array:

```json
{
  "currently_due": [
    "company.address.line1",
    "company.address.postal_code"
  ],
  "alternatives": [
    {
      "original_fields_due": [
        "company.address.line1",
        "company.address.postal_code"
      ],
      "alternative_fields_due": [
        "company.verification.document"
      ]
    }
  ],
  "errors": [
    {
      "code": "verification_failed_keyed_match",
      "reason": "We couldn't verify the account's information.",
      "requirement": "company.address.line1"
    },
    {
      "code": "verification_failed_keyed_match",
      "reason": "We couldn't verify the account's information.",
      "requirement": "company.address.postal_code"
    }
  ]
}
```

Um die Anforderung zu erfüllen, erfassen Sie ein akzeptiertes Verifizierungsdokument des Unternehmens vom verbundenen Konto.

- Für lokal gegründete Unternehmen: Ein [BizFile](https://www.bizfile.gov.sg/)-Profil der [Accounting and Corporate Regulatory Authority (ACRA)](https://www.acra.gov.sg/).
- Für Vereinigungen: Eine Registrierungsbescheinigung oder eine Jahreserklärung, die beim [Registry of Societies (ROS)](https://www.mha.gov.sg/what-we-do/registry-of-societies) eingereicht wurde.
- Für Einrichtungen im Zusammenhang mit dem [Majlis Ugama Islam Singapura (MUIS)](https://www.muis.gov.sg/): Ein Schreiben der MUIS, das die registrierte Adresse enthält.

Unternehmensverifizierungsdokument hochladen.

```bash
curl https://files.stripe.com/v1/files \
  -u <<YOUR_SECRET_KEY>>: \
  -F "file"="@/path/to/company_verification_document.pdf" \
  -F "purpose"="account_requirement"
```

Dokument zur Unternehmensverifizierung an Konto anhängen.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "company[verification][document][front]={{FILE_ID}}"
```

## Verifizierung des Gründungsdokuments

Companies, non-profit organizations, and partnerships must satisfy the constitution document requirement. This requirement doesn’t apply to sole proprietorships or individuals.

| Kontoklassifizierung | API-Werte | Anforderung an das Gründungsdokument |
| --- | --- | --- |
| Privates Unternehmen | `business_type=company` mit `company.structure=private_company` | Erforderlich, es sei denn, ACRA bestätigt, dass das Konto eine Model Constitution verwendet. |
| Öffentliches Unternehmen | `business_type=company` mit `company.structure=public_company` | Erforderlich, es sei denn, ACRA bestätigt, dass das Konto eine Model Constitution verwendet. |
| Gemeinnützige Organisation | `business_type=non_profit` | Erforderlich, wenn es in den Anforderungen des Kontos zurückgegeben wird. |
| Partnership | `business_type=company` with `company.structure=private_partnership` | Erforderlich, wenn es in den Anforderungen des Kontos zurückgegeben wird. |
| Einzelunternehmen oder Einzelperson | `business_type=company` mit `company.structure=sole_proprietorship` oder `business_type=individual` | Nicht erforderlich. |

Wenn ACRA bestätigt, dass die juristische Person eine [Model Constitution](https://sso.agc.gov.sg/SL/CoA1967-S833-2015?DocDate=20151231) angenommen hat, ist die Anforderung an das Gründungsdokument automatisch erfüllt und es ist kein Dokumenten-Upload erforderlich.

Andernfalls müssen Sie das Dokument erfassen und als `documents.company_memorandum_of_association.files` senden. Stripe überprüft das Dokument, um Einzelpersonen zu identifizieren, die wesentliche Kontrolle, Befugnisse oder Vollmachten über die juristische Person haben. Sie müssen alle diese Einzelpersonen als UBOs zum Konto hinzufügen, um die Anforderungen zu erfüllen.

| Feld | Typ |
| --- | --- |
| `documents.company_memorandum_of_association.files` (New) | Datei hochladen |

### Erste Antwort auf Anforderungen

Wenn ein Gründungsdokument erforderlich ist, enthält der `requirements`-Hash des Kontos:

```json
{
  "currently_due": [
    "documents.company_memorandum_of_association.files"
  ]
}
```

### Gründungsdokument hochladen

Das folgende Beispiel zeigt, wie ein benutzerdefiniertes Gründungsdokument hochgeladen wird:

```bash
curl https://files.stripe.com/v1/files \
  -u <<YOUR_SECRET_KEY>>: \
  -F "file"="@/path/to/constitution.pdf" \
  -F "purpose"="account_requirement"
```

Fügen Sie das Gründungsdokument zum Konto hinzu.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "documents[company_memorandum_of_association][files][]={{FILE_ID}}"
```

### Fehlerbehebung

Beheben Sie die standardmäßigen [Fehler bei der Dokumentenverifizierung](https://docs.stripe.com/connect/handling-api-verification.md#handle-document-verification-problems) für Uploads von Gründungsdokumenten.

## UBO- und Beziehungsverifizierung

Die UBO-Anforderungen für Singapur hängen vom Unternehmenstyp des verbundenen Kontos ab.

1. Private Unternehmen müssen Inhaberinnen und Inhaber identifizieren und hinzufügen. Wenn Stripe keine Personen identifiziert, die 25&nbsp;% oder mehr des Unternehmens besitzen, behandelt Stripe die Vorstände des Unternehmens als UBOs.
2. Gemeinnützige Organisationen müssen Vorstände und leitende Angestellte identifizieren und hinzufügen.
3. Einige juristische Personen können sich für eine UBO-Ausnahme qualifizieren, wie z.&nbsp;B. berechtigte Finanzinstitute oder juristische Personen, die zu 75&nbsp;% oder mehr im Besitz von qualifizierten Holdinggesellschaften sind.

### Erforderliche Felder

| API-Feld der Person | Beschreibung |
| --- | --- |
| `person.first_name`, `person.last_name` | Rechtsgültiger Name. |
| `person.full_name_aliases` | [Namensaliasse](https://docs.stripe.com/api/persons/object.md#person_object-full_name_aliases). |
| `person.id_number` | Nationale Identifikationsnummer (NRIC oder FIN für in Singapur ansässige Personen). |
| `person.nationality` (New) | Aus zwei Buchstaben bestehender Ländercode ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)). |
| `person.dob` (New) | [Geburtsdatum](https://docs.stripe.com/api/persons/object.md#person_object-dob). |
| `person.address` (New) | [Wohnadresse](https://docs.stripe.com/api/persons/object.md#person_object-address). |

Für UBO-Inhaberinnen und -Inhaber sowie Vorstände verifiziert Stripe den rechtsgültigen Namen und die ID-Nummer. Stripe erhebt für SG ORR nur Aliasse, Nationalität, Geburtsdatum und Wohnadresse. Diese Felder lösen keine separate Verifizierung aus.

Die erforderlichen Personenfelder verwenden Pfade mit Funktions-Präfix im `requirements`-Hash des Kontos:

```json
{
  "currently_due": [
    "company.owners_provided",
    "company.directors_provided",
    "owners.first_name",
    "owners.last_name",
    "owners.id_number",
    "owners.full_name_aliases",
    "owners.nationality",
    "owners.dob.day",
    "owners.dob.month",
    "owners.dob.year",
    "owners.address.line1",
    "owners.address.postal_code",
    "directors.first_name",
    "directors.last_name",
    "directors.id_number",
    "directors.full_name_aliases",
    "directors.nationality",
    "directors.dob.day",
    "directors.dob.month",
    "directors.dob.year",
    "directors.address.line1",
    "directors.address.postal_code"
  ]
}
```

Abhängig vom Kontostatus sind einige Felder möglicherweise bereits ausgefüllt oder vorausgefüllt. Senden Sie die Felder, die in den Arrays `requirements.currently_due`, `requirements.eventually_due` oder `requirements.past_due` des Kontos erscheinen.

### UBO-Felder übermitteln

Wenn Stripe die [Person](https://docs.stripe.com/api/persons/object.md) bereits erstellt oder vorausgefüllt hat, aktualisieren Sie diese [Person](https://docs.stripe.com/api/persons/object.md) mit den fehlenden Feldern.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}}/persons/{{PERSON_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d nationality=SG \
  -d "dob[day]=15" \
  -d "dob[month]=6" \
  -d "dob[year]=1985" \
  --data-urlencode "address[line1]=10 Bayfront Avenue #01-01" \
  -d "address[city]=Singapore" \
  -d "address[postal_code]=018956" \
  -d "address[country]=SG"
```

Wenn Sie eine neue UBO-[Person](https://docs.stripe.com/api/persons/object.md) erstellen, geben Sie die Beziehung der Person, den rechtsgültigen Namen, die ID-Nummer, Aliasse, die Nationalität, das Geburtsdatum und die Wohnadresse an.

#### Inhaberinnen und Inhaber als UBOs für Unternehmen

Bei privaten Unternehmen versucht Stripe anhand von behördlichen Unterlagen Personen zu identifizieren, die 25&nbsp;% oder mehr des Unternehmens besitzen. Wenn Stripe Inhaberinnen und Inhaber identifiziert, listen Sie die Personen des Kontos auf, um die vorausgefüllten Datensätze der Inhaberinnen und Inhaber zu finden.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}}/persons \
  -u "<<YOUR_SECRET_KEY>>:"
```

Aktualisieren Sie die Angaben zu jeder Inhaberin und jedem Inhaber mit allen fehlenden Feldern, die in den Anforderungen des Kontos zurückgegeben werden.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}}/persons/{{PERSON_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d nationality=SG \
  -d "dob[day]=15" \
  -d "dob[month]=6" \
  -d "dob[year]=1985" \
  --data-urlencode "address[line1]=10 Bayfront Avenue #01-01" \
  -d "address[city]=Singapore" \
  -d "address[postal_code]=018956" \
  -d "address[country]=SG"
```

Nachdem alle erforderlichen Inhaberinnen und Inhaber hinzugefügt oder aktualisiert wurden, setzen Sie `company.owners_provided=true`, wenn dieses Feld in den Anforderungen des Kontos angezeigt wird.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "company[owners_provided]=true"
```

#### Vorstände als UBOs für Unternehmen

Wenn Stripe keine Personen identifiziert, die 25&nbsp;% oder mehr eines privaten Unternehmens besitzen, kann Stripe in Regierungsunterlagen aufgeführte Vorstände als UBOs behandeln. In diesem Fall enthalten die Anforderungen des Kontos Felder mit Vorstands-Präfix.

```json
{
  "currently_due": [
    "company.directors_provided",
    "directors.first_name",
    "directors.last_name",
    "directors.id_number",
    "directors.full_name_aliases",
    "directors.nationality",
    "directors.dob.day",
    "directors.dob.month",
    "directors.dob.year",
    "directors.address.line1",
    "directors.address.postal_code"
  ]
}
```

Erstellen Sie für jeden erforderlichen Vorstand eine [Person](https://docs.stripe.com/api/persons/object.md) mit der Vorstandsbeziehung.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}}/persons \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "relationship[director]=true" \
  -d "first_name=Kai Ming" \
  -d last_name=Wong \
  -d id_number=S0000001A \
  -d nationality=SG \
  -d "dob[day]=20" \
  -d "dob[month]=3" \
  -d "dob[year]=1980" \
  --data-urlencode "address[line1]=1 Raffles Place #30-01" \
  -d "address[city]=Singapore" \
  -d "address[postal_code]=048616" \
  -d "address[country]=SG"
```

Nachdem alle erforderlichen Vorstände hinzugefügt wurden, setzen Sie `company.directors_provided=true`.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "company[directors_provided]=true"
```

Stripe kann auch eine Vorstandserklärung verlangen, um zu bestätigen, dass die Liste der Vorstände auf dem Konto aktuell und vollständig ist. Die Anforderung kann angezeigt werden, wenn Stripe die Vorstände auf dem Konto anhand von Regierungsunterlagen überprüfen muss, einschließlich wenn fehlende Vorstände identifiziert werden:

```json
{
  "currently_due": [
    "company.directorship_declaration.date",
    "company.directorship_declaration.ip"
  ]
}
```

Wenn diese Felder in den Anforderungen des Kontos aufgeführt sind, reichen Sie die Vorstandserklärung ein.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "company[directorship_declaration][date]=1719360000" \
  -d "company[directorship_declaration][ip]=203.0.113.42"
```

#### Vorstände und leitende Angestellte als UBOs für gemeinnützige Organisationen

Erheben Sie bei gemeinnützigen Organisationen UBO-Informationen für Vorstände und leitende Angestellte, nicht für Inhaberinnen und Inhaber.

Bei in Singapur registrierten Wohltätigkeitsorganisationen versucht Stripe, diese Personen anhand der verfügbaren behördlichen Unterlagen zu identifizieren.

Bei anderen gemeinnützigen Organisationen muss Ihre Plattform jeden erforderlichen Vorstand oder jede/n leitende/n Angestellte/n als [Person](https://docs.stripe.com/api/persons/object.md) im Konto hinzufügen.

Die Anforderungen des Kontos verwenden Pfade mit Vorstands-Präfix:

```json
{
  "currently_due": [
    "company.directors_provided",
    "directors.first_name",
    "directors.last_name",
    "directors.id_number",
    "directors.full_name_aliases",
    "directors.nationality",
    "directors.dob.day",
    "directors.dob.month",
    "directors.dob.year",
    "directors.address.line1",
    "directors.address.postal_code"
  ]
}
```

Erstellen Sie für jeden Vorstand oder jede/n leitende/n Angestellte/n eine [Person](https://docs.stripe.com/api/persons/object.md) mit der Vorstandsbeziehung.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}}/persons \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "relationship[director]=true" \
  -d first_name=Aisha \
  -d "last_name=Binte Hassan" \
  -d id_number=S0000002B \
  -d nationality=SG \
  -d "dob[day]=10" \
  -d "dob[month]=9" \
  -d "dob[year]=1975" \
  --data-urlencode "address[line1]=5 Shenton Way #10-01" \
  -d "address[city]=Singapore" \
  -d "address[postal_code]=068808" \
  -d "address[country]=SG"
```

Nachdem alle erforderlichen Vorstände oder leitenden Angestellten hinzugefügt wurden, setzen Sie `company.directors_provided=true`.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "company[directors_provided]=true"
```

### Nachweis des UBO-Dokuments als Fallback

Wenn Stripe die UBOs des Kontos nicht ermitteln kann, muss das Konto ein [Dokument zum Nachweis der Identität der wirtschaftlich berechtigten Person](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship#select-a-country-to-view-its-requirements) vorlegen. Das Dokument muss die UBOs des Kontos identifizieren und einen Eigentumsnachweis für alle Holdinggesellschaften enthalten, die 25&nbsp;% oder mehr des Kontos besitzen.

Die Anforderungen des Kontos umfassen:

```json
{
  "currently_due": [
    "documents.proof_of_ultimate_beneficial_ownership.files"
  ]
}
```

Laden Sie das [Dokument zum Nachweis der Identität der wirtschaftlich berechtigten Person](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship#select-a-country-to-view-its-requirements) hoch.

```bash
curl https://files.stripe.com/v1/files \
  -u <<YOUR_SECRET_KEY>>: \
  -F "file"="@/path/to/proof_of_ubo.pdf" \
  -F "purpose"="account_requirement"
```

Fügen Sie das Dokument zum Konto hinzu.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "documents[proof_of_ultimate_beneficial_ownership][files][]={{FILE_ID}}"
```

Fügen Sie nach der Überprüfung des Dokuments alle im Dokument identifizierten UBOs als [Persons](https://docs.stripe.com/api/persons/object.md) zum Konto hinzu. Verwenden Sie die von den Kontoanforderungen zurückgegebene Beziehung, wie z.&nbsp;B. `relationship.owner=true` oder `relationship.director=true`, und füllen Sie alle zurückgegebenen Felder für Inhaberinnen/Inhaber oder Vorstände aus.

### UBO-Ausnahme

In einigen Fällen kann sich eine juristische Person für eine Eigentumsausnahme qualifizieren. Wenn das Konto berechtigt ist, geben Sie `company.ownership_exemption_reason` an.

| Grund für die Ausnahme | Wann wird es verwendet? |
| --- | --- |
| `qualifies_as_financial_institution` | Verwenden Sie dies, wenn die juristische Person im [MAS Financial Institution Directory](https://eservices.mas.gov.sg/fid) aufgeführt ist. |
| `qualified_entity_exceeds_ownership_threshold` | Verwenden Sie dies, wenn die juristische Person zu 75&nbsp;% oder mehr im Besitz von qualifizierten Holdinggesellschaften ist, z.&nbsp;B. staatlichen Einrichtungen Singapurs, Investment- oder Finanzfirmen oder börsennotierten Unternehmen. |

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "company[ownership_exemption_reason]=qualifies_as_financial_institution"
```

Wenn Stripe den Grund für die Ausnahme ablehnt, erhält das Konto den Fehler `verification_rejected_ownership_exemption_reason`. Das Konto muss dann die erforderlichen Eigentumsinformationen angeben oder ein [Dokument zum Nachweis der Identität der wirtschaftlich berechtigten Person](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship) einreichen.

### Fehlerbehebung

| Fehlercode | Wann dies auftreten kann | Sanierung |
| --- | --- | --- |
| `verification_missing_owners` | Stripe hat fehlende wirtschaftlich Berechtigte identifiziert. | Fügen Sie die erforderlichen Inhaber/innen hinzu oder stellen Sie auf Anfrage ein [Dokument zum Nachweis der letztendlichen wirtschaftlichen Eigentümerschaft](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship) bereit. |
| `verification_missing_directors` | Stripe hat fehlende Vorstände identifiziert. | Fügen Sie die erforderlichen Vorstände hinzu und setzen Sie `company.directors_provided=true`. |
| `verification_directors_mismatch` | Die Vorstandsangaben für das Konto stimmen nicht mit den amtlichen Dokumenten überein. | Fügen Sie die erforderlichen Vorstandsmitglieder hinzu oder aktualisieren Sie diese, damit das Konto mit den amtlichen Dokumenten übereinstimmt, und legen Sie dann `company.directors_provided=true` fest. |
| `verification_document_directors_mismatch` | Die Vorstandsinformationen in einem eingereichten Dokument stimmen nicht mit den Kontoinformationen überein. | Fügen Sie die erforderlichen Vorstände hinzu oder aktualisieren Sie diese, oder stellen Sie korrigierte Belegdokumente bereit. |
| `verification_requires_additional_proof_of_registration` | Stripe benötigt weitere Informationen zur Eigentümerstruktur des Kontos. | Stellen Sie ein [Dokument zum Nachweis der letztendlichen wirtschaftlichen Eigentümerschaft](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship) mit den erforderlichen Eigentumsinformationen bereit. |
| `verification_rejected_ownership_exemption_reason` | Stripe hat den eingereichten Grund für die Ausnahme der Eigentümerschaft abgelehnt. | Fügen Sie die erforderlichen UBOs hinzu oder stellen Sie das erforderliche [Dokument zum Nachweis der letztendlichen wirtschaftlichen Eigentümerschaft](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship) bereit. |

## Testen Sie Ihre Integration

Erstellen oder aktualisieren Sie ein verbundenes Konto in Singapur in einer Sandbox und verwenden Sie eine [UEN-Beispielnummer für Unternehmen in Singapur](https://docs.stripe.com/connect/testing.md?accounts-namespace=v1#sample-companies-singapore) als `company.tax_id`. Verwenden Sie diese Beispiele, um zu überprüfen, ob Ihre Integration die KYB-, Gründungsdokument- und UBO-Verifizierungsstatus für Singapur erfüllt, und überprüfen Sie dann die `Anforderungen` des Kontos.

Verifizierungsergebnisse können asynchron aktualisiert werden. Rufen Sie nach dem Einreichen der Testdaten das Konto ab oder warten Sie auf ein `account.updated`-Ereignis, und überprüfen Sie dann dessen `Anforderungen`.

### Fehlende Inhaber/innen testen

Verwenden Sie [180100002M](https://docs.stripe.com/connect/testing.md?accounts-namespace=v1#singapore-180100002m), um fehlende Informationen zu Inhaberinnen und Inhabern zu testen.

1. Legen Sie `company.owners_provided=true` fest.
2. Fügen Sie keine erforderlichen [Person](https://docs.stripe.com/api/persons/object.md)-Objekte für Inhaber/innen hinzu.

Dadurch werden Anforderungen an Inhaber/innen wie `owners.first_name`, `owners.last_name` und `company.owners_provided` erzeugt und der Fehler `verification_missing_owners` zurückgegeben.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d business_type=company \
  -d "company[structure]=private_company" \
  -d "company[tax_id]=180100002M" \
  -d "company[owners_provided]=true"
```

Erwartete Anforderungen und Fehler:

```json
{
  "currently_due": [
    "company.owners_provided",
    "owners.first_name",
    "owners.last_name"
  ],
  "errors": [
    { "code": "verification_missing_owners", "requirement": "owners.first_name" },
    { "code": "verification_missing_owners", "requirement": "owners.last_name" }
  ]
}
```

### Nichtübereinstimmung von Inhaberinnen und Inhabern testen

Verwenden Sie [180100002M](https://docs.stripe.com/connect/testing.md?accounts-namespace=v1#singapore-180100002m), um die Übermittlung eines Inhabers/einer Inhaberin zu testen, der/die nicht mit den Sandbox-Beziehungsdaten übereinstimmt.

1. Erstellen Sie einen nicht übereinstimmenden Inhaber/eine nicht übereinstimmende Inhaberin.
2. Legen Sie `company.owners_provided=true` fest.

Stripe gibt `verification_missing_owners` zurück, da der/die übermittelte Inhaber/in nicht den Inhaberinnen und Inhabern im Beispielprofil zugeordnet werden konnte.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d business_type=company \
  -d "company[structure]=private_company" \
  -d "company[tax_id]=180100002M"
```

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}}/persons \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d first_name=Mismatch \
  -d last_name=Owner \
  -d id_number=S9999999Z \
  -d "dob[day]=1" \
  -d "dob[month]=1" \
  -d "dob[year]=1990" \
  -d "address[line1]=10 ANSON ROAD" \
  -d "address[city]=Singapore" \
  -d "address[postal_code]=079903" \
  -d "address[country]=SG" \
  -d "relationship[owner]=true" \
  -d "relationship[percent_ownership]=30"
```

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "company[owners_provided]=true"
```

Erwartete Anforderungen und Fehler:

```json
{
  "currently_due": [
    "owners.first_name",
    "owners.last_name"
  ],
  "errors": [
    { "code": "verification_missing_owners", "requirement": "owners.first_name" },
    { "code": "verification_missing_owners", "requirement": "owners.last_name" }
  ]
}
```

### Anforderungen an Vorstandsmitglieder von gemeinnützigen Organisationen testen

Verwenden Sie [R01SS0001A](https://docs.stripe.com/connect/testing.md?accounts-namespace=v1#singapore-r01ss0001a), um mit „Vorstand“ beginnende Anforderungen für eine gemeinnützige Organisation zu testen.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d business_type=non_profit \
  -d "company[tax_id]=R01SS0001A"
```

Erwartete Anforderungen und Fehler:

```json
{
  "currently_due": [
    "company.directors_provided",
    "directors.first_name",
    "directors.last_name"
  ],
  "errors": []
}
```

### Fehlende Vorstandsmitglieder testen

Verwenden Sie [180100002M](https://docs.stripe.com/connect/testing.md?accounts-namespace=v1#singapore-180100002m), um fehlende erforderliche Vorstandsmitglieder zu testen.

1. Legen Sie `company.directors_provided=true` fest.
2. Fügen Sie keine erforderlichen [Person](https://docs.stripe.com/api/persons/object.md)-Objekte für Vorstandsmitglieder hinzu.

Dadurch werden Anforderungen an den Vorstand wie `directors.first_name`, `directors.last_name` und `company.directors_provided` erzeugt und `verification_missing_directors` zurückgegeben.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d business_type=company \
  -d "company[structure]=private_company" \
  -d "company[tax_id]=180100002M" \
  -d "company[directors_provided]=true"
```

Erwartete Anforderungen und Fehler:

```json
{
  "currently_due": [
    "company.directors_provided",
    "directors.first_name",
    "directors.last_name"
  ],
  "errors": [
    { "code": "verification_missing_directors", "requirement": "directors.first_name" },
    { "code": "verification_missing_directors", "requirement": "directors.last_name" }
  ]
}
```

### Nichtübereinstimmung von Vorstandsmitgliedern testen

Verwenden Sie [180100002M](https://docs.stripe.com/connect/testing.md?accounts-namespace=v1#singapore-180100002m), um eine Nichtübereinstimmung von Vorstandsmitgliedern zu testen.

1. Erstellen Sie drei [Person](https://docs.stripe.com/api/persons/object.md)-Objekte für Vorstandsmitglieder, die nicht mit den drei Vorstandsmitgliedern im Beispielprofil übereinstimmen.
2. Legen Sie `company.directors_provided=true` fest.

Dies gibt `verification_directors_mismatch` zurück.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d business_type=company \
  -d "company[structure]=private_company" \
  -d "company[tax_id]=180100002M"
```

Erstellen Sie das erste nicht übereinstimmende Vorstandsmitglied und wiederholen Sie diese Anfrage dann zwei weitere Male mit weiteren nicht übereinstimmenden Angaben zum Vorstandsmitglied.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}}/persons \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d first_name=Mismatch \
  -d last_name=Director \
  -d id_number=S8888888Z \
  -d "dob[day]=1" \
  -d "dob[month]=1" \
  -d "dob[year]=1990" \
  -d "address[line1]=10 ANSON ROAD" \
  -d "address[city]=Singapore" \
  -d "address[postal_code]=079903" \
  -d "address[country]=SG" \
  -d "relationship[director]=true"
```

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "company[directors_provided]=true"
```

Erwartete Anforderungen und Fehler:

```json
{
  "currently_due": [
    "directors.first_name",
    "directors.last_name"
  ],
  "errors": [
    { "code": "verification_directors_mismatch", "requirement": "directors.first_name" },
    { "code": "verification_directors_mismatch", "requirement": "directors.last_name" }
  ]
}
```

### Testen ohne wesentliche Anteilseigner/innen

Verwenden Sie [180100001C](https://docs.stripe.com/connect/testing.md?accounts-namespace=v1#singapore-180100001c), um ein Unternehmen zu testen, an dem kein/e Anteilseigner/in mindestens 25&nbsp;% der Anteile hält.

1. Übermitteln Sie die UEN.
2. Legen Sie `company.owners_provided=true` fest, ohne [Person](https://docs.stripe.com/api/persons/object.md)-Objekte für Inhaber/innen hinzuzufügen.

Stripe gibt `verification_missing_directors` zurück, da Vorstandsmitglieder als wirtschaftlich Berechtigte erforderlich sind, wenn keine zutreffenden Inhaber/innen existieren.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d business_type=company \
  -d "company[structure]=private_company" \
  -d "company[tax_id]=180100001C" \
  -d "company[owners_provided]=true"
```

Erwartete Anforderungen und Fehler:

```json
{
  "currently_due": [
    "company.directors_provided",
    "directors.first_name",
    "directors.last_name"
  ],
  "errors": [
    { "code": "verification_missing_directors" }
  ]
}
```

### Komplexe Eigentümerstruktur oder Dokument-Fallback testen

Verwenden Sie [180100005E](https://docs.stripe.com/connect/testing.md?accounts-namespace=v1#singapore-180100005e), um eine Eigentümerstruktur zu simulieren, die eine dazwischengeschaltete juristische Person umfasst.

Dadurch werden die Anforderung `documents.proof_of_ultimate_beneficial_ownership.files` und der Fehler `verification_requires_additional_proof_of_registration` erzeugt.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d business_type=company \
  -d "company[structure]=private_company" \
  -d "company[tax_id]=180100005E"
```

Erwartete Anforderungen und Fehler:

```json
{
  "currently_due": [
    "documents.proof_of_ultimate_beneficial_ownership.files"
  ],
  "errors": [
    { "code": "verification_requires_additional_proof_of_registration", "requirement": "documents.proof_of_ultimate_beneficial_ownership.files" }
  ]
}
```

Beheben Sie dies, indem Sie einen Nachweis der wirtschaftlichen Berechtigung hochladen und an das Konto anhängen:

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "documents[proof_of_ultimate_beneficial_ownership][files][]={{FILE_ID}}"
```

### Anforderung an das Gründungsdokument testen

Verwenden Sie [180100013R](https://docs.stripe.com/connect/testing.md?accounts-namespace=v1#singapore-180100013r), um eine private Gesellschaft zu simulieren, die keine Modellverfassung (Model Constitution) verwendet.

Dadurch werden die Anforderung `documents.company_memorandum_of_association.files` und der Fehler `verification_failed_other` erzeugt.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d business_type=company \
  -d "company[structure]=private_company" \
  -d "company[tax_id]=180100013R"
```

Erwartete Anforderungen und Fehler:

```json
{
  "currently_due": [
    "documents.company_memorandum_of_association.files"
  ],
  "errors": [
    { "code": "verification_failed_other", "requirement": "documents.company_memorandum_of_association.files" }
  ]
}
```

Beheben Sie dies, indem Sie ein Gründungsdokument hochladen und an das Konto anhängen:

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "documents[company_memorandum_of_association][files][]={{FILE_ID}}"
```

## Hilfe erhalten

- Wenden Sie sich bei Fragen zu diesen Anforderungsänderungen an den [Stripe-Support](https://support.stripe.com).
- Antworten auf Fragen zur API-Integration finden Sie in der [Connect-Dokumentation](https://docs.stripe.com/connect.md).
- Verwenden Sie die Seite [Zu prüfende Konten](https://dashboard.stripe.com/connect/accounts/overview) in Ihrem Dashboard, um den Compliance-Status Ihrer Konten zu überwachen.

#### Programm - US

*Letzte Aktualisierung: 23.&nbsp;September&nbsp;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&nbsp;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&nbsp;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&nbsp;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&nbsp;USD erreicht, oder innerhalb von 30&nbsp;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&nbsp;Zeichen der Zahlungsbeschreibung vorausgefüllt.

## 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)