Anstehende Anforderungsaktualisierungen

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 Artikel zu neuen Compliance-Anforderungen.

Die bevorstehenden Änderungen betreffen verbundene Konten in den folgenden Ländern:

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: Empfohlen Senden Sie Konten zu einem Stripe-gehosteten Flow, damit die erforderlichen Informationen übermittelt werden.
• Eingebettetes Onboarding: Empfohlen Betten Sie von Stripe bereitgestellte Onboarding-Komponenten ein, mit denen Konten Informationen direkt aus Ihrer App an Stripe übermitteln können.
• API Onboarding: Erstellen und verwalten Sie einen benutzerdefinierten Onboarding-Ablauf mithilfe der Stripe-APIs.

Erfahren Sie mehr über Onboarding-Optionen von Connect und die Migration Ihrer API-basierten Onboarding- und Sanierungsabläufe auf von Stripe gehostete oder eingebettete Abläufe.

Die Änderungen, die Sie an Ihrem Onboarding-Ablauf vornehmen, hängen davon ab, wie Sie Onboarding-Informationen erfassen. 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
• Überprüfung des/der endgültigen wirtschaftlichen Eigentümerin/Eigentümers (UBO) und der Beziehung zum Vorstand
• Anforderungen zur niederländischen Unternehmensregistrierung (KvK)
• Neue Fehlercodes

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.

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 und Vorstände (für Konten, die nach dem Stripe-Risikomodell als hoch riskant eingestuft werden)

Zusätzliche Verifizierungsmethoden

Sie können die Erfolgsquote der Verifizierung verbessern, indem Sie zusätzlich zu den standardmäßig eingegebenen Informationen die folgenden Methoden anwenden:

• Überprüfung der nationalen Identitätsnummer: Empfohlen Erfassen Sie vorab die nationale Identitätsnummer, um die Erstüberprüfungsraten zu erhöhen.
• Stripe Identity: Verwenden Sie Selfies und Dokumentenfotos für Konten, die eine automatische Verifizierung nicht bestehen.
• Hochladen weiterer Dokumente: 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 zu verifizieren. Identity funktioniert durch das Erfassen eines Selfies und eines Ausweisdokuments. Die meisten europäischen Länder unterstützen Stripe Identity und die Erfolgsquoten variieren je nach Land.

Erstellen Sie eine Verifizierungssitzung für die Identität und verwenden Sie den Parameter 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 der nationalen Ausweisnummer Öffentliche Vorschau

In den von diesem Update betroffenen Ländern 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.

Sie können nationale Ausweisnummern nur für verbundene Konten in den von diesem Update betroffenen Ländern angeben. Beispielsweise können Sie die Ausweisnummer für eine spanische Person angeben, die als Vertreterin/Vertreter eines verbundenen Kontos in Österreich fungiert, aber nicht für eine spanische Person, die als Vertreterin/Vertreter eines verbundenen Kontos in den USA tätig ist.

// 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",
      ...
    ]
  }
 ...
}

> 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",
  ...
}

> 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"
    ]
  }
 ...
}

> 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"
        ]
      }
    ]
  }
}

> curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB/persons/person_1N9XNb2eZvKYlo2CjPX7xF6B \
  -u sk_test_123: \
  -d 'id_number'='74362315-A' \
  ...other person fields...

> 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"
    ],
  }
}

> 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.*"
        ],
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.proof_of_liveness"
        ]
      },
    ]
  }
}

> 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_in_mismatch",
        "reason": "Identity information could not be verified."
        "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.name"
      },
      {
        "code": "verification_failed_keyed_in_mismatch",
        "reason": "Identity information could not be verified."
        "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.address"
      },
      {
        "code": "verification_failed_keyed_in_mismatch",
        "reason": "Identity information could not be verified."
        "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number"
      }
    ]
  }
}

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

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

• UBO: Eine Einzelperson, die (direkt oder indirekt) mehr als 25 % einer juristischen Person besitzt oder kontrolliert (z. B. Unternehmen, Kapitalgesellschaften, LLCs und Partnerschaften).
• Vorstand: Ein Vorstandsmitglied oder eine leitende Person, die für die Leitung des Unternehmens verantwortlich ist (z. B. CEO, COO, geschäftsführender Direktor).

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

UBO- und Vorstandsinformationen

Stripe versucht, die Beziehung der Person zu überprüfen, indem es wichtige Eigenschaften der Person mit den Eigenschaften der juristischen Person abgleicht.

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

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

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

{
  "id": "acct_1234",
  "past_due": {
    // third-party provider option
    "currently_due": [
      "owners.first_name",
      "owners.last_name",
      "company.owners_provided",
      "company.tax_id"
    ],
    "alternatives": [
      {
        "original_fields_needed": [
          "owners.first_name",
          "owners.last_name",
          "company.owners_provided",
          "company.tax_id"
        ],
        // official document option
        "alternative_fields_needed": [
          "owners.first_name",
          "owners.last_name",
          "company.owners_provided",
          "company.name",
          "company.address.line1",
          "company.address.state",
          "company.address.city",
          "documents.proof_of_ultimate_beneficial_ownership.files"
        ],
      },
      {
        "original_fields_needed": [
          "owners.first_name",
          "owners.last_name",
          "company.owners_provided",
          "company.tax_id"
        ],
        // digital attestation option
        "alternative_fields_needed": [
          "owners.first_name",
          "owners.last_name",
          "company.owners_provided",
          "company.name",
          "company.address.line1",
          "company.address.state",
          "company.address.city",
          "documents.proof_of_ultimate_beneficial_ownership.files",
          "documents.proof_of_ultimate_beneficial_ownership.signer"
        ],
      }
    ]
  }
}

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

{
  "id": "acct_1234",
  "past_due": {
    // third-party provider option for owners
    "currently_due": [
      "owners.first_name",
      "owners.last_name",
      "company.owners_provided",
      "company.tax_id"
    ],
    "alternatives": [
      ...,
      {
        "original_fields_needed": [
          "owners.first_name",
          "owners.last_name",
          "company.owners_provided",
          "company.tax_id"
        ],
        // third-party provider option for directors
        "alternative_fields_needed": [
          "directors.first_name",
          "directors.last_name",
          "company.directors_provided",
          "company.owners_provided",
          "company.tax_id"
        ],
      }
    ]
  }
}

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

{
  "id": "acct_1234",
  "past_due": {
    // third-party provider option for owners
    "currently_due": [
      "owners.first_name",
      "owners.last_name",
      // company.owners_provided is no longer a requirement
      "company.tax_id"
    ],
    "alternatives": [
      ...,
      {
        "original_fields_needed": [
          "owners.first_name",
          "owners.last_name",
          "company.tax_id"
        ],
        // third-party provider option for directors
        "alternative_fields_needed": [
          "directors.first_name",
          "directors.last_name",
          "company.directors_provided",
          "company.tax_id"
        ],
      }
    ]
  }
}

{
  "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."
    }]
  }
}

{
  "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."
    }]
  }
}

{
  "error": {
    "code": "invalid_signator",
    "message": "signer.person can only be provided when a file is also provided",
    "type": "invalid_request_error"
  }
}

UBO- und Geschäftsführerinformationen vorausfüllen Private Vorschau

Optional können Sie auch eine API integrieren, die programmgesteuert die mit einer juristischen Person verbundenen UBOs oder Vorstandsmitglieder erkennt und vorab ausfüllt. Das verbundene Konto kann die Beziehung durch Bestätigung der erkannten Informationen überprüfen, anstatt durch Hochladen von Dokumenten oder digitale Beglaubigung.

Dieser Pfad kann die Verifizierungsquoten erhöhen und Reibungsverluste reduzieren, ist jedoch nicht für alle Konten geeignet. Für Konten, bei denen Stripe die Beziehungen nicht vorab ausfüllen kann, müssen Sie weiterhin Dokumenten-Uploads oder digitale Beglaubigungen bearbeiten.

Wenn Sie an einer Vorabausfüllung für die UBO- oder Vorstandsüberprüfung interessiert sind, melden Sie sich bitte unten an, um Ihr Interesse zu bekunden.

Anforderungen zur Unternehmensregistrierung (KvK) in den Niederlanden

Ab 2026 setzen wir strengere Anforderungen an den Unternehmenstyp für Konten in den Niederlanden (NL) durch, um die Einhaltung der niederländischen Vorschriften zu gewährleisten. Dies betrifft insbesondere die Erfassung der KvK (Kamer van Koophandel), der eindeutigen 8-stelligen Handelsregisternummer, die für Unternehmen in den Niederlanden erforderlich ist.

Was ändert sich?

Unternehmenstyp „Einzelperson“ wird nicht länger unterstützt

Der Unternehmenstyp individual wird für niederländische Konten nicht mehr unterstützt. Dies betrifft: Bestehende und neue NL-Konten mitbusiness_type: "individual" undbusiness_type: "sole_proprietorship"

Warum das wichtig ist: In den Niederlanden muss jedes Unternehmen eine KvK-Nummer (Handelskammer) angeben. Unser Unternehmenstyp „Einzelperson“ erhält keine KvK-Nummer, was ihn nicht-konform macht.

Neuer Fehlercode: unsupported_business_type

Bei Konten mit ungültigen Unternehmenstypen wird ein neuer Fehler in den Anforderungen angezeigt:

// Account with unsupported business type
{
  "id": "acct_123",
  "business_type": "individual",
  "country": "NL",
  "requirements": {
    "past_due": ["business_type"],
    "errors": [{
      "requirement": "business_type",
      "code": "unsupported_business_type",
      "reason": "Business type isn't supported in merchant country. 'individual' isn't a supported business type in country NL."
    }]
  }
}

Erfassen der KvK-Registrierung für Konten ohne eigene Rechtspersönlichkeit

Bestehende und neue NL-Konten mit den folgenden Unternehmenstypen und -strukturen sind erforderlich, um die KvK-Registrierung zu ermöglichen.

• business_type: "company" und business_structure: "unincorporated_partnership"
• business_type: "non_profit" und business_structure: "unincorporated_non_profit"

Warum das wichtig ist: Nicht eingetragene Konten sind derzeit nicht verpflichtet, eine KvK-Nummer anzugeben, was gegen die niederländischen Compliance-Anforderungen verstößt. Alle Unternehmen in den Niederlanden müssen ihre KvK-Registrierung vorlegen.

Lösung

Für bestehende Konten

Bestehende NL-Konten mit dem Unternehmenstyp individual müssen auf company mit der Struktur sole_proprietorship aktualisiert werden. Nur so kann die Compliance gewährleistet werden, wenn wir mit der Einführung dieser neuen Anforderung beginnen:

// Update existing account
curl -X POST https://api.stripe.com/v1/accounts/acct_123 \
  -u sk_test_123: \
  -d "business_type=company" \
  -d "company[structure]=sole_proprietorship" \
  -d "company[tax_id]=12345678"  // KvK number

// Successful response
{
  "id": "acct_123",
  "business_type": "company",
  "company": {
    "structure": "sole_proprietorship",
    "tax_id": "12345678"
  },
  "requirements": {
    "past_due": [],  // business_type requirement resolved
    "errors": []
  }
}

Zur Erstellung eines neuen Kontos

Bei dem Versuch, ein niederländisches Konto mit de Unternehmenstyp individual zu erstellen, wird der Fehler unsupported_Unternehmen_type zurückgegeben.

// This will fail
curl -X POST https://api.stripe.com/v1/accounts \
  -u sk_test_123: \
  -d "country=NL" \
  -d "type=custom" \
  -d "business_type=individual"

// Response
{
  "id": "acct_123",
  "business_type": "individual",
  "country": "NL",
  "requirements": {
    "past_due": ["business_type"],
    "errors": [{
      "requirement": "business_type",
      "code": "unsupported_business_type",
      "reason": "Business type isn't supported in merchant country. 'individual' isn't a supported business type in country NL."
    }]
  }


// Correct approach
curl -X POST https://api.stripe.com/v1/accounts \
  -u sk_test_123: \
  -d "country=NL" \
  -d "type=custom" \
  -d "business_type=company" \
  -d "company[structure]=sole_proprietorship"

Unterstützte Unternehmensstrukturen für NL

Verwenden Sie für niederländische Konten die folgenden Kombinationen aus Unternehmenstyp und Struktur:

Auswirkungen auf die Funktionen

Bei Konten mit einem Fehler bei dem unsupported_business_type werden ihre Funktionen eingeschränkt, bis der Unternehmenstyp aktualisiert wird:

{
  "capabilities": {
    "card_payments": "inactive",
    "transfers": "inactive"
  },
  "requirements": {
    "disabled_reason": "requirements.past_due",
    "past_due": ["business_type"]
  }
}

Bei Konten, die ihre KvK-Registrierung nicht angegeben haben, wird ihrecard_payments-Funktion eingeschränkt, bis diese Informationen bereitgestellt werden:

{
  "capabilities": {
    "card_payments": "inactive"
  },
  "requirements": {
    "disabled_reason": "requirements.past_due",
    "past_due": ["company.tax_id"]
  }
}

Migrationszeitplan

• Jetzt: Neuer Fehlercode unsupported_business_type ist aktiv
• Bei der Einführung künftiger Anforderungen: Vorhandene Konten müssen mit der Sanierung beginnen
• 30. September 2026: Alle NL-Konten müssen konform sein

Checkliste für die Umsetzung

Für Plattformen mit verbundenen NL-Konten:

1. Vorhandene Konten prüfen

// Find affected accounts
const accounts = await stripe.accounts.list({
  limit: 100,
  // Filter for NL accounts in your system
});

const affected = accounts.data.filter(a =>
  a.country === 'NL' &&
  a.business_type === 'individual'
);

1. Aktualisieren von Abläufen der Kontoerstellung

   • Entfernen Sie die Option individual für NL-Konten
   • Standardmäßig auf company mitsole_proprietorship
   • KvK-Nummer erfassen (company.tax_id)

2. Umgang mit dem neuen Fehlercode

if (account.requirements.errors.some(e =>
  e.code === 'unsupported_business_type')) {
  // Prompt user to update business type
  // Guide them to select appropriate structure
  // Collect KvK number
}

1. Kommunizieren Sie mit betroffenen verbundenen Konten

   • Erklären Sie, warum die Änderung notwendig ist
   • Orientierungshilfe bei der Auswahl der richtigen Unternehmensstruktur
   • Helfen Sie ihnen, ihre KvK-Nummer zu finden

Testen

Testen Sie Ihre Implementierung mit den folgenden Szenarien:

// Test updating to valid business type
const updated = await stripe.accounts.update('acct_test_123', {
  business_type: 'company',
  company: {
    structure: 'sole_proprietorship',
    tax_id: '12345678'  // Test KvK
  }
});

Weitere Überlegungen

Freiberufler/innen

In den Niederlanden müssen sich auch Freiberufler/innen als Unternehmen (eenmanszaak) registrieren und eine KvK-Nummer erhalten. Diese Personen sollten also Unternehmen →sole_proprietorship auswählen.

So finden Sie die KvK-Nummer für verbundene Konten

Die KvK-Nummer befindet sich auf der Anmeldebescheinigung der Handelskammer (uittreksel Kamer van Koophandel).

Abwärtskompatibilität

In älteren API-Versionen wird unsupported_business_type alsinvalid_value_other mit einem Feld detailed_code angezeigt, das den spezifischen Fehler enthält.

Neue Fehlercodes

verification_data_not_found

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.

// 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.

Testkonto erstellen

Erstellen Sie ein Testkonto, indem Sie mit Ihrem Sandbox-Geheimschlüssel 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:

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 und legen Sie dann die grundlegenden Unternehmensdaten fest:

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:

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 im Test-Modus eine erfolgreiche Identitätsprüfung aus. Weitere Ergebnisauslöser finden Sie unter Test-Geburtsdaten. 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-Geschäftsadressen.

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:

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:

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:

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.

Erstellen Sie ein Testkonto gemäß den vorherigen Anweisungen und legen Sie dann die grundlegenden Unternehmensdaten fest:

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.

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

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:

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:

{
  "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.

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:

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 und legen Sie dann die grundlegenden Unternehmensdaten fest. Geben Sie die Steueridentifikationsnummer 222221001 an, was ein Fehlschlagen der Verifizierung des Inhabers/der Inhaberin auslöst.

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:

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:

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:

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

Wenn Sie sich das Konto ansehen, können Sie feststellen, dass die Anforderungen bezüglich der Inhaber/innen bestehen bleiben und das Array requirements.errors einen Eintrag mit einer Anforderung bezüglich der Inhaber/innen und einem Code von verification_data_not_found enthält. Das bedeutet, dass Stripe die Inhaber/innen anhand der angegebenen Informationen des Unternehmens nicht verifizieren konnte.

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 Konto die Files API, um ein Dokument hochzuladen, und aktualisieren Sie dann das Konto mit dem in der Antwort zurückgegebenen Token. Verwenden Sie in diesem Beispiel das Test-Token file_relationship_document_success.

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.

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 und legen Sie dann die grundlegenden Unternehmensdaten fest. Geben Sie die Steueridentifikationsnummer 000000000 an, wodurch die erfolgreiche Verifizierung des Unternehmens ausgelöst wird.

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:

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.

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:

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:

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:

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.