# Verarbeitung von Verifizierungen mit der API Erfahren Sie, wie Connect-Plattformen Webhooks und die API für die Verarbeitung der Verifizierung von verbundenen Konten verwenden können. Connect-Plattformen, die das Onboarding verbundener Konten über die API durchführen, müssen Stripe die erforderlichen Informationen zur Verfügung stellen, um [Know Your Customer](https://support.stripe.com/questions/know-your-customer) (KYC) zu ermöglichen und [Kontofunktionen](https://docs.stripe.com/connect/account-capabilities.md) zu aktivieren. Sie müssen die Informationen selbst erfassen und die Accounts API oder die Persons API verwenden, um Stripe diese zur Verfügung zu stellen. Anschließend verifizieren wir die Informationen und fordern bei Bedarf weitere Details an. Verantwortliche Plattformen müssen auch den Anforderungsstatus ihrer verbundenen Konten überwachen und [Updates](https://docs.stripe.com/connect/handle-verification-updates.md) zeitnah bearbeiten. ## Verifizierungsvorgang Bevor Zahlungen und *Auszahlungen* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit) für ein verbundenes Konto aktiviert werden können, benötigt Stripe bestimmte Informationen, die sich nach den folgenden Kriterien unterscheiden: - Das Ursprungsland der verbundenen Konten - [Art des Rahmenvertrags](https://docs.stripe.com/connect/service-agreement-types.md), der für die verbundenen Konten gilt - Für die verbundenen Konten angeforderte [Funktionen](https://docs.stripe.com/connect/account-capabilities.md) - Der [business_type](https://docs.stripe.com/api/accounts/object.md#account_object-business_type) (zum Beispiel Einzelperson oder Unternehmen) und die [company.structure](https://docs.stripe.com/api/accounts/object.md#account_object-company-structure) (zum Beispiel `public_corporation` oder `private_partnership`) Um die KYC-Anforderungen zu erfüllen, müssen Plattformen das geeignete [Onboarding-Verfahren](https://docs.stripe.com/connect/identity-verification.md#onboarding-flows) für ihr Unternehmen und ihre verbundenen Konten auswählen. Dabei werden dabei sämtliche erforderlichen Informationen vorab oder sukzessive bereitgestellt. In beiden Fällen müssen Sie Ihre Integration so einrichten, dass Sie auf entsprechende Anfragen von Stripe achten und darauf reagieren können. 1. Richten Sie eine URL für einen [Connect-Webhook](https://docs.stripe.com/connect/webhooks.md) in Ihren [Webhook-Einstellungen](https://dashboard.stripe.com/account/webhooks) ein, um auf Aktivitäten zu achten, insbesondere auf `account.updated`-Ereignisse. Achten Sie bei Verwendung der [Persons API](https://docs.stripe.com/api/persons.md) auch auf `person.updated`-Ereignisse. 1. Überprüfen Sie unmittelbar nach der Erstellung eines Kontos das Attribut [requirements.currently_due](https://docs.stripe.com/api/accounts/object.md#account_object-requirements-currently_due)des `Account`-Objekts auf zusätzliche Anforderungen. Holen Sie alle erforderlichen Informationen vom verbundenen Konto ein und aktualisieren Sie das `Account`. Solange `requirements.currently_due` nicht leer ist, hat das `Account` ausstehende Anforderungen, die seine Funktionen einschränken könnten. 1. Achten Sie weiter auf Benachrichtigungen zu Ereignissen vom Typ `account.updated`, um zu sehen, ob der Hash `requirements` sich ändert. Wenden Sie sich an das verbundene Konto, wenn Sie zusätzliche Informationen benötigen. Wenn Sie zusätzliche Informationen bereitstellen, müssen zuvor verifizierte Angaben nicht erneut übermittelt werden (zum Beispiel wenn der Parameter `dob` bereits verifiziert wurde, müssen Sie ihn bei nachträglichen Aktualisierungen nicht wieder angeben). ### Anforderungen der Risikoprüfung durch Stripe Stripe-Risikoprüfungen eines verbundenen Kontos können zusätzliche Anforderungen hinzufügen, die Sie über die API nicht bereitstellen können. Sie können [in Ihrem Dashboard](https://docs.stripe.com/connect/dashboard/managing-individual-accounts.md#actions-required) aktiv werden oder das verbundene Konto kann sie über [eine in Connect eingebettete Komponente](https://docs.stripe.com/connect/supported-embedded-components.md#onboarding-and-compliance), [von Stripe gehostetes Onboarding](https://docs.stripe.com/connect/hosted-onboarding.md) oder einen [Sanierungslink](https://docs.stripe.com/connect/dashboard/remediation-links.md) bereitstellen. ## Ermitteln, ob eine Verifizierung erforderlich ist Die Attribute `charges_enabled` und `payouts_enabled` für ein `Account`-Objekt geben an, ob es Zahlungen erstellen und Auszahlungen akzeptieren kann. Wenn eines dieser Attribute falsch ist, überprüfen Sie den Hash für die `requirements` des `Account`s, um festzustellen, welche Informationen für die Aktivierung von Zahlungen und Auszahlungen erforderlich sind. Der `requirements`-Hash enthält die folgenden Eigenschaften: | Eigenschaft | Beschreibung | | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `current_deadline` | Das Datum, bis zu dem die Anforderungen in `currently_due` erfasst werden müssen, damit das Konto `active` bleibt. Es stellt die früheste Frist für alle vom Konto angeforderten Funktionen und Risikoanforderungen dar, einschließlich aller versteckten Funktionen. | | `currently_due` | Ein Array mit den Anforderungen, die Sie bis zur `current_deadline` erfüllen müssen, damit das Konto `active` bleibt. | | `disabled_reason` | Beschreibt, warum das Konto nicht aktiviert ist und warum es keine Zahlungen oder Transfers verarbeiten kann. | | `errors` | Ein Array mit Details zu allen `currently_due`-Anforderungen mit Fehlern, die Sie beheben müssen. Weitere Informationen finden Sie im Abschnitt [Validierungs- und Verifizierungsfehler](https://docs.stripe.com/connect/handling-api-verification.md#validation-and-verification-errors). | | `eventually_due` | Ein Array, das die Anforderungen enthält, die Sie möglicherweise lösen müssen, je nachdem, ob die entsprechenden Schwellenwerte erreicht werden. Nachdem eine dieser potenziellen Anforderungen erforderlich geworden ist, wird sie sowohl im `eventually_due-` als auch im `currently_due`-Array angezeigt. Wenn eine Anforderung erforderlich wird und ihr Fälligkeitsdatum vor der bestehenden `current_deadline` liegt, ändert sich die `current_deadline` in das Durchsetzungsdatum des entsprechenden Schwellenwerts. | | `past_due` | Ein Array mit den Anforderungen, aufgrund derer Funktionen deaktiviert wurden, weil sie nicht vor der `current_deadline` erfüllt wurden. Das Array `past_due` ist eine Untergruppe von `current_due`. | | `pending_verification` | Array mit Anforderungen, die derzeit überprüft werden oder die je nach Ergebnis der Überprüfung erforderlich werden könnten. Es handelt sich um ein leeres Array, sofern keine asynchrone Überprüfung aussteht. Bei einer erfolglosen Überprüfung wird eine Anforderung in `eventually_due`, `current_due`, `alternative_fields_due` oder `past_due` verschoben. Eine Anforderung, die nicht erfüllt wurde und noch geprüft werden muss,kann auch in `pending_verification` verbleiben. | Das folgende Beispiel zeigt, wie der Hash `requirements` bei einem Konto mit Informationen vom Typ `currently_due`, mit Informationen vom Typ `eventually_due` und mit Informationen, die bei der Verifizierung `errors` auslösen, aussehen könnte. ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", "requirements": { "alternatives": [], "current_deadline": 1529085600, "currently_due": [ "company.tax_id", "company.verification.document", "tos_acceptance.date", "tos_acceptance.ip" ], "disabled_reason": null, "errors": [ { "requirement": "company.verification.document", "reason": "The company name on the account couldn't be verified. Either update your business name or upload a document containing the business name.", "code": "failed_name_match" } ], "eventually_due": [ "company.address.city", "company.address.line1", "company.address.postal_code", "company.address.state", "company.tax_id", "company.verification.document", "external_account", "tos_acceptance.date", "tos_acceptance.ip" ], "past_due": [], "pending_verification": [] }, ... } ``` Wenn `requirements.currently_due` Einträge enthält, müssen Sie `requirements.current_deadline` überprüfen. Bei dieser handelt es sich um einen Unix-Zeitstempel. Wenn Stripe die Informationen bis zur `current_deadline` nicht erhält, werden Auszahlungen für dieses Konto normalerweise deaktiviert. In einigen Fällen kann dies jedoch auch andere Konsequenzen nach sich ziehen. Wenn zum Beispiel Auszahlungen bereits deaktiviert sind und das Konto nicht auf unsere Anfragen reagiert, deaktiviert Stripe möglicherweise auch die Zahlungsabwicklung. Separat kann die Eigenschaft [requirements.disabled_reason](https://docs.stripe.com/api/accounts/object.md#account_object-requirements-disabled_reason) eine Zeichenfolge enthalten, die beschreibt, warum bestimmte Funktionen für das Konto deaktiviert sind. In einigen Fällen können Plattformen und verbundene Konten ein Formular einreichen, um den Grund zu beheben oder Widerspruch einzulegen. - Verbundene Konten mit Zugriff auf das vollständige Stripe-Dashboard, einschließlich Standard-Konten, können im Dashboard auf zusätzliche Informationen (sofern verfügbar) zugreifen. - Plattformen können den `disabled_reason` eines Kontos auf der Seite [Verbundene Konten](https://docs.stripe.com/connect/dashboard/review-actionable-accounts.md) nachschlagen. Möglicherweise können Sie zusätzliche Informationen im Namen Ihrer verbundenen Konten bereitstellen. Wenn der deaktivierte Grund mit einem Widerspruch verknüpft ist, können Sie einen Link zu einem Formular für das Konto generieren, um den Widerspruch zu lösen. | Ursache | Bedeutung | | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `action_required.requested_capabilities` | Sie müssen [Funktionen](https://docs.stripe.com/connect/account-capabilities.md#requesting-unrequesting) für das verbundene Konto anfordern. | | `listed` | Das Konto könnte sich auf einer Liste gesperrter Personen oder Unternehmen befinden. Stripe wird den Fall untersuchen und das Konto entsprechend ablehnen oder wieder aktivieren. | | `rejected.fraud` | Das Konto wurde wegen Verdachts auf Betrug oder illegale Aktivitäten abgelehnt. | | `rejected.incomplete_verification` | Das Konto wird aufgrund unvollständiger Verifizierungsanforderungen innerhalb des erforderlichen Schwellenwerts abgelehnt. | | `rejected.listed` | Das Konto wurde abgelehnt, weil es sich auf einer externen Liste verbotener Personen oder Unternehmen befindet (z. B. Finanzdienstleister oder Regierung). | | `rejected.other` | Das Konto wurde aus einem anderen Grund abgelehnt. | | `rejected.terms_of_service` | Das Konto wurde wegen Verdachts auf Verletzungen der Allgemeine Geschäftsbedingungen abgelehnt. | | `requirements.past_due` | Es sind zusätzliche Verifizierungsinformationen erforderlich, um Funktionen für dieses Konto zu aktivieren. | | `requirements.pending_verification` | Stripe verifiziert derzeit die Informationen des verbundenen Kontos. Es sind keine Maßnahmen erforderlich. Überprüfen Sie die das Array [requirements.pending_verification](https://docs.stripe.com/api/accounts/object.md#account_object-requirements-pending_verification), um die zu verifizierenden Informationen anzuzeigen. | | `under_review` | Das Konto wird durch Stripe geprüft. | ## Validierungs- und Verifizierungsfehler Das `Account`-Objekt enthält ein Array [requirements.errors](https://docs.stripe.com/api/accounts/object.md#account_object-requirements-errors), das erklärt, warum die Validierungs- oder Verifizierungsanforderungen nicht erfüllt wurden. Zur Aktivierung der Funktionen des Kontos müssen Sie diese Anforderungen erfüllen. Das Array `errors` weist die folgenden Attribute auf: | Attribut | Beschreibung | | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `code` | Gibt die Art des aufgetretenen Fehlers an. Alle möglichen Fehlercodes finden Sie in der [API-Dokumentation](https://docs.stripe.com/api/accounts/object.md#account_object-requirements-errors-code). | | `reason` | Eine Klartextnachricht, die erklärt, warum der Fehler aufgetreten ist und wie er behoben werden kann. | | `requirement` | Gibt an, welche Informationen vom Array `currently_due` oder `alternative_fields_due` erforderlich sind. | Das folgende Beispiel zeigt ein Array `errors` für ein Konto mit Anforderungen, die `current_due` sind, also den Grund, warum die übermittelten Informationen nicht zur Aktivierung des Kontos verwendet werden können, und wie der Fehler behoben wird. ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", "requirements": { "current_deadline": 1234567800, "currently_due": [ "company.address.line1", "{{PERSON_ID}}.verification.document" ], "errors": [ { "requirement": "company.address.line1", "code": "invalid_street_address", "reason": "The provided street address cannot be found. Please verify the street name and number are correct in \"10 Downing Street\"" }, { "requirement": "{{PERSON_ID}}.verification.document", "code": "verification_document_failed_greyscale", "reason": "Greyscale documents cannot be read. Please upload a color copy of the document." } ] }, ... } ``` Wenn die Verifizierung oder Validierung fehlschlägt, können Anforderungen erneut in `currently_due`, `alternative_fields_due` oder `eventuell_due` mit Fehlerinformationen angezeigt werden. Um eine Benachrichtigung über diese Anforderungen zu erhalten, setzen Sie einen [Connect-Webhook](https://docs.stripe.com/connect/webhooks.md), um das Ereignis `account.updated` zu überwachen. ## Unternehmensinformationen Stripe verifiziert alle Informationen, die zu einem Unternehmen eingereicht wurden. Beispielsweise können wir überprüfen, ob die URL des Unternehmens gültig ist, erreichbar ist und Informationen über das Unternehmen enthält. Um den Status der Verifizierung zu überprüfen, können Sie den Hash `requirements` für das `Account`-Objekt abrufen. Die folgenden Fehler betreffen die Verifizierung von Unternehmensinformationen: | Fehler | Beilegung | | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- | | `invalid_business_profile_name` | Unternehmensnamen müssen leicht verständlich sein und aus erkennbaren Wörtern bestehen. | | `invalid_business_profile_name_denylisted` | Der Unternehmensname muss mit dem Unternehmen des Konto übereinstimmen und darf kein allgemeiner oder bekannter Name sein. | | `invalid_product_description_length` | Die Produktbeschreibung muss mindestens 10 Zeichen lang sein. | | `invalid_product_description_url_match` | Die Produktbeschreibung muss sich von der Unternehmens-URL unterscheiden. | Unter [Umgang mit URL-Verifizierungsfehlern](https://docs.stripe.com/connect/handling-api-verification.md#url-verification) finden Sie die folgenden URL-Fehler: - `invalid_url_denylisted` - `invalid_url_format` - `invalid_url_web_presence_detected` - `invalid_url_website_business_information_mismatch` - `invalid_url_website_empty` - `invalid_url_website_inaccessible` - `invalid_url_website_inaccessible_geoblocked` - `invalid_url_website_inaccessible_password_protected` - `invalid_url_website_incomplete` - `invalid_url_website_incomplete_cancellation_policy` - `invalid_url_website_incomplete_customer_service_details` - `invalid_url_website_incomplete_legal_restrictions` - `invalid_url_website_incomplete_refund_policy` - `invalid_url_website_incomplete_return_policy` - `invalid_url_website_incomplete_terms_and_conditions` - `invalid_url_website_incomplete_under_construction` - `invalid_url_website_other` ## Unternehmensvertreter/innen Sie müssen Informationen über die mit einem verbundenen Konto verknüpften Personen erfassen und übermitteln. Der Prozess hängt davon ab, ob es sich bei Ihren verbundenen Konten um Unternehmen, Einzelpersonen oder beides handelt. Verwenden Sie für Unternehmen die [Persons API](https://docs.stripe.com/api/persons.md), um die Informationen zu einem mit dem `Account`-Objekt verknüpften `Person`-Objekt hinzuzufügen. Um Dokumente zum [Verifizierungs-](https://docs.stripe.com/api/persons/object.md#person_object-verification)Hash des `Person`-Objekts hinzuzufügen, verwenden Sie zunächst die [Files API](https://docs.stripe.com/api/files.md), um die Dokumentdateien auf die Server von Stripe hochzuladen. Für Einzelpersonen können Sie entweder eine `Person` erstellen oder die Informationen zum [einzelnen](https://docs.stripe.com/api/accounts/object.md#account_object-individual) Hash des `Account`-Objekts hinzufügen. Wenn zu Ihren verbundenen Konten sowohl Unternehmen als auch Einzelpersonen gehören, erstellen Sie `Person`-Objekte, damit Sie für alle denselben Prozess verwenden können. Um den Status der Verifizierung eines `Account`s zu überprüfen, können Sie dessen Hash für [Anforderungen](https://docs.stripe.com/api/persons/object.md#person_object-requirements) abrufen. Die folgenden Fehler beziehen sich auf die Personenverifizierung: | Fehler | Beilegung | | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | `invalid_address_city_state_postal_code` | Stripe konnte die Kombination aus Stadt, Bundesland und Postleitzahl in der angegebenen Adresse nicht validieren. | | `invalid_address_highway_contract_box` | Die Adresse der Person muss eine gültige physische Adresse sein, von der aus das Konto Geschäfte abwickelt. Eine Highway-Contract-Box ist nicht zulässig. | | `invalid_address_private_mailbox` | Die Adresse der Person muss eine gültige physische Adresse sein, von der aus das Konto Geschäfte abwickelt. Ein privates Postfach ist nicht zulässig. | | `invalid_dob_age_under_minimum` | Die Person muss mindestens 13 Jahre alt sein. | | `invalid_dob_age_over_maximum` | Das Geburtsdatum der Person muss innerhalb der letzten 120 Jahre liegen. | | `invalid_phone_number` | Stripe konnte die Telefonnummer für das Konto nicht validieren. Stellen Sie sicher, dass die Formatierung dem Land der Person entspricht. | | `invalid_street_address` | Stripe konnte den Straßennamen und/oder die Hausnummer für die angegebene Adresse nicht validieren. | | `invalid_tax_id` `invalid_tax_id_format` | Die Steueridentifikationsnummer muss eindeutig sein und aus neun Zahlen bestehen. Bindestriche oder andere Sonderzeichen sind nicht zulässig. | ## Akzeptierte Verifizierungsdokumente Die Arten von Ausweisdokumenten, die Stripe für verbundene Konten akzeptiert, variieren je nach Land und sind [die gleichen wie bei anderen Stripe-Konten](https://docs.stripe.com/acceptable-verification-documents.md). ## Informationen über Ihr Unternehmen Während der Verifizierung müssen Sie möglicherweise Informationen eines Unternehmens für ein Konto erfassen. Um den Status der Verifizierung zu überprüfen, können Sie den Subhash [company.verification](https://docs.stripe.com/api/accounts/object.md#account_object-company-verification) im `Account`-Objekt abrufen. ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", ... "company": { "verification": { "document": null }, ... }, ... } ``` Sie können die Definition für jedes Verifizierungsattribut im Objekt `Account` nachschlagen. ## Zahlungsbeschreibungen in der Abrechnung Stripe validiert die [Zahlungsbeschreibung in der Abrechnung und das Präfix](https://docs.stripe.com/connect/statement-descriptors.md) der Zahlungsbeschreibung in der Abrechnung, wenn Sie sie für ein `Account` festlegen. Beispielsweise können wir überprüfen, ob die ersten 22 Zeichen, die den Kartennetzwerken bereitgestellt werden, mit der Beschreibung des Unternehmens übereinstimmen. Wir prüfen, ob sie gut mit dem `business_profile.name`, der `business_profile.url` oder dem Namen des Unternehmens oder der Einzelperson des `Account`s übereinstimmen. Um den Verifizierungsstatus der Zahlungsbeschreibung in der Abrechnung zu überprüfen, können Sie den Hash für `requirements` für das `Account`-Objekt abrufen. Die folgenden Fehler beziehen sich auf die Verifizierung der Zahlungsbeschreibung in der Abrechnung: | Fehler | Beilegung | | --------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `invalid_statement_descriptor_length` | Die Zahlungsbeschreibung in der Abrechnung muss mindestens 5 Zeichen lang sein. | | `invalid_statement_descriptor_business_mismatch` | Die Zahlungsbeschreibung in der Abrechnung muss dem Unternehmensnamen, dem Namen der juristischen Person oder der URL des Unternehmens ähneln. | | `invalid_statement_descriptor_denylisted` `invalid_statement_descriptor_prefix_denylisted` | Die Zahlungsbeschreibung in der Abrechnung darf nicht mit einem allgemeinen oder bekannten Unternehmensnamen übereinstimmen. | | `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. | ## Handhabung von Problemen mit Verifizierungsdokumenten In der folgenden Tabelle finden Sie Informationen zur Behebung häufiger Fehler bei der Anforderungsprüfung im Zusammenhang mit hochgeladenen Dokumentdateien. Wenn die Verifizierung fehlschlägt, reichen Sie dieselbe Datei nicht erneut ein. Doppelte Uploads schlagen automatisch fehl. | Verifizierungstyp | Code | Beilegung | | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Unternehmen | `verification_failed_keyed_match`, `verification_failed_document_match` | Wir konnten die Kontodaten nicht verifizieren. Ihr/e Kontonutzer/in kann entweder ein Verifizierungsdokument hochladen oder ihre/seine Angaben aktualisieren. | | Unternehmen | `verification_failed_tax_id_not_issued`, `verification_failed_tax_id_match` | Der IRS konnte die von Ihrer Kontonutzerin oder Ihrem Kontonutzer angegebenen Informationen nicht verifizieren. Bitten Sie sie/ihn, mögliche Fehler im Unternehmensnamen oder in der Steueridentifikationsnummer zu korrigieren oder ein Dokument hochzuladen, das diese verifiziert. (nur USA) | | Unternehmen | `verification_failed_id_number_match`, `verification_failed_name_match`, `verification_failed_address_match` | Die Informationen auf dem Dokument stimmen nicht mit den Informationen überein, die von der Nutzerin/ dem Nutzer des Kontos angegeben wurden. Bitten Sie sie/ihn, ihre/seine Informationen zu prüfen und entweder zu korrigieren oder ein entsprechendes Dokument hochzuladen. | | Unternehmen | `verification_document_address_missing`, `verification_document_id_number_missing`, `verification_document_name_missing` | Im hochgeladenen Dokument fehlen die erforderlichen Informationen. Bitten Sie Ihren Kontonutzer, ein anderes Dokument hochzuladen, das die fehlenden Informationen enthält. | | Unternehmen | `verification_legal_entity_structure_mismatch` | Der Unternehmenstyp oder die Unternehmensstruktur scheint inkorrekt zu sein. Geben Sie den korrekten Unternehmenstyp und die korrekte Unternehmensstruktur für dieses Konto an. | | Identität | `verification_failed_keyed_identity` | Der Name zum Konto konnte nicht überprüft werden. Bitten Sie die/den Nutzer/in Ihres Kontos um die Bestätigung, dass er/sie seinen/ihren vollständigen rechtsgültigen Namen angegeben hat. Bitten Sie diese/n außerdem, einen amtlichen Lichtbildausweis vorzulegen, der mit diesem Namen übereinstimmt. | | Identität | `verification_document_name_mismatch`, `verification_document_dob_mismatch`, `verification_document_address_mismatch`, `verification_document_id_number_mismatch`, `verification_document_photo_mismatch` | Die Informationen auf dem Ausweisdokument stimmen nicht mit den von dem/der Nutzer/in des Kontos bereitgestellten Informationen überein. Weisen Sie bitte den/die Nutzer/in an, die für das Konto bereitgestellten Informationen zu überprüfen und zu korrigieren. | | Identität | `verification_document_fraudulent`, `verification_document_manipulated` | Das Dokument wurde möglicherweise geändert. Kontaktieren Sie den Stripe-Support, um zu erfahren, warum die Verifizierung fehlgeschlagen ist. | | Beziehung | `information_missing` | In der Fehlermeldung finden Sie die fehlenden Informationen im Dokument oder in den eingegebenen Daten. Wenn es sich um Holdinggesellschaften mit erheblichen Eigentumsanteilen handelt, gibt der Fehlercode auch die fehlenden Holdinggesellschaften an. Erfahren Sie mehr über die Überprüfung der [wirtschaftlichen Eigentumsrechte für Holdinggesellschaften](https://support.stripe.com/questions/beneficial-ownership-verification-for-holding-companies). | | Beziehung | `verification_failed_authorizer_authority` | Wir konnten die Autorität der angegebenen, zur Autorisierung bevollmächtigten Person nicht verifizieren. Ändern Sie die zur Autorisierung bevollmächtigte Person in eine Person, die als autorisierte/r Vertreter/in registriert ist. Erfahren Sie mehr über die [Verifizierung der Autorisierung des Vertreters](https://support.stripe.com/questions/representative-authority-verification). | | Beziehung | `verification_failed_representative_authority` | Wir konnten die Autorisierung des Kontovertreters/der Kontovertreterin nicht verifizieren. Fügen Sie dem Konto eine zur Autorisierung bevollmächtigte Person hinzu und legen Sie ein von dieser unterzeichnetes Autorisierungsschreiben vor. Erfahren Sie mehr über die [Verifizierung der Autorisierung des Vertreters](https://support.stripe.com/questions/representative-authority-verification). | | Beziehung | `verification_missing_owners` | Eigentümer/in des Unternehmens wurde nicht angegeben. Geben Sie Informationen für alle Unternehmenseigentümer/innen an. | | Beziehung | `verification_missing_directors` | Es wurden keine Vorstandsmitglieder angegeben. Aktualisieren Sie das Konto und laden Sie ein Registrierungsdokument mit den aktuellen Vorstandsmitgliedern hoch. | | Beziehung | `verification_document_directors_mismatch` | Die im Dokument aufgeführten Vorstandsmitglieder fehlen im Konto. Aktualisieren Sie das Konto und laden Sie ein Registrierungsdokument mit den aktuellen Vorstandsmitgliedern hoch. | | Beziehung | `verification_rejected_ownership_exemption_reason` | Wir haben den Grund für die Ausnahme zur Eigentümerschaft abgelehnt. Wählen Sie einen anderen Grund für die Ausnahme oder laden Sie einen Nachweis über die letztendliche wirtschaftliche Eigentümerschaft hoch. | | Hochladen | `verification_document_corrupt`, `verification_document_copy`, `verification_document_greyscale`, `verification_document_incomplete`, `verification_document_not_readable`, `verification_document_not_uploaded`, `verification_document_not_signed`, `verification_document_missing_back`, `verification_document_missing_front`, `verification_document_too_large` | Das Hochladen ist fehlgeschlagen, weil es ein Problem mit der Datei gab. Lassen Sie die Nutzerin oder den Nutzer Ihres Kontos eine neue Datei hochladen, die folgende Anforderungen erfüllt: - Farbbild (8.000 Pixel mal 8.000 Pixel oder kleiner) - 10 MB oder kleiner - Ausweisdokumente im JPG- oder PNG-Format - Adressnachweisdokumente oder Dokumente juristischer Personen sind im JPG-, PNG- oder PDF-Format - Rechtlich gültige Dokumente müssen alle Seiten enthalten - Darf nicht passwortgeschützt sein | | Hochladen | `verification_document_country_not_supported`, `verification_document_invalid`, `verification_document_type_not_supported` | Die angegebene Datei ist kein [akzeptabler Ausweis aus einem unterstützten Land ](https://docs.stripe.com/connect/handling-api-verification.md#acceptable-verification-documents)oder keine erwartete Dokumentenart einer juristischer Person. Bitten Sie die Nutzer/in Ihres Kontos, eine neue Datei bereitzustellen, die diese Anforderung erfüllt. | | Hochladen | `verification_document_verification_failed_other`, `verification_document_failed_other` | Kontaktieren Sie den Stripe-Support, um zu erfahren, warum die Identitätsprüfung fehlgeschlagen ist. | | Hochladen | `verification_document_expired`, `verification_document_issue_or_expiry_date_missing` | Das Dokument enthält kein Ausstellungs- oder Ablaufdatum oder das Dokument ist abgelaufen. Falls es sich um ein Ausweisdokument handelt, muss dessen Ablaufdatum nach dem Datum liegen, an dem das Dokument übermittelt wurde. Falls es sich um ein Adressdokument handelt, muss das Ausstellungsdatum innerhalb der letzten sechs Monate liegen. | ## Umgang mit URL-Verifizierungsfehlern Gemäß den Allgemeinen Geschäftsbedingungen von Stripe müssen alle E-Commerce-Unternehmen die Eigenschaft [business_profile.url](https://docs.stripe.com/api/accounts/object.md#account_object-business_profile-url) ihres `Kontos` mit einer funktionierenden URL ihrer Unternehmenswebsite ausfüllen, wenn sie die Funktion `card_payments` anfordern. Ein verbundenes Konto gilt als E-Commerce-Unternehmen, wenn es Produkte oder Dienstleistungen über eine Online-Website, ein Social-Media-Profil oder eine mobile Anwendung bewirbt oder verkauft. Weitere Informationen finden Sie in den [FAQ zur Unternehmenswebsite für die Kontoaktivierung](https://support.stripe.com/questions/business-website-for-account-activation-faq). Wenn das verbundene Konto keine Website betreibt, um für sein Unternehmen zu werben, Produkte zu verkaufen oder Zahlungen zu akzeptieren, muss es stattdessen die angeben. In einer Produktbeschreibung müssen die Art der verkauften Produkte sowie die Art und Weise, wie das Unternehmen seinen Kundinnen und Kunden Produkte oder Leistungen in Rechnung stellt (z. B. Vor-Ort-Transaktionen), aufgeführt werden. URLs für Unternehmen im E-Commerce müssen bestimmte Kartennetzwerkstandards erfüllen. Um diese Standards zu erfüllen, führt Stripe bei der Prüfung von URLs eine Reihe von Verifizierungen durch. Erfahren Sie mehr über die [Best Practices](https://docs.stripe.com/get-started/checklist/website.md) für URLs und gängige Elements für Unternehmen im E-Commerce. In vielen Fällen können Sie URL-Verifizierungsfehler beheben, indem Sie einen der folgenden Schritte ausführen: - [Erstellen eines Sanierungslinks](https://docs.stripe.com/connect/dashboard/remediation-links.md) über Ihr Plattform-Dashboard. - Aktualisieren der Wenn Sie den Fehler auf eine andere Weise beheben (z. B. indem Sie die Website des Unternehmens zur Behebung eines Problems verwenden), müssen Sie eine erneute Verifizierung auslösen, indem Sie die URL im `Account`-Objekt in einen beliebigen anderen Wert ändern und sie dann sofort wieder ändern. Nicht alle Probleme in Bezug auf URLs können mithilfe der API gelöst werden. Bestimmte Arten von URL-Verifizierungsfehlern erfordern zusätzliche Informationen zum Zugriff auf die Website des verbundenen Kontos oder zur Bestätigung, dass das Konto von den URL-Anforderungen ausgenommen ist. Für diese Art von Problemen müssen Sie oder Ihr verbundenes Konto zusätzliche Informationen bereitstellen. Wenn Sie das Problem nicht beheben können, weisen Sie Ihr verbundenes Konto an, den [Stripe-Support zu kontaktieren](https://support.stripe.com/contact). In der folgenden Tabelle finden Sie Informationen zur Behebung von URL-Verifizierungsfehlern. | Fehler | Beilegung | | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `invalid_url_denylisted` | Die angegebene URL stimmt mit einer allgemeinen Unternehmenswebsite überein, von der Stripe glaubt, dass sie nicht mit dem Konto zusammenhängt. Geben Sie eine unternehmensspezifische URL an. | | `invalid_url_format` | Die angegebene URL ist falsch formatiert. Geben Sie eine URL an, die korrekt formatiert ist, z. B. `https://example.com`. | | `invalid_url_web_presence_detected` | Wir haben festgestellt, dass das Konto eine Website, ein Social-Media-Profil oder eine Mobilanwendung verwendet, um Produkte oder Dienstleistungen zu verkaufen oder zu bewerben. Für das Konto wurde jedoch keine URL angegeben. | | `invalid_url_website_business_information_mismatch` | Die Informationen auf der Website unter der angegebenen URL stimmen nicht mit den Informationen im Stripe-Konto überein. | | `invalid_url_website_empty` | Wir können die Website unter der angegebenen URL nicht verifizieren, da die Website keine Inhalte hat. | | `invalid_url_website_inaccessible` | Wir können die Website unter der angegebenen URL nicht erreichen. Wenn Sie die Anzeige Ihrer Website für bestimmte Regionen blockieren, entfernen Sie den Blocker vorübergehend, bis Ihre Website überprüft wurde. | | `invalid_url_website_inaccessible_geoblocked` | Wir können die Website unter der angegebenen URL nicht verifizieren, da bestimmte Regionen für den Zugriff darauf gesperrt sind. Wenn Sie bestimmte Regionen daran hindern, Ihre Website anzuzeigen, entfernen Sie den Blocker vorübergehend, bis Ihre Website verifiziert wurde. | | `invalid_url_website_inaccessible_password_protected` | Wir können die Website unter der angegebenen URL nicht verifizieren, da die Website passwortgeschützt ist. | | `invalid_url_website_incomplete` | Auf der Website unter der angegebenen URL fehlt entweder der Firmenname oder eine klare Beschreibung der angebotenen Waren und Dienstleistungen. | | `invalid_url_website_incomplete_cancellation_policy` | Die Website enthält keine Stornorichtlinie. | | `invalid_url_website_incomplete_customer_service_details` | Die Website enthält keine Angaben zum Kundenservice. | | `invalid_url_website_incomplete_legal_restrictions` | Die Website enthält keine zutreffenden Hinweise für Produkte und Dienstleistungen, die rechtlichen oder Exportbeschränkungen unterliegen. | | `invalid_url_website_incomplete_refund_policy` | Die Website enthält keine Rückerstattungsrichtlinie. | | `invalid_url_website_incomplete_return_policy` | Die Website enthält keine Rückgabe- oder Retourenrichtlinie und keinen entsprechenden Prozess. | | `invalid_url_website_incomplete_terms_and_conditions` | Die Website enthält keine allgemeinen Geschäftsbedingungen. | | `invalid_url_website_incomplete_under_construction` | Wir können die Website unter der angegebenen URL nicht verifizieren, da sich die Website noch im Aufbau befindet. | | `invalid_url_website_other` | Wir können das Unternehmen des Kontos nicht über eine Website, ein Social-Media-Profil oder eine Mobilanwendung unter der angegebenen URL überprüfen. | ## Umgang mit Liveness-Anforderungen Ein Konto kann ein oder mehrere [Person](https://docs.stripe.com/api/persons.md)-Objekte haben, die einen `proof_of_liveness` erfordern. Eine `proof_of_liveness`-Anforderung kann die Erfassung eines elektronischen Identitätsnachweises wie [MyInfo](https://www.singpass.gov.sg/main/individuals/) in Singapur oder die Verwendung von Stripe Identity zur Erfassung eines Dokuments oder eines Selfies erfordern. Wir empfehlen die Verwendung von Stripe-gehostetem oder eingebettetem Onboarding, um alle Varianten der Anforderung `proof_of_liveness` zu erfüllen. #### Gehostet [Von Stripe gehostetes Onboarding](https://docs.stripe.com/connect/hosted-onboarding.md) kann alle Arten von `proof_of_liveness`-Anforderungen erfüllen. [Erstellen Sie einen Konto-Link](https://docs.stripe.com/connect/hosted-onboarding.md#create-account-link) unter Verwendung der verbundenen Konto-ID und senden Sie das Konto an die zurückgegebene `url`. ```curl curl https://api.stripe.com/v1/account_links \ -u "<>:" \ -d "account={{CONNECTEDACCOUNT_ID}}" \ --data-urlencode "refresh_url=https://example.com/refresh" \ --data-urlencode "return_url=https://example.com/return" \ -d type=account_onboarding \ -d "collection_options[fields]=currently_due" ``` Das Konto erhält eine Aufforderung, die `proof_of_liveness`-Anforderung zusammen mit allen anderen aktuell fälligen Anforderungen zu erfüllen. Überwachen Sie das Ereignis `account.updated`, das an Ihren Webhook-Endpoint gesendet wird, um benachrichtigt zu werden, wenn das Konto die Anforderungen erfüllt und seine Informationen aktualisiert. Nachdem das Konto die Anforderung erfüllt hat, wird es an die angegebene `return_url` weitergeleitet. #### Eingebettet [Das eingebettete Onboarding](https://docs.stripe.com/connect/embedded-onboarding.md) kann alle Arten von `proof_of_liveness`-Anforderungen erfüllen. Aktivieren Sie beim [Erstellen einer Kontositzung](https://docs.stripe.com/api/account_sessions/create.md) das Konto-Onboarding, indem Sie `account_onboarding` im Parameter `components` angeben. Wenn Sie keine Bankkontodaten erfassen müssen, deaktivieren Sie `external_account_collection`. Dies gilt in der Regel für Connect-Plattformen, die externe Kontoerfassungsanbieter nutzen möchten. ```curl curl https://api.stripe.com/v1/account_sessions \ -u "<>:" \ -d "account={{CONNECTEDACCOUNT_ID}}" \ -d "components[account_onboarding][enabled]=true" \ -d "components[account_onboarding][features][external_account_collection]=false" ``` Nachdem die Kontositzung erstellt und [ConnectJS initialisiert wurde](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions), können Sie die Komponente für Konto-Onboarding im Frontend darstellen: #### JavaScript ```js // Include this element in your HTML const accountOnboarding = stripeConnectInstance.create('account-onboarding'); accountOnboarding.setOnExit(() => { console.log('User exited the onboarding flow'); }); container.appendChild(accountOnboarding); // Optional: make sure to follow our policy instructions above // accountOnboarding.setFullTermsOfServiceUrl('{{URL}}') // accountOnboarding.setRecipientTermsOfServiceUrl('{{URL}}') // accountOnboarding.setPrivacyPolicyUrl('{{URL}}') // accountOnboarding.setCollectionOptions({ // fields: 'eventually_due', // futureRequirements: 'include', // requirements: { // exclude: ['business_profile.product_description'] // } // }) // accountOnboarding.setOnStepChange((stepChange) => { // console.log(`User entered: ${stepChange.step}`); // }); ``` Das Konto erhält eine Aufforderung, die `proof_of_liveness`-Anforderung zusammen mit allen anderen aktuell fälligen Anforderungen zu erfüllen. Überwachen Sie das Ereignis `account.updated`, das an Ihren Webhook-Endpoint gesendet wird, um benachrichtigt zu werden, wenn das Konto die Anforderungen erfüllt und seine Informationen aktualisiert. Nachdem das Konto die Anforderungen erfüllt hat, ruft ConnectJS Ihren `onExit`-JavaScript-Handler auf. #### Identity Sie können [Stripe Identity](https://docs.stripe.com/identity.md) verwenden, um eine `proof_of_liveness`-Anforderung für ein `Person`-Objekt zu erfüllen, indem Sie ein Dokument und ein Selfie erfassen. [Erstellen Sie eine VerificationSession](https://docs.stripe.com/api/identity/verification_sessions/create.md). Geben Sie den Parameter `related_person` an, um die erfassten Überprüfungsdaten mit dem Objekt `Person` zu verknüpfen, das den `proof_of_liveness` benötigt, wie im folgenden Beispiel gezeigt. ```curl curl https://api.stripe.com/v1/identity/verification_sessions \ -u "<>:" \ -d type=document \ -d "options[document][require_matching_selfie]=true" \ -d "related_person[account]={{CONNECTEDACCOUNT_ID}}" \ -d "related_person[person]={{PERSON_ID}}" ``` Nachdem Sie die `VerificationSession` erstellt haben, verwenden Sie das zurückgegebene `client_secret`, um den Nutzerinnen und Nutzern das Modal Identity [anzuzeigen](https://docs.stripe.com/identity/verify-identity-documents.md?platform=web&type=modal#show-modal) oder die/den Nutzer/in an die `URL` weiterzuleiten. Die Verifizierung wird abgeschlossen und das Konto wird automatisch aktualisiert. Wir senden das Ereignis `account.updated` an Ihren Webhook-Endpoint, wenn das Konto die Identitätsprüfung abgeschlossen und seine Informationen aktualisiert hat. ## Verarbeitung von Identitätsverifizierungen Abhängig von der Überprüfung der Identitätsangaben für ein Konto bitten wir Sie möglicherweise, ein oder mehrere Dokumente hochzuladen. Die erforderlichen Dokumente werden im Hash `requirements` des `Account`-Objekts angezeigt. Sie müssen die Dokumente hochladen, die in `requirements.currently_due` angezeigt werden: - `person.verification.document`: Laden Sie einen Farbscan oder ein Foto einer zulässigen Art von Ausweis hoch. - `person.verification.additional_document`: Erfordert einen Farbscan oder ein Foto eines Dokuments, aus dem die Adresse der Nutzerin oder des Nutzers hervorgeht, zum Beispiel eine Nebenkostenabrechnung. - `company.verification.document`: Laden Sie einen Identitätsnachweis hoch, aus dem die Kennnummer des Unternehmens hervorgeht, zum Beispiel eine Gründungsurkunde. Wenn `requirements.alternatives.alternative_fields_due` `verification.document`-Anforderungen enthält, können diese als Alternative zu `requirements.alternatives.original_fields_due` verwendet werden. Aus Sicherheitsgründen akzeptiert Stripe keine Ausweisdokumente per E-Mail. Das Hochladen eines Dokuments erfolgt in zwei Schritten: 1. [Datei bei Stripe hochladen](https://docs.stripe.com/connect/handling-api-verification.md#upload-a-file). 1. [Datei dem Konto zuordnen](https://docs.stripe.com/connect/handling-api-verification.md#attach-a-file). ### Datei hochladen Um eine Datei hochzuladen, rufen Sie die Files API auf, um [eine Datei zu erstellen](https://docs.stripe.com/api/files/create.md). Die hochgeladene Datei muss folgende Anforderungen erfüllen: - Farbbild (8.000 Pixel mal 8.000 Pixel oder kleiner) - 10 MB oder kleiner - Ausweisdokumente im JPG- oder PNG-Format - Adressnachweisdokumente oder Dokumente juristischer Personen sind im JPG-, PNG- oder PDF-Format Übergeben Sie die Dateidaten im Parameter `file` und legen Sie den Parameter [Zweck](https://docs.stripe.com/api/files/create.md#create_file-purpose) entsprechend dem Objekt `Account` oder `Person` fest, das dieses Dokument enthalten soll. Um den Zweck zu identifizieren, suchen Sie die Eigenschaft in der API-Referenz. #### Curl ```bash curl https://files.stripe.com/v1/files \ -u <>: \ -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}" \ -F "purpose"="identity_document" \ -F "file"="@/path/to/a/file" ``` Mit dieser Anfrage wird die Datei hochgeladen und ein Token zurückgegeben: ```json { "id": ""{{FILE_ID}}"", "created": 1403047735, "size": 4908 } ``` Verwenden Sie den `id`-Wert des Tokens, um die Datei zur Identitätsprüfung an ein verbundenes Konto anzufügen. ### Datei anhängen Nachdem Sie die Datei hochgeladen und einen repräsentativen Token erhalten haben, aktualisieren Sie das Objekt `Account` oder `Person` und geben Sie die Datei-ID im entsprechenden Parameter an. Das folgende Beispiel gilt für ein behördlich ausgestelltes Ausweisdokument: ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}}/persons/{{PERSON_ID}} \ -u "<>:" \ -d "verification[document][front]={{FILE_ID}}" ``` Das folgende Beispiel bezieht sich auf ein Dokument eines Unternehmens: ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" \ -d "company[verification][document][front]={{FILE_ID}}" ``` Durch diese Aktualisierung ändert sich der `verification.status` in `pending`. Wenn eine zusätzliche Person verifiziert werden muss, verwenden Sie die [Persons API](https://docs.stripe.com/api/persons.md), um sie zu aktualisieren. ### Ausweisverifizierung bestätigen Wenn alle Anforderungen an die Identitätsprüfung für eine Person oder ein Unternehmen erfüllt sind, wird eine Webhook-Benachrichtigung vom Typ `v2.core.account_person.updated` oder `v2.core.account[identity].updated` ausgelöst, die signalisiert, dass der Verifizierungsprozess abgeschlossen ist. Je nach Lesbarkeit kann die Überprüfung eines Bildes durch Stripe zwischen einigen Minuten und mehreren Werktagen dauern. Wenn der Verifizierungsversuch fehlschlägt, enthält der zugehörige Anforderungseintrag einen Fehler mit einem `code` und einer `description` zur Beschreibung der Ursache. Bei der `description` handelt es sich um eine nicht lokalisierte Klartextmeldung, wie z. B. „Das bereitgestellte Bild ist nicht lesbar“, die Sie Ihren Nutzerinnen und Nutzern des Kontos vorlegen können. Der `code` ist eine Zeichenfolge, wie z. B. `verification_document_not_readable`, mit der Sie Fehlermeldungen für Ihre Konto-Nutzer/innen lokal anpassen können. Eine fehlgeschlagene Verifizierung löst ebenfalls eine Webhook-Benachrichtigung vom Typ `v2.core.account_person.updated` oder `v2.core.account[identity].updated` aus. ### Gehostete Dokumentenerfassung mit Stripe Identity Sie können [Stripe Identity](https://docs.stripe.com/identity.md) verwenden, um die Anforderung `person.verification.document` zu erfüllen, indem Sie ein Dokument erfassen und es direkt dem Konto zuordnen. Sie können Stripe Identity jedoch nicht verwenden, um die Anforderungen `person.verification.additional_document` oder `business.verification.document` zu erfüllen. [Erstellen Sie eine VerificationSession](https://docs.stripe.com/api/identity/verification_sessions/create.md). Geben Sie den Parameter `related_person` an, um die erfassten Überprüfungsdaten mit dem Objekt `Person`` zu verknüpfen, das das`document` benötigt, wie im folgenden Beispiel gezeigt: ```curl curl https://api.stripe.com/v1/identity/verification_sessions \ -u "<>:" \ -d type=document \ -d "related_person[account]={{CONNECTEDACCOUNT_ID}}" \ -d "related_person[person]={{PERSON_ID}}" ``` Nachdem Sie die `VerificationSession` erstellt haben, verwenden Sie das zurückgegebene `client_secret`, um den Nutzer/innen das Modal Identity [anzuzeigen](https://docs.stripe.com/identity/verify-identity-documents.md?platform=web&type=modal#show-modal) oder die Nutzer/innen an die `url` weiterzuleiten. Die Verifizierung wird abgeschlossen und das Konto wird automatisch aktualisiert. Wir senden das Ereignis `account.updated` an Ihren Webhook-Endpoint, wenn das Konto die Identitätsprüfung abgeschlossen und seine Informationen aktualisiert hat. ## Handhabung formular- oder supportbasierter Anforderungen Stripe meldet Risiko- und Compliance-Anforderungen im Hash [Anforderungen](https://docs.stripe.com/api/accounts/object.md#account_object-requirements). Diese Anforderungen haben das Format `..`. - `id`: kennzeichnet eindeutig die von Stripe oder unseren Finanzpartnern benötigten Informationen. Dieser Kennung wird immer `interv_` vorangestellt, um anzuzeigen, dass es sich um eine Anforderung zur Risikoprüfung handelt. - `requirement_description`: beschreibt speziell die Informationen, die erforderlich sind, um die Anforderung zu erfüllen, wie zum Beispiel `identity_verification`, `rejection_appeal` usw. - `resolution_path`: gibt an, wie Sie oder Ihr verbundenes Konto die angeforderten Informationen bereitstellen können: - `challenge`: Das verbundene Konto muss auf anfragebasierte Eingabeaufforderungen direkt reagieren. Dabei werden häufig sensible Daten wie beispielsweise Bankkonten oder Informationen verlangt, die nur die Kontoinhaber/innen bereitstellen können, z. B. Selfies. - `form`: Das verbundene Konto kann Formularanfragen ausfüllen oder Sie können sie in seinem Namen ausfüllen. - `notice`: Das verbundene Konto muss das Problem über eine Drittpartei lösen (z. B. indem ein Pfandgläubiger eine Freigabebenachrichtigung an Stripe sendet). - `support`: Die Anforderung ist nicht direkt umsetzbar. Kontaktieren Sie den [Stripe-Support](https://support.stripe.com/). - `underwriting_case`: Stripe hat zusätzliche Informationen über das verbundene Konto im Dashboard für die Risikoevaluation angefordert. ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", "requirements": { "current_deadline": 1234567800, "currently_due": [ "{{REQUIREMENT_ID}}.restricted_or_prohibited_industry_diligence.form" ], "pending_verification": [], ... }, ... } ``` Nachdem ein Lösungspfad erfolgreich bearbeitet wurde, kann sich der Wert des Lösungspfads der Anforderung in `support` ändern und die Anforderung wird auch im Abschnitt `pending_verification` des Anforderungs-Hash angezeigt. Stripe überprüft die übermittelten Informationen und weist die Anforderung entweder als erledigt zurück oder veröffentlicht eine neue, derzeit fällige Anforderung. ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", "requirements": { "current_deadline": 1234567800, "currently_due": [], "pending_verification": [ "{{REQUIREMENT_ID}}.restricted_or_prohibited_industry_diligence.support" ], ... }, ... } ``` Je nach Art der Anforderung können Sie die Risiko- und Compliance-Anforderungen auf eine der folgenden Arten beheben: - **In Connect eingebettete Komponenten**: [Betten Sie Connect-Komponenten](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) in Ihre Website ein und leiten Sie Ihre Nutzer/innen zur eingebetteten Komponente für das [Konto-Onboarding](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md) weiter, wo sie aufgefordert werden, ausstehende Felder in Ihrer Nutzeroberfläche auszufüllen. Alternativ können Sie die eingebettete Komponente für [Benachrichtigungsbanner](https://docs.stripe.com/connect/supported-embedded-components/notification-banner.md) verwenden, um Ihre Nutzer/innen zur Erfüllung ausstehender Anforderungen aufzufordern. - **Von Stripe gehostetes Onboarding:** Sie können Links generieren, um Ihre verbundenen Konten anzuweisen, ausstehende Anforderungen zu erfüllen. Dies kann entweder programmgesteuert über Konto-Links oder manuell in Ihrem [Plattform-Dashboard](https://docs.stripe.com/connect/dashboard/review-actionable-accounts.md) erledigt werden. - **Im Auftrag Ihrer Konten ausfüllen**: Verwenden Sie Ihr [Plattform-Dashboard](https://docs.stripe.com/connect/dashboard/review-actionable-accounts.md), um formularbasierte Risikoanforderungen im Auftrag Ihrer Konten auf Grundlage der Details verbundener Konten zu ermitteln und auszufüllen. Die folgende Tabelle enthält weitere Informationen zu Risiko- und Compliance Anforderungen. | Wert | Beschreibung | | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `business_model_verification` | Wir benötigen weitere Informationen über die Art des Unternehmens, um zu prüfen, ob wir das Konto unterstützen können. | | `restricted_or_prohibited_industry_diligence` | Das Unternehmen ist eventuell in einer [eingeschränkten Kategorie](https://stripe.com/legal/restricted-businesses) tätig (zum Beispiel Verkauf von Alkohol, Versicherungen oder Finanzprodukten). Stripe benötigt möglicherweise weitere Informationen über die Art des Unternehmens oder Lizenzinformationen, um zu prüfen, ob wir das Konto unterstützen können. | | `intellectual_property_usage` | Das Unternehmen verkauft möglicherweise Produkte oder Dienstleistungen, die urheberrechtlich geschützt sind. Wir benötigen weitere Informationen, um zu überprüfen, ob das Konto zum Verkauf dieser Produkte autorisiert ist. | | `supportability_rejection_appeal` | Die Allgemeinen Geschäftsbedingungen von Stripe untersagen die Unterstützung des Unternehmens. Das Konto kann diese Entscheidung anfechten. | | `other_supportability_inquiry` | Wir benötigen weitere Informationen, um zu prüfen, ob wir das Konto unterstützen können. | | `credit_review` | Wir benötigen weitere Informationen über die Art des Unternehmens, um zu prüfen, ob wir das Konto unterstützen können. | | `reserve_appeal` | Wir haben dem Konto eine Rückstellung zugewiesen. Diese Rückstellung hat keinen Einfluss auf die Fähigkeit des Kontos, Zahlungen bei Stripe anzunehmen. Das Konto kann diese Entscheidung anfechten. | | `identity_verification` | Die Person, die für das Konto verantwortlich ist, muss ihre Identität durch Hochladen eines behördlich ausgestellten Ausweisdokuments und eines Selfies verifizieren. | | `url_inquiry` | Die URL des Unternehmens muss die vom Unternehmen angebotenen Produkte und Dienstleistungen widerspiegeln. Möglicherweise muss die URL geändert werden, damit wir das Konto unterstützen können. | | `address_verification` | Wir müssen die Adresse des Unternehmens durch Hochladen der Dokumente verifizieren. | | `bank_account_verification` | Wir müssen die mit dem Unternehmen verbundenen Bankkontodetails verifizieren. | | `customer_service_contact` | Wir müssen die Kontaktinformationen für den Kundendienst eines Unternehmens verifizieren. | | `domain_verification` | Wir müssen überprüfen, ob der/die Kontoinhaber/in die Kontrolle über die von ihm/ihr angegebene URL oder Domain hat. | | `fulfillment_policy` | Wir müssen die Fulfillment-Richtlinie des Unternehmens verifizieren. | | `other_compliance_inquiry` | Wir benötigen weitere Compliance-Informationen, die zu keiner der anderen Beschreibungen passen. | | `other_business_inquiry` | Wir benötigen weitere Unternehmensinformationen, die zu keiner der anderen Beschreibungen passen. | | `platform_concern` | Die Plattform hat eine Intervention (echter oder API-Integrationstest) für ihr eigenes verbundenes Konto initiiert. | | `product_description` | Das Stripe-Konto des Unternehmens muss eine genaue Produktbeschreibung enthalten. | | `rejection_appeal` | Die Allgemeinen Geschäftsbedingungen von Stripe verbieten die Unterstützung dieses Unternehmens wegen dessen Risikoebene. Das Konto kann diese Entscheidung anfechten. | | `statement_descriptor` | Wir benötigen eine Zahlungsbeschreibung in der Abrechnung, die das Unternehmen gut beschreibt. | | `sanctions_review` | Wir müssen verifizieren, dass das Unternehmen nicht mit einer sanktionierten Person oder einem Zuständigkeitsbereich in Verbindung steht. | | `pep_review` | Wir müssen verifizieren, dass das Unternehmen nicht mit einer Person von Interesse oder einer politisch exponierten Person in Verbindung steht. | | `legal_hold` | Stripe ist gesetzlich verpflichtet, Gelder zurückzuhalten. Die Erfüllung dieser Anforderung kann die Auszahlung der Gelder an eine Drittpartei beinhalten. | ### Anforderungen nach Funktion abrufen Mit der [Capabilities API](https://docs.stripe.com/api/capabilities.md) können Sie für jede Funktion spezifische Risiko- und Compliance-Anforderungen abrufen. Jede Funktion verfügt über einen Hash `Anforderungen`, der angibt, welche spezifischen Anforderungen sich auf diese Funktion auswirken. Dies kann Ihnen helfen, den Status einer bestimmten Funktion zu verstehen. ## See also - [Identitätsprüfung bei verbundenen Konten](https://docs.stripe.com/connect/identity-verification.md) - [Konto-Token](https://docs.stripe.com/connect/account-tokens.md) - [Connect testen](https://docs.stripe.com/connect/testing.md) - [Identitätsprüfung bei Konten testen](https://docs.stripe.com/connect/testing-verification.md) - [Erforderliche Verifizierungsinformationen](https://docs.stripe.com/connect/required-verification-information.md)