Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellenAnmelden
Jetzt starten
Zahlungen
Umsatz
Plattformen und Marktplätze
Geldmanagement
Entwicklerressourcen
APIs und SDKsHilfe
Übersicht
Mit Connect loslegen
Gestalten Sie Ihre Integration
Integrationsgrundlagen
Musterintegrationen
Kontoverwaltung
Onboarding von Konten
    Onboarding-Konfiguration auswählen
    Funktionen und Konfigurationen von Konten
    Erforderliche Verifizierungsinformationen
      Umgang mit Verifizierungsaktualisierungen
      Verarbeitung von Verifizierungen mit der API
      Verarbeitung von Verifizierungen mit Token
      Kontoverifizierung testen
      Identitätsprüfung für verbundene Konten
      Verifizierte Informationen aktualisieren
    Arten von Rahmenverträgen
    Zusätzliche Verifizierungen
    Vernetztes Onboarding
    Auf Stripe umsteigen
Konto-Dashboards konfigurieren
Mit verbundenen Kontotypen zusammenarbeiten
Zahlungsabwicklung
Zahlungen weltweit akzeptieren
Verbundene Konten auszahlen
Plattformverwaltung
Ihre Connect-Plattform verwalten
Steuerformulare für Ihre Connect-Plattform
Vereinigte Staaten
Deutsch
StartseitePlattformen und MarktplätzeOnboard accountsRequired verification information

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.

Anwendbare verbundene Konten

Dieser Inhalt gilt nur für verbundene Konten mit bestimmten Konfigurationen.
Dieser Inhalt gilt für verbundene Konten, wenn die Plattform dafür verantwortlich ist, aktualisierte Informationen zu erfassen, wenn Anforderungen fällig sind oder sich ändern.

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 (KYC) zu ermöglichen und Kontofunktionen 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 zeitnah bearbeiten.

Verifizierungsvorgang

Bevor Zahlungen und Auszahlungen 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, der für die verbundenen Konten gilt
  • Für die verbundenen Konten angeforderte Funktionen
  • Der business_type (zum Beispiel Einzelperson oder Unternehmen) und die company.structure (zum Beispiel public_corporation oder private_partnership)

Um die KYC-Anforderungen zu erfüllen, müssen Plattformen das geeignete Onboarding-Verfahren 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 in Ihren Webhook-Einstellungen ein, um auf Aktivitäten zu achten, insbesondere auf account.updated-Ereignisse. Achten Sie bei Verwendung der Persons API auch auf person.updated-Ereignisse.
  2. Überprüfen Sie unmittelbar nach der Erstellung eines Kontos das Attribut requirements.currently_duedes 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.
  3. 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 aktiv werden oder das verbundene Konto kann sie über eine in Connect eingebettete Komponente, von Stripe gehostetes Onboarding oder einen Sanierungslink 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 Accounts, um festzustellen, welche Informationen für die Aktivierung von Zahlungen und Auszahlungen erforderlich sind.

Der requirements-Hash enthält die folgenden Eigenschaften:

EigenschaftBeschreibung
current_deadlineDas 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_dueEin Array mit den Anforderungen, die Sie bis zur current_deadline erfüllen müssen, damit das Konto active bleibt.
disabled_reasonBeschreibt, warum das Konto nicht aktiviert ist und warum es keine Zahlungen oder Transfers verarbeiten kann.
errorsEin Array mit Details zu allen currently_due-Anforderungen mit Fehlern, die Sie beheben müssen. Weitere Informationen finden Sie im Abschnitt Validierungs- und Verifizierungsfehler.
eventually_dueEin 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_dueEin 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_verificationArray 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.

{ "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 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 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.
UrsacheBedeutung
action_required.requested_capabilitiesSie müssen Funktionen für das verbundene Konto anfordern.
listedDas 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.fraudDas Konto wurde wegen Verdachts auf Betrug oder illegale Aktivitäten abgelehnt.
rejected.incomplete_verificationDas Konto wird aufgrund unvollständiger Verifizierungsanforderungen innerhalb des erforderlichen Schwellenwerts abgelehnt.
rejected.listedDas Konto wurde abgelehnt, weil es sich auf einer externen Liste verbotener Personen oder Unternehmen befindet (z. B. Finanzdienstleister oder Regierung).
rejected.otherDas Konto wurde aus einem anderen Grund abgelehnt.
rejected.terms_of_serviceDas Konto wurde wegen Verdachts auf Verletzungen der Allgemeine Geschäftsbedingungen abgelehnt.
requirements.past_dueEs sind zusätzliche Verifizierungsinformationen erforderlich, um Funktionen für dieses Konto zu aktivieren.
requirements.pending_verificationStripe verifiziert derzeit die Informationen des verbundenen Kontos. Es sind keine Maßnahmen erforderlich. Überprüfen Sie die das Array requirements.pending_verification, um die zu verifizierenden Informationen anzuzeigen.
under_reviewDas Konto wird durch Stripe geprüft.

Validierungs- und Verifizierungsfehler

Das Account-Objekt enthält ein Array 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:

AttributBeschreibung
codeGibt die Art des aufgetretenen Fehlers an. Alle möglichen Fehlercodes finden Sie in der API-Dokumentation.
reasonEine Klartextnachricht, die erklärt, warum der Fehler aufgetreten ist und wie er behoben werden kann.
requirementGibt 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.

{ "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, 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:

FehlerBeilegung
invalid_business_profile_nameUnternehmensnamen müssen leicht verständlich sein und aus erkennbaren Wörtern bestehen.
invalid_business_profile_name_denylistedDer Unternehmensname muss mit dem Unternehmen des Konto übereinstimmen und darf kein allgemeiner oder bekannter Name sein.
invalid_product_description_lengthDie Produktbeschreibung muss mindestens 10 Zeichen lang sein.
invalid_product_description_url_matchDie Produktbeschreibung muss sich von der Unternehmens-URL unterscheiden.

Unter Umgang mit URL-Verifizierungsfehlern 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, um die Informationen zu einem mit dem Account-Objekt verknüpften Person-Objekt hinzuzufügen. Um Dokumente zum Verifizierungs-Hash des Person-Objekts hinzuzufügen, verwenden Sie zunächst die Files API, um die Dokumentdateien auf die Server von Stripe hochzuladen.

Für Einzelpersonen können Sie entweder eine Person erstellen oder die Informationen zum einzelnen 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 Accounts zu überprüfen, können Sie dessen Hash für Anforderungen abrufen.

Die folgenden Fehler beziehen sich auf die Personenverifizierung:

FehlerBeilegung
invalid_address_city_state_postal_codeStripe konnte die Kombination aus Stadt, Bundesland und Postleitzahl in der angegebenen Adresse nicht validieren.
invalid_address_highway_contract_boxDie 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_mailboxDie 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_minimumDie Person muss mindestens 13 Jahre alt sein.
invalid_dob_age_over_maximumDas Geburtsdatum der Person muss innerhalb der letzten 120 Jahre liegen.
invalid_phone_numberStripe konnte die Telefonnummer für das Konto nicht validieren. Stellen Sie sicher, dass die Formatierung dem Land der Person entspricht.
invalid_street_addressStripe 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.

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 im Account-Objekt abrufen.

{ "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 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 Accounts ü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:

FehlerBeilegung
invalid_statement_descriptor_lengthDie Zahlungsbeschreibung in der Abrechnung muss mindestens 5 Zeichen lang sein.
invalid_statement_descriptor_business_mismatchDie 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_mismatchDas 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.

VerifizierungstypCodeBeilegung
Unternehmenverification_failed_keyed_match, verification_failed_document_matchWir konnten die Kontodaten nicht verifizieren. Ihr/e Kontonutzer/in kann entweder ein Verifizierungsdokument hochladen oder ihre/seine Angaben aktualisieren.
Unternehmenverification_failed_tax_id_not_issued, verification_failed_tax_id_matchDer 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)
Unternehmenverification_failed_id_number_match, verification_failed_name_match, verification_failed_address_matchDie 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.
Unternehmenverification_document_address_missing, verification_document_id_number_missing, verification_document_name_missingIm hochgeladenen Dokument fehlen die erforderlichen Informationen. Bitten Sie Ihren Kontonutzer, ein anderes Dokument hochzuladen, das die fehlenden Informationen enthält.
Unternehmenverification_legal_entity_structure_mismatchDer Unternehmenstyp oder die Unternehmensstruktur scheint inkorrekt zu sein. Geben Sie den korrekten Unternehmenstyp und die korrekte Unternehmensstruktur für dieses Konto an.
Identitätverification_failed_keyed_identityDer 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ätverification_document_name_mismatch, verification_document_dob_mismatch, verification_document_address_mismatch, verification_document_id_number_mismatch, verification_document_photo_mismatchDie 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ätverification_document_fraudulent, verification_document_manipulatedDas Dokument wurde möglicherweise geändert. Kontaktieren Sie den Stripe-Support, um zu erfahren, warum die Verifizierung fehlgeschlagen ist.
Beziehunginformation_missingIn 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.
Beziehungverification_failed_authorizer_authorityWir 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.
Beziehungverification_failed_representative_authorityWir 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.
Beziehungverification_missing_ownersEigentümer/in des Unternehmens wurde nicht angegeben. Geben Sie Informationen für alle Unternehmenseigentümer/innen an.
Beziehungverification_missing_directorsEs wurden keine Vorstandsmitglieder angegeben. Aktualisieren Sie das Konto und laden Sie ein Registrierungsdokument mit den aktuellen Vorstandsmitgliedern hoch.
Beziehungverification_document_directors_mismatchDie im Dokument aufgeführten Vorstandsmitglieder fehlen im Konto. Aktualisieren Sie das Konto und laden Sie ein Registrierungsdokument mit den aktuellen Vorstandsmitgliedern hoch.
Beziehungverification_rejected_ownership_exemption_reasonWir 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.
Hochladenverification_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_largeDas 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
Hochladenverification_document_country_not_supported, verification_document_invalid, verification_document_type_not_supportedDie angegebene Datei ist kein akzeptabler Ausweis aus einem unterstützten Land oder keine erwartete Dokumentenart einer juristischer Person. Bitten Sie die Nutzer/in Ihres Kontos, eine neue Datei bereitzustellen, die diese Anforderung erfüllt.
Hochladenverification_document_verification_failed_other, verification_document_failed_otherKontaktieren Sie den Stripe-Support, um zu erfahren, warum die Identitätsprüfung fehlgeschlagen ist.
Hochladenverification_document_expired, verification_document_issue_or_expiry_date_missingDas 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 ihres Accounts 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 unter FAQ zur Unternehmenswebsite für die Kontoaktivierung.

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. persönliche 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 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 ü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.

In der folgenden Tabelle finden Sie Informationen zur Behebung von URL-Verifizierungsfehlern.

FehlerBeilegung
invalid_url_denylistedDie 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_formatDie angegebene URL ist falsch formatiert. Geben Sie eine URL an, die korrekt formatiert ist, z. B. https://example.com.
invalid_url_web_presence_detectedWir 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_mismatchDie Informationen auf der Website unter der angegebenen URL stimmen nicht mit den Informationen im Stripe-Konto überein.
invalid_url_website_emptyWir können die Website unter der angegebenen URL nicht verifizieren, da die Website keine Inhalte hat.
invalid_url_website_inaccessibleWir 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_geoblockedWir 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_protectedWir können die Website unter der angegebenen URL nicht verifizieren, da die Website passwortgeschützt ist.
invalid_url_website_incompleteAuf der Website unter der angegebenen URL fehlt entweder der Firmenname oder eine klare Beschreibung der angebotenen Waren und Dienstleistungen.
invalid_url_website_incomplete_cancellation_policyDie Website enthält keine Stornorichtlinie.
invalid_url_website_incomplete_customer_service_detailsDie Website enthält keine Angaben zum Kundenservice.
invalid_url_website_incomplete_legal_restrictionsDie Website enthält keine zutreffenden Hinweise für Produkte und Dienstleistungen, die rechtlichen oder Exportbeschränkungen unterliegen.
invalid_url_website_incomplete_refund_policyDie Website enthält keine Rückerstattungsrichtlinie.
invalid_url_website_incomplete_return_policyDie Website enthält keine Rückgabe- oder Retourenrichtlinie und keinen entsprechenden Prozess.
invalid_url_website_incomplete_terms_and_conditionsDie Website enthält keine allgemeinen Geschäftsbedingungen.
invalid_url_website_incomplete_under_constructionWir können die Website unter der angegebenen URL nicht verifizieren, da sich die Website noch im Aufbau befindet.
invalid_url_website_otherWir 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-Objekte haben, die einen proof_of_liveness erfordern. Eine proof_of_liveness-Anforderung kann die Erfassung eines elektronischen Identitätsnachweises wie MyInfo 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.

Von Stripe gehostetes Onboarding kann alle Arten von proof_of_liveness-Anforderungen erfüllen.

Erstellen Sie einen Konto-Link unter Verwendung der verbundenen Konto-ID und senden Sie das Konto an die zurückgegebene url.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_links \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d account=
"{{CONNECTED_ACCOUNT_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.

Verarbeitung von Identitätsverifizierungen

Je nach den Identitätsangaben, die wir für ein Konto verifiziert haben, bitten wir Sie möglicherweise, ein oder mehrere Dokumente hochzuladen. Die erforderlichen Dokumente erscheinen im Hash für requirements im Account-Objekt.

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.
  2. Datei dem Konto zuordnen.

Datei hochladen

Um eine Datei hochzuladen, rufen Sie die Files API auf, um eine Datei zu erstellen.

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

Command Line
Curl
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://files.stripe.com/v1/files \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -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:

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

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/persons/
{{PERSON_ID}}
\ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d "verification[document][front]"=
"{{FILE_ID}}"

Das folgende Beispiel bezieht sich auf ein Dokument eines Unternehmens:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
\ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -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, 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 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. 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:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/identity/verification_sessions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d type=document \ -d "related_person[account]"=
"{{CONNECTED_ACCOUNT_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 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. Diese Anforderungen haben das Format <id>.<requirement_description>.<resolution_path>.

  • 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.
    • support: Die Anforderung ist nicht direkt umsetzbar. Kontaktieren Sie den Stripe-Support.
{ "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.

{ "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 in Ihre Website ein und leiten Sie Ihre Nutzer/innen zur eingebetteten Komponente für das Konto-Onboarding weiter, wo sie aufgefordert werden, ausstehende Felder in Ihrer Nutzeroberfläche auszufüllen. Alternativ können Sie die eingebettete Komponente für Benachrichtigungsbanner 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 erledigt werden.
  • Im Auftrag Ihrer Konten ausfüllen: Verwenden Sie Ihr Plattform-Dashboard, 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.

WertBeschreibung
business_model_verificationWir 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_diligenceDas Unternehmen ist eventuell in einer eingeschränkten Kategorie 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_usageDas 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_appealDie Allgemeinen Geschäftsbedingungen von Stripe untersagen die Unterstützung des Unternehmens. Das Konto kann diese Entscheidung anfechten.
other_supportability_inquiryWir benötigen weitere Informationen, um zu prüfen, ob wir das Konto unterstützen können.
credit_reviewWir benötigen weitere Informationen über die Art des Unternehmens, um zu prüfen, ob wir das Konto unterstützen können.
reserve_appealWir 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_verificationDie Person, die für das Konto verantwortlich ist, muss ihre Identität durch Hochladen eines behördlich ausgestellten Ausweisdokuments und eines Selfies verifizieren.
url_inquiryDie 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_verificationWir müssen die Adresse des Unternehmens durch Hochladen der Dokumente verifizieren.
bank_account_verificationWir müssen die mit dem Unternehmen verbundenen Bankkontodetails verifizieren.
capability_disable_appealDie Allgemeinen Geschäftsbedingungen von Stripe untersagen die Unterstützung bestimmter Funktionen, die mit diesem Unternehmen verbunden sind. Das Konto kann diese Entscheidung anfechten.
customer_service_contactWir müssen die Kontaktinformationen für den Kundendienst eines Unternehmens verifizieren.
domain_verificationWir müssen überprüfen, ob der/die Kontoinhaber/in die Kontrolle über die von ihm/ihr angegebene URL oder Domain hat.
fulfillment_policyWir müssen die Fulfillment-Richtlinie des Unternehmens verifizieren.
other_compliance_inquiryWir benötigen weitere Compliance-Informationen, die zu keiner der anderen Beschreibungen passen.
other_business_inquiryWir benötigen weitere Unternehmensinformationen, die zu keiner der anderen Beschreibungen passen.
platform_concernDie Plattform hat eine Intervention (echter oder API-Integrationstest) für ihr eigenes verbundenes Konto initiiert.
product_descriptionDas Stripe-Konto des Unternehmens muss eine genaue Produktbeschreibung enthalten.
rejection_appealDie Allgemeinen Geschäftsbedingungen von Stripe verbieten die Unterstützung dieses Unternehmens wegen dessen Risikoebene. Das Konto kann diese Entscheidung anfechten.
statement_descriptorWir benötigen eine Zahlungsbeschreibung in der Abrechnung, die das Unternehmen gut beschreibt.

Siehe auch

  • Identitätsprüfung bei verbundenen Konten
  • Konto-Token
  • Connect testen
  • Identitätsprüfung bei Konten testen
  • Erforderliche Verifizierungsinformationen
War diese Seite hilfreich?
JaNein
  • Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
  • Schauen Sie sich unser Änderungsprotokoll an.
  • Fragen? Sales-Team kontaktieren.
  • LLM? Lesen Sie llms.txt.
  • Unterstützt von Markdoc