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.
Plattformen mit Konten, die über die API erstellt wurden, können Stripe die erforderlichen Informationen über ihre Nutzer/innen für Know-Your-Customer(KYC)-Zwecke zur Verfügung stellen. Plattformen können Connect Onboarding verwenden, um KYC-Informationen zu erfassen. Alternativ können sie Stripe die erforderlichen Informationen über die Accounts und die Persons API zur Verfügung stellen. Anschließend führen wir die Verifizierung durch und holen bei Bedarf weitere Informationen ein.
Die übrigen Informationen auf dieser Seite beziehen sich auf die Frage, wie Plattformen:
- Erfahren Sie mehr über die Verifizierungsanforderungen für ein verbundenes Konto
- Stripe die erforderlichen Informationen zur Verfügung stellen
Notiz
Sie können die API nicht verwenden, um auf Stripe-Risikoprüfungen zu antworten. Sie können Ihre verbundenen Konten aktivieren, damit diese über eingebettete Komponenten, von Stripe gehostetes Onboarding oder Sanierungslinks reagieren können. Außerdem können Sie im Auftrag Ihrer verbundenen Konten über das Dashboard auf Risikoprüfungen antworten.
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 Unternehmenstyp (zum Beispiel Einzelperson oder Unternehmen) und company.structure (zum Beispiel öffentliche Kapitalgesellschaft oder private Partnerschaft)
Um die KYC-Anforderungen zu erfüllen, müssen Plattformen das geeignete Onboarding-Verfahren für ihr Unternehmen und ihre Nutzer/innen auswählen. Im Grunde 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 kann.
- Richten Sie in Ihren Webhook-Einstellungen eine Connect Webhook-URL ein, um über bestimmte Aktivitäten, insbesondere Ereignisse vom Typ
account.
, benachrichtigt zu werden. Bei der Verwendung der Persons API sollten Sie außerdem nach Ereignissen vom Typupdated person.
Ausschau halten.updated - Überprüfen Sie unmittelbar nach der Erstellung eines Kontos das Attribut requirements.currently_due des
Account
-Objekts auf zusätzliche Anforderungen. Fordern Sie alle erforderlichen Informationen von der Nutzerin/dem Nutzer an und aktualisieren Sie das verbundene Konto. - Achten Sie weiter auf Benachrichtigungen zu Ereignissen vom Typ
account.
, um zu sehen, ob sich derupdated requirements
-Hash ändert. Wenden Sie sich an Ihre Nutzerinnen und Nutzer, 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).
Vorsicht
Wenn das Attribut requirements.
nicht leer ist, sind zusätzliche Informationen erforderlich. Wenn Sie diese Informationen nicht zeitnah bereitstellen, können verbundene Konten unter Umständen keine Zahlungen mehr erstellen, keine Auszahlungen empfangen oder bestimmte Aufgaben nicht ausführen.
Ändern von Informationen nach der Verifizierung
Nachdem eine Einzelperson oder ein Unternehmen verifiziert wurde, können Sie einige Informationen ändern, wobei hier Einschränkungen gelten. Einschränkungen basierend auf der Konfiguration des verbundenen Kontos finden Sie in der Update Account API. Kontaktieren Sie unseren Support, wenn Sie darüber hinausgehende Änderungen vornehmen möchten.
Ermitteln, ob eine Verifizierung erforderlich ist
Wenn Sie ein Webhook-Ereignis vom Typ account.
erhalten oder mit der API ein Konto abrufen, erhalten Sie ein Account-Objekt. Die Attribute charges_
und payouts_
des Objekts Account
geben an, ob das Konto Zahlungen erstellen und Auszahlungen annehmen kann.
Das Account
-Objekt verfügt über einen requirements
-Hash, der die zur Verifizierung des Kontos erforderlichen Anforderungen darstellt.
Der Hash requirements
hat die folgenden Arrays:
eventually_
: Anforderungen, die Sie möglicherweise erfassen müssen, je nachdem, ob die entsprechenden Schwellenwerte erreicht werden. Nachdem eine Anforderung erforderlich wird, erscheint sie auch in der Listedue currently_
. Wenn eine Anforderung erforderlich wird und ihr Fälligkeitsdatum vor der bestehendendue current_
liegt, ändert sich diedeadline current_
in das Datum der Erzwingung des entsprechenden Schwellenwerts.deadline currently_
: Anforderungen, die Sie bis zurdue current_
erfassen müssen, damit das Kontodeadline active
bleibt.currently_
ist eine Untergruppe vondue eventually_
.due past_
: Anforderungen, die Funktionen deaktiviert haben, weil sie nicht vor derdue current_
verifiziertdeadline wurden.
past_dueist eine Untergruppe von
currently_due`.errors
: Details zu Validierungs- und Verifizierungsfehlern, für die bestimmte Anforderungen incurrently_
oderdue past_
erneut erfasst werden müssen.due requirement
: Identifiziert die Anforderung, die dem Fehler entspricht.code
: Ein ENUM-Wert, der beschreibt, warum die Anforderung ungültig ist oder nicht verifiziert werden kann.reason
: Eine Mitteilung in Englisch, die den Fehler genauer beschreibt. Die Zeichenfolge mit dem Grund kann auch vorschlagen, wie der Fehler behoben werden kann.
disabled_
: Beschreibt, warum das Konto nicht aktiviert ist und warum es keine Zahlungen oder Überweisungen verarbeiten kann.reason current_
: Datum, bis zu dem die Anforderungen indeadline currently_
erfasst werden müssen, damit das Kontodue active
bleibt. Es stellt die früheste Frist für alle vom Konto angeforderten Funktionen und Risikoanforderungen dar, einschließlich aller versteckten Funktionen.pending_
: Requirements that might become required, depending on the results of verification or review. It’s an empty array unless an asynchronous verification is pending. Unsuccessful verification moves a requirement toverification eventually_
,due currently_
, ordue past_
. A requirement subject to both failed and pending verifications can also remain indue pending_
.verification
Das folgende Beispiel zeigt, wie der Hash requirements
bei einem Konto mit Informationen vom Typ currently_
, mit Informationen vom Typ eventually_
und mit Informationen, die bei der Verifizierung errors
auslösen, aussehen könnte.
{ "id":
, "object": "account", "requirements": { "disabled_reason": null, "current_deadline": 1529085600, "past_due": [], "currently_due": [ "company.tax_id", "company.verification.document", "tos_acceptance.date", "tos_acceptance.ip" ], "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" ], "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" }, ] }, ... }"{{CONNECTED_ACCOUNT_ID}}"
Wenn requirements.
Einträge enthält, müssen Sie requirements.
überprüfen. Bei der current_
handelt es sich um einen Unix-Zeitstempel, der angibt, wann die Informationen benötigt werden. Wenn Stripe die Informationen bis zur current_
nicht erhält, werden Auszahlungen für dieses Konto deaktiviert. In einigen Fällen kann dies jedoch auch andere Konsequenzen geben. 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 einen Wert haben. Der Wert ist eine Zeichenfolge, die den Grund beschreibt, warum dieses Konto keine Auszahlungen oder Abbuchungen vornehmen kann. In einigen Fällen können Plattformen und verbundene Konten ein Formular einreichen, um den Grund zu klären oder gegen den Grund Einspruch zu erheben.
- Verbundene Konten mit Zugriff auf das gesamte Stripe-Dashboard und Standard-Konten können im Dashboard auf zusätzliche Informationen (sofern verfügbar) zugreifen.
- Plattformen in jeder Connect-Konfiguration können zu Zu überprüfende Konten navigieren, um den
disabled_
eines Kontos zu verstehen. Anschließend können Sie im Namen Ihrer verbundenen Konten zusätzliche Informationen bereitstellen. Wenn der Grund für die Deaktivierung mit einem Einspruch zusammenhängt, können Sie einen Link zu einem Formular für das Konto erstellen, um den Einspruch zu klären.reason
Grund | Bedeutung |
---|---|
action_ | Sie müssen Funktionen für das verbundene Konto anfordern. Weitere Informationen finden Sie unter Funktionen anfordern und aufheben. |
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. | Das Konto wurde wegen Verdachts auf Betrug oder illegale Aktivitäten abgelehnt. |
rejected. | Das Konto wird aufgrund unvollständiger Verifizierungsanforderungen innerhalb des erforderlichen Schwellenwerts abgelehnt. |
rejected. | Das Konto wurde abgelehnt, weil es sich auf einer externen Liste gesperrter Personen oder Unternehmen befindet (z. B. Finanzdienstleister oder Regierung). |
rejected. | Das Konto wurde aus einem anderen Grund abgelehnt. |
rejected. | Das Konto wurde wegen Verdachts auf Verletzungen des Rahmenvertrags abgelehnt. |
requirements. | Es sind zusätzliche Verifizierungsinformationen erforderlich, um Funktionen für dieses Konto zu aktivieren. |
requirements. | Stripe 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_ | Das Konto wird durch Stripe geprüft. |
Validierungs- und Verifizierungsfehler
Das Account-Objekt enthält das Array requirements.errors. Aus diesem geht hervor, warum die Validierungs- bzw. Verifizierungsanforderungen, die für die Aktivierung Ihres Kontos und Ihrer Funktionen gelten, nicht erfüllt wurden. Das Array errors
verfügt über die folgenden Attribute:
requirement
: Gibt an, welche Informationen vom Arraycurrently_
erforderlich sind.due code
: Gibt den Typ des Fehlers an, der aufgetreten ist. Die möglichen Fehlercodes finden Sie in der API-Dokumentation.reason
: Erläutert, warum der Fehler aufgetreten ist und wie er behoben werden kann.
Das folgende Beispiel zeigt, wie das Array errors
für ein Konto aussehen könnte, das über Anforderungen vom Typ currently_
verfügt. Es zeigt den Grund, aus dem die übermittelten Informationen nicht für die Aktivierung des Kontos verwendet werden können, und wie sich der Fehler beheben lässt. Wenn die Verifizierung oder Validierung fehlschlägt, können in currently_
erneut Anforderungen mit Fehlerinformationen erscheinen. Legen Sie einen Connect-Webhook fest, um das Ereignis account.
zu empfangen und diese Aktualisierungen zu erhalten.
{ "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.", } ] }, ... }"{{CONNECTED_ACCOUNT_ID}}"
Wenn die Verifizierung oder Validierung fehlschlägt, aber aktuell keine Anforderungen fällig sind, wird ein Webhook ausgelöst, der darauf hinweist, dass die erforderlichen Informationen später fällig werden.
Geschäftsinformationen
Wenn Informationen zu einem Unternehmen übermittelt werden, verifiziert Stripe die neuen Informationen. Stripe kann beispielsweise überprüfen, ob die angegebene Unternehmens-URL gültig und erreichbar ist und Informationen über das Unternehmen enthält. Um den Status der Verifizierungsinformationen eines Unternehmens abzurufen, verwenden Sie die requirements
des Account-Objekts.
Im Folgenden finden Sie eine Liste von Fehlern, die sich auf die Informationsverifizierung von Unternehmen beziehen:
Fehler | Lösung |
---|---|
invalid_ | Unternehmensnamen müssen für Menschen leicht verständlich sein und aus erkennbaren Wörtern bestehen. |
invalid_ | Allgemeine oder bekannte Firmennamen werden nicht unterstützt. Achten Sie darauf, dass der angegebene Firmenname mit dem Unternehmen des Kontos übereinstimmt. |
invalid_ | Eine Produktbeschreibung muss mindestens 10 Zeichen lang sein. |
invalid_ | Eine Produktbeschreibung muss sich von der URL des Unternehmens unterscheiden. |
| Weitere Informationen finden Sie unten im Abschnitt Umgang mit Fehlern bei der URL-Verifizierung. |
Zahlungsbeschreibungen in der Abrechnung
Stripe validiert die Zahlungsbeschreibung in der Abrechnung und das Präfix für die Zahlungsbeschreibung in der Abrechnung, wenn diese für ein Konto festgelegt werden. So kann Stripe beispielsweise verifizieren, dass die angegebene Zahlungsbeschreibung in der Abrechnung mit der Beschreibung des Unternehmens übereinstimmt. Bei der Überprüfung der Übereinstimmung der Zahlungsbeschreibung mit der Unternehmensbezeichnung verwendet Stripe die ersten 22 Zeichen der Zahlungsbeschreibung, die den Teil darstellen, der den Kartennetzwerken zur Verfügung gestellt wird. Eine Unternehmensbeschreibung stimmt weitgehend mit dem business_
, business_
oder dem Namen des Unternehmens oder der Einzelperson überein.
Um den Status von Verifizierungsinformationen bezüglich der Zahlungsbeschreibungen in der Abrechnung abzurufen, überprüfen Sie die requirements
für das Account-Objekt. Nachfolgend finden Sie eine Liste von Fehlern im Zusammenhang mit der Überprüfung der Zahlungsbeschreibung in der Abrechnung:
Fehler | Lösung |
---|---|
invalid_ | Eine Zahlungsbeschreibung in der Abrechnung muss mindestens 5 Zeichen lang sein. |
invalid_ | Eine Zahlungsbeschreibung in der Abrechnung muss dem Unternehmensnamen, dem Namen der juristischen Person oder der URL Ihres Unternehmens ähneln. |
| Allgemeine oder bekannte Zahlungsbeschreibungen in der Abrechnung werden nicht unterstützt. |
invalid_ | Das Präfix der Zahlungsbeschreibung in der Abrechnung muss Ihrer Zahlungsbeschreibung, Ihrem Unternehmensnamen, dem Namen Ihrer juristischen Person oder Ihrer URL ähneln. |
Informationen zu Personen
Während der Verifizierung müssen Informationen zu den Personen erfasst werden, die einem Konto zugeordnet sind. Wenn Sie:
- Nur Unternehmen onboarden, verwenden Sie die Persons API, um diese Informationen zu erfassen.
- Nur Einzelpersonen onboarden, können Sie die Persons API oder den Hash individual für das Account-Objekt verwenden.
- Sowohl Einzelpersonen als auch Unternehmen onboarden, verwenden Sie die Persons API, um diese Informationen zu erfassen. So erfassen Sie Informationen auf dieselbe Weise, unabhängig vom Unternehmenstyp.
Um den Status der Verifizierungsinformationen bezüglich einer Person abzurufen, verwenden Sie den Hash Anforderungen
Im Folgenden finden Sie eine Liste von Fehlern, die sich auf die Personenprüfung beziehen:
Fehler | Lösung |
---|---|
invalid_ | Stripe konnte die Kombination aus Stadt, Bundesland und Postleitzahl in der angegebenen Adresse nicht validieren. |
invalid_ | 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_ | 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_ | Die Person muss mindestens 13 Jahre alt sein. |
invalid_ | Das Geburtsdatum der Person muss innerhalb der letzten 120 Jahre liegen. |
invalid_ | Stripe konnte die Telefonnummer für das Konto nicht validieren. Stellen Sie sicher, dass die Formatierung dem Land der Person entspricht. |
invalid_ | Stripe konnte den Straßennamen und/oder die Hausnummer für die angegebene Adresse nicht validieren. |
| Steueridentifikationsnummern müssen eindeutig sein und aus neun Zahlen bestehen. Bindestriche oder andere Sonderzeichen sind nicht zulässig. |
Akzeptierte Verifizierungsdokumente nach Land
Weitere Informationen zu den spezifischen Dokumentanforderungen finden Sie unter Akzeptierte Verifizierungsdokumente nach Land.
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 Verifizierungsinformationen bezüglich des Unternehmens eines Kontos abzurufen, verwenden Sie den Subhash company.verification des Kontos:
{ "id":
, "object": "account", ... "company": { "verification": { "document": null }, ... }, ... }"{{CONNECTED_ACCOUNT_ID}}"
Sie können die Definition für jedes Verifizierungsattribut im Konto-Objekt nachschlagen.
Handhabung von Problemen mit Verifizierungsdokumenten
Viele Komplikationen beim Verifizierungsvorgang sind auf das hochgeladene Dokument selbst zurückzuführen. In der folgenden Tabelle finden Sie mögliche Werte für den Fehler code
(im Array requirements.
) sowie die geeignete Lösung zu jedem Fehler. Damit können Sie die häufigsten Probleme besser erkennen und handhaben.
Im Folgenden finden Sie eine Liste von Fehlern, die sich auf das Hochladen von Dokumenten beziehen:
Fehler | Lösung |
---|---|
| Das Hochladen ist fehlgeschlagen, weil es ein Problem mit der Datei gab. Lassen Sie den/die Nutzer/in eine neue Datei hochladen, die folgende Anforderungen erfüllt:
|
| Bei der bereitgestellten Datei handelt es sich nicht um einen zulässigen Lichtbildausweis eines unterstützten Landes oder ein erwartetes rechtlich gültiges Dokument. Lassen Sie den Nutzer/die Nutzerin eine neue Datei hochladen, die diese Anforderung erfüllt. Eine entsprechende Liste finden Sie unter Zulässige Ausweistypen nach Land. |
| Ihr Team kann sich an Stripe wenden, um mehr darüber zu erfahren, warum die Identitätsprüfung fehlgeschlagen ist. |
| 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. |
Im Folgenden finden Sie eine Liste von Fehlern, die sich auf die Identitätsprüfung beziehen:
Fehler | Lösung |
---|---|
verification_ | Der Name für das Konto konnte nicht verifiziert werden. Lassen Sie den/die Nutzer/in überprüfen, ob der vollständige rechtsgültige Name angegeben wurde, und einen Lichtbildausweis mit diesem Namen vorlegen. |
| Die Informationen auf dem Ausweisdokument stimmen nicht mit den von dem/der Nutzer/in bereitgestellten Informationen überein. Lassen Sie den/die Nutzer/in die für das Konto bereitgestellten Informationen überprüfen und korrigieren. |
| Das Dokument wurde möglicherweise geändert und konnte nicht verifiziert werden. Ihr Team kann sich an Stripe wenden, um mehr zu erfahren. |
Im Folgenden finden Sie eine Liste von Fehlern, die sich auf die Unternehmensverifizierung beziehen:
Fehler | Lösung |
---|---|
| Die Informationen für das Konto konnten nicht verifiziert werden. Der/die Nutzer/in kann entweder ein Dokument hochladen, um die Kontoinformationen zu bestätigen, oder die Informationen für das Konto aktualisieren. |
| Die von dem/der Nutzer/in bereitgestellten Informationen konnten bei der IRS nicht verifiziert werden. Lassen Sie den/die Nutzer/in mögliche Fehler im Unternehmensnamen oder in der Steueridentifikationsnummer korrigieren oder ein Dokument hochladen, das diese Felder enthält (nur USA). |
| Die Informationen im Dokument stimmen nicht mit den von dem/der Nutzer/in bereitgestellten Informationen überein. Lassen Sie den/die Nutzer/in die bereitgestellten Informationen zum Konto überprüfen und korrigieren oder ein Dokument hochladen, das mit dem Konto übereinstimmt. |
| In dem hochgeladenen Dokument fehlt ein erforderliches Feld. Lassen Sie den/die Nutzer/in ein anderes Dokument hochladen, in dem das fehlende Feld enthalten ist. |
Vorsicht
Übermitteln Sie keine Dateien erneut, die zuvor fehlgeschlagen sind. Doppelt hochgeladene Dateien lösen unmittelbar einen Fehler aus und werden nicht erneut überprüft.
Umgang mit URL-Verifizierungsfehlern
URLs für E-Commerce-Unternehmen müssen bestimmten Kartennetzstandards entsprechen. Um diese Standards zu erfüllen, führt Stripe bei der Überprüfung von URLs eine Reihe von Überprüfungen durch. Informationen zu Best Practices für URLs und allgemeinen Elementen für E-Commerce-Unternehmen finden Sie in der Website-Checkliste. Es gibt zwei Methoden, um URL-Verifizierungsfehler zu beheben:
- Verwendung der API: Bitte sehen Sie sich unten die Liste der Fehlercodes an, um das Problem, mit dem Sie konfrontiert sind, zu verstehen und zu beheben. Wenn Sie die URL aktualisieren müssen, verwenden Sie die Update Account API, die Stripe veranlasst, die neue URL zu überprüfen. Wenn Sie Änderungen an der Website unter der angegebenen URL vorgenommen haben, um einen Fehler zu beheben, aber keine Änderungen an der URL selbst vornehmen müssen, können Sie eine erneute Überprüfung auslösen, indem Sie die URL mithilfe der API in einen beliebigen anderen Wert ändern und sie dann wieder zurück ändern.
- Verwendung des Dashboards: Plattformen können die Seite Zu überprüfende Konten oder die Liste Aktionen erforderlich auf der Seite „Kontodetails“ im Stripe-Dashboard verwenden, um sich über die Auswirkungen auf ihre verbundenen Konten und die zu ergreifenden Maßnahmen zu informieren.
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.
Rufen Sie im Dashboard die Seite Zu überprüfende Konten auf oder überprüfen Sie die Liste Aktionen erforderlich (sofern vorhanden) auf der Seite „Kontodetails“, um den Fehler zu beheben. Wenn Sie das Problem nicht beheben können, bitten Sie Ihr verbundenes Konto, Kontakt mit dem Stripe-Support aufzunehmen. Anleitungen dazu, wie Sie Ihre Konten überprüfen, finden Sie unter Konten überprüfen, für die Maßnahmen erforderlich sind.
Notiz
Gemäß den Allgemeine Geschäftsbedingungen von Stripe müssen alle E-Commerce-Unternehmen in ihrer business_profile.url eine funktionierende URL ihrer Geschäftswebsite angeben, wenn sie ein Konto mit der Funktion card_
aktivieren. Ein 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. Wenn das Konto keine Website betreibt, um für sein Unternehmen zu werben, Produkte zu verkaufen oder Zahlungen anzunehmen, muss es stattdessen eine business_profile.product_description bereitstellen. Eine Produktbeschreibung muss die Art der verkauften Produkte sowie die Art und Weise, in der die Kundenkonten belastet werden (zum Beispiel persönliche Transaktionen), detailliert beschreiben. Weitere Informationen finden Sie unter: FAQ zur Notwendigkeit einer Unternehmenswebsite für die Kontoaktivierung.
Um Sie bei der Handhabung der häufigsten Fehler im Zusammenhang mit dem Feld business_
zu unterstützen, haben wir in der folgenden Tabelle die zugehörigen Fehlercodes (im Array requirements.
) sowie mögliche Lösungen aufgelistet.
Fehler | Lösung |
---|---|
invalid_ | Die angegebene URL stimmt mit einer allgemeinen Unternehmenswebsite überein, von der Stripe glaubt, dass sie nicht mit dem Konto zusammenhängt. Um das Problem zu beheben, geben Sie eine unternehmensspezifische URL an. |
invalid_ | Die angegebene URL hat das falsche Format. Um das Problem zu beheben, geben Sie eine korrekt formatierte URL an, zum Beispiel https://example. . |
invalid_ | 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_ | Die Informationen auf der Website unter der angegebenen URL stimmen nicht mit den Informationen für das Stripe-Konto überein. |
invalid_ | Auf der Website unter der angegebenen URL fehlt entweder der Firmenname oder eine klare Beschreibung der angebotenen Waren und Dienstleistungen. |
invalid_ | Wir können das Unternehmen des Kontos nicht über eine Website, ein Profil in den sozialen Medien oder eine mobile Anwendung unter der angegebenen URL überprüfen. |
invalid_ | Wir haben festgestellt, dass das Konto eine Website, ein Social-Media-Profil oder eine mobile Anwendung verwendet, um Produkte oder Dienstleistungen zu verkaufen oder zu bewerben. Es wurde jedoch keine URL angegeben. Um das Problem zu beheben, geben Sie eine URL an. |
invalid_ | Die Website enthält keine Angaben zum Kundenservice. |
invalid_ | Die Website enthält keine Rückgaberichtlinien und -verfahren. |
invalid_ | Die Website enthält keine Rückerstattungsrichtlinien. |
invalid_ | Die Website enthält keine Stornorichtlinie. |
invalid_ | Die Website enthält keine anwendbaren rechtlichen Hinweise für Produkte und Dienstleistungen, die gesetzlichen oder Exportbeschränkungen unterliegen. |
invalid_ | Die Website enthält keine Allgemeinen Geschäftsbedingungen. |
invalid_ | Wir können die Website unter der angegebenen URL nicht verifizieren, da sich die Website noch im Aufbau befindet. |
invalid_ | Wir sind nicht in der Lage, die Website unter der angegebenen URL zu verifizieren, da die Website passwortgeschützt ist. |
invalid_ | 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_ | Wir sind nicht in der Lage, die Website unter der angegebenen URL zu verifizieren, da die Website keinen Inhalt hat. |
Verarbeitung von Identitätsverifizierungen
Sie haben zwei Möglichkeiten, auf Änderungen der Identitätsprüfung zu reagieren. Die erste besteht darin, einen Aufruf zur Kontoaktualisierung auszuführen und Informationen zu korrigieren bzw. hinzuzufügen.
Bei der zweiten Variante werden wir Sie ggf. auffordern, ein Dokument hochzuladen. Je nachdem, wie viel Stripe von den Informationen des/der Nutzers/in verifizieren konnte, müssen unter Umständen drei verschiedene Dokumenttypen hochgeladen werden. Anhand der im Attribut requirements.
aufgelisteten Felder können Sie feststellen, welche Dokumente hochzuladen sind:
person.
: Erfordert einen Farbscan oder ein Foto eines zulässigen Ausweises.verification. document person.
: Erfordert einen Farbscan oder ein Foto eines Dokuments, aus dem die Adresse der Nutzerin/des Nutzers hervorgeht, zum Beispiel eine Nebenkostenabrechnung.verification. additional_ document company.
: Erfordert einen geschäftlichen Identitätsnachweis, aus dem die ID der juristischen Person hervorgeht, zum Beispiel eine Gründungsurkunde.verification. document
Das Hochladen von Dokumenten erfolgt in zwei Schritten:
- Datei bei Stripe hochladen
- Datei dem Konto zuordnen
Notiz
Aus Sicherheitsgründen nimmt Stripe keine Ausweiskopien an, die per E-Mail versendet werden.
Datei hochladen
Eine Datei können Sie mit der Create File API hochladen. Senden Sie hierfür in einer Anfrage vom Typ multipart/form-data-Anforderung die Daten der Datei.
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 purpose
auf identity_
fest:
Diese Anfrage lädt die Datei hoch und gibt ein Token zurück:
{ "id":
, "created": 1403047735, "size": 4908 }"{{FILE_ID}}"
Anschließend können Sie den Wert id
des Tokens verwenden, um die Datei zur Identitätsprüfung einem Konto zuzuordnen.
Datei anhängen
Nachdem Sie die Datei hochgeladen und ein repräsentatives Token erhalten haben, geben Sie die Datei-ID mithilfe des entsprechenden Felds in Ihrem Aufruf zur Kontoaktualisierung an.
Nachfolgend finden Sie ein Beispiel für ein Ausweisdokument:
Nachfolgend finden Sie ein Beispiel für ein Unternehmensdokument:
Durch diese Aktualisierung ändert sich verification.
in pending
. Wenn eine zusätzliche Person verifiziert werden muss, verwenden Sie die Persons API, um sie zu aktualisieren.
Ausweisverifizierung bestätigen
Wenn der Farbscan oder das Foto des Ausweises die Kontrollen von Stripe erfolgreich durchläuft, wird die Dokumentanforderung von requirements.
entfernt. Wenn alle Verifizierungsanforderungen für die Person oder das Unternehmen erfüllt sind, wird zum Abschluss des Verifizierungsvorgangs eine Webhook-Benachrichtigung vom Typ account.
ausgelöst.
Je nach Leserlichkeit des bereitgestellten Dokuments benötigt Stripe zwischen wenigen Minuten und einigen Geschäftstagen, um die Verifizierung abzuschließen.
Wenn der Verifizierungsversuch fehlschlägt, enthält das Array requirements.
einen Fehler mit dem Grund für das Fehlschlagen. Der Text in error[reason]
, z. B. „Das bereitgestellte Bild war nicht leserlich“, kann ohne Bedenken an die Nutzerin/den Nutzer weitergegeben werden, ist jedoch nicht lokalisiert. Zusätzlich enthält die Antwort den Wert error[code]
, z. B. verification_
, mit dem Sie Fehler für Ihre Nutzer/innen lokalisieren können. Bei einem Fehlschlagen gibt requirements.
an, dass ein neues Ausweisdokument hochgeladen werden muss. Wenn die Frist für die Verifizierung naht, wird requirements.
ggf. auch mit einem Datum belegt. Eine fehlgeschlagene Verifizierung löst ebenfalls eine Webhook-Benachrichtigung vom Typ account.
aus.
Umgang mit Risikoüberprüfungen
Neue Risikoanforderungen
Die folgenden risikobezogenen Anforderungsdaten werden am 12. November 2024 allgemein verfügbar sein. Wenn Sie möchten, können Sie diese bereits früher erhalten. Befolgen Sie bei Interesse die Anweisungen des Stripe-Supports.
Stripe meldet Risiko- und Compliance-Anforderungen im Attribut accounts.requirements. Diese Anforderungen folgen im Allgemeinen dem folgenden Schema: <id>.
:
id
kennzeichnet eindeutig die von Stripe oder unseren Finanzpartnern benötigten Informationen. Dieser Kennung wird immerinterv_
vorangestellt, um anzuzeigen, dass es sich um eine Anforderung zur Risikoprüfung handelt.requirement_
beschreibt speziell die Informationen, die erforderlich sind, um die Anforderung zu erfüllen, wie zum Beispieldescription identity_
,verification rejection_
usw.appeal - Der
resolution_
gibt an, wie Sie oder Ihr verbundenes Konto die angeforderten Informationen bereitstellen können:path challenge
: Verbundene Konten müssen auf abfragebasierte 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
: Verbundene Konten können Formularanfragen ausfüllen oder Sie können sie in ihrem Namen ausfüllen.support
: Die Anforderung ist nicht direkt umsetzbar. Kontaktieren Sie den Stripe-Support.
{ "id":
, "object": "account", "requirements": { "current_deadline": 1234567800, "currently_due": [ "{{REQUIREMENT_ID}}.restricted_or_prohibited_industry_diligence.form" ], "pending_verification": [], ... }, ... }"{{CONNECTED_ACCOUNT_ID}}"
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_
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":
, "object": "account", "requirements": { "current_deadline": 1234567800, "currently_due": [], "pending_verification": [ "{{REQUIREMENT_ID}}.restricted_or_prohibited_industry_diligence.support" ], ... }, ... }"{{CONNECTED_ACCOUNT_ID}}"
Je nach Art der Anforderung können Sie die Risiko- und Compliance-Anforderungen auf eine der folgenden Arten beheben:
- Eingebettete Connect-Komponenten: Sie können Connect-Komponenten direkt in Ihre Website einbetten. Wenn eine Anforderung erforderlich wird, leiten Sie Ihre Nutzer/innen zur eingebetteten Konto-Onboarding-Komponente weiter. Dort werden diese aufgefordert, ausstehende Anforderungen direkt in Ihrer Nutzeroberfläche abzuarbeiten. Verwenden Sie alternativ die eingebettete Komponente des Benachrichtigungsbanners, um Ihre Nutzer/innen über ausstehende Anforderungen zu informieren.
- Von Stripe gehostetes Onboarding: Sie können Links generieren, um Ihre verbundenen Konten programmgestützt über Konto-Links oder manuell in Ihrem Plattform-Dashboard zur Vervollständigung offener Anforderungen zu leiten.
- Im Auftrag Ihrer Konten vervollständigen: Sie können Ihr Plattform-Dashboard verwenden, um formularbasierte Risikoanforderungen aus Details verbundener Konten im Auftrag Ihrer Konten zu ermitteln und zu vervollständigen.
Die folgenden requirement_
-Werte sind für die im Attribut account.
angegebenen Anforderungen relevant.
Wert | Beschreibung |
---|---|
business_ | Wir benötigen zusätzliche Informationen über die Art des Unternehmens, um zu prüfen, ob wir das Konto unterstützen können. |
restricted_ | Das Unternehmen kann in einer eingeschränkten Kategorie tätig sein (zum Beispiel Verkauf von Alkohol, Versicherungen oder Finanzprodukte). 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_ | Das Unternehmen verkauft möglicherweise Produkte oder Dienstleistungen, die urheberrechtlich geschützt sind. Wir benötigen zusätzliche Informationen, um zu überprüfen, ob das Konto zum Verkauf dieser Produkte autorisiert ist. |
supportability_ | Die Allgemeinen Geschäftsbedingungen von Stripe untersagen die Unterstützung des Unternehmens. Das Konto kann diese Entscheidung anfechten. |
other_ | Wir benötigen zusätzliche Informationen, um zu prüfen, ob wir das Konto unterstützen können. |
credit_ | Wir benötigen zusätzliche Informationen über die Art des Unternehmens, um zu prüfen, ob wir das Konto unterstützen können. |
reserve_ | 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 unsere Entscheidung anfechten. |
identity_ | Die Person, die für das Konto verantwortlich ist, muss ihre Identität durch Hochladen eines Ausweisdokuments und eines Selfies verifizieren. |
url_ | Die URL des Unternehmens muss die vom Unternehmen angebotenen Produkte und Dienstleistungen widerspiegeln. Stripe kann verlangen, dass die URL geändert wird, bevor wir das Konto unterstützen können. |
address_ | Wir müssen die Adresse des Unternehmens durch Hochladen von Dokumenten verifizieren. |
domain_ | Wir müssen überprüfen, ob der/die Kontoinhaber/in die Kontrolle über die von ihm/ihr bereitgestellte URL oder Domain hat. |
bank_ | Wir müssen die mit dem Unternehmen verbundenen Bankkontodaten verifizieren. |
customer_ | Wir müssen die mit dem Unternehmen verbundenen Kontaktinformationen des Kundenservice verifizieren. |
fulfillment_ | Wir müssen die Fulfillment-Richtlinie des Unternehmens verifizieren. |
product_ | Das Stripe-Konto des Unternehmens muss eine genaue Produktbeschreibung enthalten. |
statement_ | Wir benötigen eine Zahlungsbeschreibung in der Abrechnung, die das Unternehmen gut beschreibt. |
capability_ | Die Allgemeinen Geschäftsbedingungen Stripe untersagen die Unterstützung bestimmter Funktionen, die mit diesem Unternehmen verbunden sind. Das Konto kann diese Entscheidung anfechten. |
rejection_ | Die Allgemeinen Geschäftsbedingungen von Stripe verbieten die Unterstützung dieses Unternehmens wegen dessen Risikolevels. Das Konto kann diese Entscheidung anfechten. |
platform_ | Die Plattform hat eine Intervention auf ihrem eigenen verbundenen Konto veranlasst. Dabei kann es sich um eine echte Intervention oder einen Test einer API-Integration handeln. |
other_ | Wir benötigen zusätzliche Compliance-Informationen, die zu keiner der anderen Beschreibungen passen. |
other_ | Wir benötigen zusätzliche Geschäftsinformationen, die zu keiner der anderen Beschreibungen passen. |