Verarbeitung von Verifizierungen mit der API
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
Plattformen, die verbundene Custom-Konten nutzen, können außerdem die Identitätsprüfung für Custom-Konten beachten. Sie erfahren darin, welche Möglichkeiten in Bezug auf den Ablauf bestehen, wie die API-Felder bei Unternehmen und Einzelpersonen umgesetzt werden und wie Informationsanforderungen lokalisiert werden.
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)
Platforms need to choose the proper onboarding flow for their business and users to meet the KYC requirements. Broadly speaking, this means providing all the requisite information upfront or incrementally. Either way, set up your integration to watch for and respond to requests from Stripe.
- Richten Sie in Ihren Webhook-Einstellungen eine Connect Webhook-URL ein, um über bestimmte Aktivitäten, insbesondere Ereignisse vom Typ
account.updated
, benachrichtigt zu werden. Bei der Verwendung der Persons API sollten Sie außerdem nach Ereignissen vom Typperson.updated
Ausschau halten. - Immediately after creating an account, check the
Account
object’s requirements.currently_due attribute for any additional requirements. Obtain any required information from the user and update the connected account. - Achten Sie weiter auf Benachrichtigungen zu Ereignissen vom Typ
account.updated
, um zu sehen, ob sich derrequirements
-Hash ändert. Wenden Sie sich an Ihre Nutzerinnen und Nutzer, wenn Sie zusätzliche Informationen benötigen.
When you provide additional information, you don’t need to resubmit any previously verified details. For example, if the dob
is already verified, you don’t need to provide it again in subsequent updates.
Vorsicht
When requirements.currently_due
isn’t empty, additional information is required. Connected accounts might be blocked from creating charges, receiving payouts, or performing certain tasks if you don’t provide this information in a timely manner.
Ändern von Informationen nach der Verifizierung
After an individual or company is verified, you can change some of their information, with limitations. See the Update Account API for limitations based on the configuration of the connected account. Contact support to make changes outside of these limitations.
Ermitteln, ob eine Verifizierung erforderlich ist
Wenn Sie ein Webhook-Ereignis vom Typ account.updated
erhalten oder mit der API ein Konto abrufen, erhalten Sie ein Account-Objekt. Die Attribute charges_enabled
und payouts_enabled
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_due
: Felder, die Sie möglicherweise erfassen müssen, vorausgesetzt, alle Schwellenwerte wurden erreicht. Wenn sie erforderlich werden, erscheinen sie incurrently_due
und legen diecurrent_deadline
fest. Alle erforderlichen Informationen beginnen in diesem Array.currently_due
: Felder, die Sie bis zumcurrent_deadline
erfassen müssen, damit das verbundene Konto aktiviert bleibt.currently_due
ist eine Teilmenge voneventually_due
.past_due
: Felder, die Sie nicht fristgerecht eingereicht haben, wodurch das verbundene Konto deaktiviert wurde.past_due
ist eine Teilmenge voncurrently_due
.errors
: Die Liste der Gründe, warum ein bestimmtes Feld ineventually_due
,currently_due
oderpast_due
erneut erfasst werden muss, weil die Validierung oder Verifizierung fehlgeschlagen ist.disabled_reason
: Beschreibt, warum das verbundene Konto nicht aktiviert ist.current_deadline
: Datum, bis zu dem die Felder incurrently_due
erfasst werden müssen, damit das Konto aktiviert bleibt. Das Konto kann früher deaktiviert werden, wenn der nächste Schwellenwert erreicht wird, bevor diecurrently_due
-Felder erfasst werden.pending_verification
: Felder, die je nach Ergebnis der Verifizierung oder Überprüfung erforderlich werden können. Es handelt sich um ein leeres Array, es sei denn, eine asynchrone Verifizierung steht an. Wenn die Verifizierung fehlschlägt, werden diese Felder zueventually_due
,currently_due
oderpast_due
verschoben. Felder werden möglicherweise ineventually_due
,currently_due
oderpast_due
und inpending_verification
angezeigt, wenn die Verifizierung fehlschlägt, aber eine andere Verifizierung noch aussteht.
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":
, "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}}"
If requirements.currently_due
contains entries, check requirements.current_deadline
. The current_deadline
is a Unix timestamp identifying when information is needed. Usually, if Stripe doesn’t receive the information by the current_deadline
, payouts on the account are disabled. However, other consequences might apply in some situations. For example, if payouts are already disabled and the account is unresponsive to our inquiries, Stripe might also disable the ability to process charges.
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 Standard-Konten können über ihr 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_reason
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.
Grund | Bedeutung |
---|---|
action_required.requested_capabilities | Sie müssen Funktionen für das verbundene Konto anfordern. Weitere Informationen finden Sie unter Funktionen anfordern und Anforderungen rückgängig machen. |
listed | Account might be on a prohibited persons or companies list (Stripe investigates and either rejects or reinstates the account accordingly). |
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 gesperrter 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 des Rahmenvertrags 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, um die zu verifizierenden Informationen anzuzeigen. |
under_review | 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_due
erforderlich sind.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_due
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_due
erneut Anforderungen mit Fehlerinformationen erscheinen. Legen Sie einen Connect-Webhook fest, um das Ereignis account.updated
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
When information about a business is submitted, Stripe verifies the new information. For example, Stripe might verify that the provided business URL is valid, reachable, and includes information about the business. To retrieve the status of verification information regarding a business, utilize the requirements
on the Account object.
Im Folgenden finden Sie eine Liste von Fehlern, die sich auf die Informationsverifizierung von Unternehmen beziehen:
Fehler | Lösung |
---|---|
invalid_business_profile_name | Unternehmensnamen müssen für Menschen leicht verständlich sein und aus erkennbaren Wörtern bestehen. |
invalid_business_profile_name_denylisted | Allgemeine oder bekannte Firmennamen werden nicht unterstützt. Achten Sie darauf, dass der angegebene Firmenname mit dem Unternehmen des Kontos übereinstimmt. |
invalid_product_description_length | Eine Produktbeschreibung muss mindestens 10 Zeichen lang sein. |
invalid_product_description_url_match | 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_profile.name
, business_profile.url
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_statement_descriptor_length | Eine Zahlungsbeschreibung in der Abrechnung muss mindestens 5 Zeichen lang sein. |
invalid_statement_descriptor_business_mismatch | 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_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. |
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 Subhash verification des Person-Objekts:
{ "id":
, "object": "person", ... "verification": { "document": null } ... }"{{PERSON_ID}}"
Sie können die Definition für jedes Verifizierungsattribut im Person-Objekt nachschlagen. Zwei wichtige Attribute sind jedoch in jedem Fall status
und details
.
status
gibt den Verifizierungsstatus der Person an:
pending
: Stripe versucht gerade, diese Einheit zu verifizieren.unverified
: Stripe kann diese Einheit aktuell nicht verifizieren, entweder weil die Verifizierung fehlgeschlagen ist oder weil wir nicht über genügend Informationen für einen Verifizierungsversuch verfügen.verified
: Stripe hat diese Einheit erfolgreich verifiziert.
Beachten Sie, dass der Status unverified
nicht unbedingt ein dringendes Problem darstellt. Es bedeutet aber, dass Stripe bald weitere Informationen anfordern könnte.
Das Attribut details
enthält eine Erläuterung für den aktuellen status
.
Im Folgenden finden Sie eine Liste von Fehlern, die sich auf die Personenprüfung beziehen:
Fehler | Lösung |
---|---|
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 | The address of the person must be a valid physical address from which the account conducts business and can’t be a Highway Contract Box. |
invalid_address_private_mailbox | The address of the person must be a valid physical address from which the account conducts business and can’t be a private mailbox. |
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. |
| Steueridentifikationsnummern müssen eindeutig sein und aus neun Zahlen bestehen. Bindestriche oder andere Sonderzeichen sind nicht zulässig. |
Akzeptierte Verifizierungsdokumente nach Land
Nachfolgend sind Dokumente aufgeführt, die Stripe je nach Land als Nachweis für die Identitäts- und Adressprüfung sowie die Verifizierung juristischer Personen akzeptiert.
Je nach Dokumentationsart können Scans von Vorder- und Rückseite des Dokuments erforderlich sein. Nutzen Sie in diesem Fall für die Rückseite des Dokuments den Parameter document_back
. Wenn nicht ausdrücklich etwas anderes genannt wird, ist nur ein Scan der Vorderseite des Dokuments notwendig.
Stripe only accepts a passport to verify someone’s identity when a Stripe account and an individual associated with that Stripe account (for example, Business Representative, Owner) are from different countries. For example, if the business address is in the US, but the representative or owner of the business has a non-US address, then only their passport is accepted for verification of their identity. A passport scan is the only acceptable document in these cross-border situations.
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.errors
) 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:
|
| The provided file isn’t an acceptable form of ID from a supported country, or isn’t a type of legal entity document that is expected. Ask your user to provide a new file that meets that requirement. For a list, see Acceptable ID types by country. |
| Your team can contact Stripe to learn more about why identity verification failed. |
| 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_failed_keyed_identity | 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. |
| The document might have been altered so it couldn’t be verified. Your team can contact Stripe to learn more. |
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 bestimmte Kartennetzwerkstandards einhalten. Best Practices für URLs und gemeinsame Elemente für E-Commerce-Unternehmen finden Sie in der Website-Checkliste. Stripe führt eine Reihe von Überprüfungen der URL-Integrität durch. Es gibt zwei Methoden zum Beheben von URL-Integritätsfehlern:
- Verwendung der API – Verwenden Sie den Fehlercode, um das URL-Problem zu beheben. Wenn Sie die URL aktualisieren müssen, verwenden Sie die Update Account API, die Stripe auch dazu veranlasst, die aktualisierte URL zu überprüfen. Wenn Sie die URL nicht aktualisieren müssen, muss Stripe den Fehler trotzdem beheben, indem die URL erneut überprüft wird. Nachdem Sie weitere erforderliche Aktualisierungen vorgenommen haben, lösen Sie eine erneute Überprüfung aus, indem Sie die URL mithilfe der API in einen beliebigen anderen Wert ändern und ihn dann wieder zurückändern.
- Verwendung des Dashboards – Plattformen können die Seite Zu prüfende Konten im Stripe-Dashboard verwenden, um die Auswirkungen auf ihre verbundenen Konten zu verstehen und zu ermitteln, welche Maßnahmen zu ergreifen sind.
Nicht alle Probleme in Bezug auf URLs können mithilfe der API gelöst werden. Bestimmte Arten von URL-Integritätsfehlern erfordern zusätzliche Informationen zum Zugriff auf die Webseite 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. Besuchen Sie die Seite Zu prüfende Konten, um den Fehler zu beheben, oder verweisen Sie Ihr verbundenes Konto an den Stripe-Support.
Notiz
Stripe’s Terms of Service requires all e-commerce businesses to populate the business_profile.url property with a working URL of their business website when activating an account with the card_payments
capability. An account is considered an e-commerce business if it promotes or sells any products or services through an online website, social media profile, or mobile application. If the account doesn’t operate a website to promote their business, sell products, or accept payments, they’re required to provide business_profile.product_description instead. A product description needs to detail the type of products being sold as well as the manner in which the account’s customers are being charged (i.e. in person transactions).
Um Sie bei der Handhabung der häufigsten Fehler im Zusammenhang mit dem Feld business_profile.url
zu unterstützen, haben wir in der folgenden Tabelle die zugehörigen Fehlercodes (im Array requirements.errors
) sowie mögliche Lösungen aufgelistet.
Fehler | Lösung |
---|---|
invalid_url_denylisted | Die für das Konto angegebene URL entspricht einer allgemeinen URL einer Unternehmens-Website. Es muss eine URL angegeben werden, die spezifisch für das Unternehmen des Kontos ist. |
invalid_url_format | Die für das Konto angegebene URL hat das falsche Format. Es muss eine URL im korrekten Format angegeben werden, z. B. https://example.com . |
invalid_url_website_inaccessible | Wir können die Website unter der für das Konto angegebenen URL nicht erreichen. Um dieses Problem zu beheben, aktualisieren Sie das Konto mit einer erreichbaren URL. Wenn das Problem weiterhin besteht, rufen Sie in Ihrem Dashboard die Seite „Zu überprüfende Konten“ auf und antworten Sie auf die Intervention in der Liste Erforderliche Aktionen oder wenden Sie sich an den Stripe-Support. |
invalid_url_website_business_information_mismatch | Die Informationen auf der Website des Kontos stimmen nicht mit den Informationen auf dem Stripe-Konto des Kontos überein. Bitte sehen Sie sich die Seite „Zu prüfende Konten“ im Dashboard an. Andernfalls muss das Konto sicherstellen, dass die Informationen auf der Website mit dem Unternehmen des Kontos übereinstimmen. |
invalid_url_website_incomplete | Auf Ihrer Website fehlen offenbar einige erforderliche Informationen. Erfahren Sie, welche Informationen eine Website enthalten muss. |
invalid_url_website_other | Wir können das Unternehmen des Kontos nicht anhand der URL der bereitgestellten Website, des Social-Media-Profils oder der bereitgestellten mobilen Anwendung verifizieren. Es muss eine neue URL angegeben werden. Sehen Sie sich die Seite „Zu prüfende Konten“ an. Andernfalls muss das Konto den Stripe-Support kontaktieren, wenn keine URL vorhanden ist. |
invalid_url_web_presence_detected | We have detected that the account uses a website, social media profile, or mobile application to sell or promote products or services, but a URL hasn’t been provided for the account. The account should have a URL that isn’t a generic URL for the website or social media provider. |
invalid_url_website_incomplete_customer_service_details | Die Website des Kontos enthält keine Informationen zum Kundenservice, welche für den Unternehmenstyp des Kontos erforderlich sind. Bitte sehen Sie sich die Seite „Zu prüfende Konten“ im Dashboard an. Andernfalls muss das Konto auf seiner Website Informationen zum Kundenservice hinzufügen. |
invalid_url_website_incomplete_return_policy | Die Website des Kontos enthält keine Rückgaberichtlinie bzw. Rückgabeverfahren, die/das für den Unternehmenstyp des Kontos erforderlich ist. Bitte sehen Sie sich die Seite „Zu prüfende Konten“ im Dashboard an. Andernfalls muss das Konto auf seiner Website eine Rückgaberichtlinie bzw. ein Rückgabeverfahren hinzufügen. |
invalid_url_website_incomplete_refund_policy | Die Website des Kontos enthält keine Rückerstattungsrichtlinie, welche für den Unternehmenstyp des Kontos erforderlich ist. Bitte sehen Sie sich die Seite „Zu prüfende Konten“ im Dashboard an. Andernfalls muss das Konto auf seiner Website eine Rückerstattungsrichtlinie hinzufügen. |
invalid_url_website_incomplete_cancellation_policy | Die Website des Kontos enthält keine Stornorichtlinie, die für den Unternehmenstyp des Kontos erforderlich ist. Bitte sehen Sie sich die Seite „Zu prüfende Konten“ im Dashboard an. Andernfalls muss das Konto auf seiner Website eine Stornorichtlinie hinzufügen. |
invalid_url_website_incomplete_legal_restrictions | Die Website des Kontos suggeriert, dass es sich um den Verkauf von Waren handelt, für die entweder gesetzliche Beschränkungen oder Exportbeschränkungen gelten. Sehen Sie sich die Seite „Zu prüfende Konten“ an. Andernfalls muss das Konto diese Waren von seiner Website entfernen. |
invalid_url_website_incomplete_terms_and_conditions | Die Website des Kontos enthält keine allgemeinen Geschäftsbedingungen, welche für den Unternehmenstyp des Kontos erforderlich sind. Bitte sehen Sie sich die Seite „Zu prüfende Konten“ im Dashboard an. Andernfalls muss das Konto auf seiner Website allgemeine Geschäftsbedingungen hinzufügen. |
invalid_url_website_incomplete_under_construction | Die Website des Kontos befindet sich im Aufbau. Bitte sehen Sie sich die Seite „Zu prüfende Konten“ im Dashboard an. Alternativ muss das Konto den Aufbau der Website abschließen. |
invalid_url_website_inaccessible_password_protected | Die Website des Kontos ist passwortgeschützt. Bitte sehen Sie sich die Seite „Zu prüfende Konten“ im Dashboard an, um Anweisungen für den Zugriff auf die Website zu erhalten. Alternativ muss sich das Konto an den Stripe-Support wenden. |
invalid_url_website_inaccessible_geoblocked | Stripe konnte nicht auf die Website des Kontos zugreifen, da diese einem Geo-Blocking unterliegt. Bitte sehen Sie sich die Seite „Zu prüfende Konten“ im Dashboard an, um Anweisungen für den Zugriff auf die Website zu erhalten. Alternativ muss sich das Konto an den Stripe-Support wenden. |
invalid_url_website_empty | Die Website des Kontos ist ohne Inhalt. Bitte sehen Sie sich die Seite „Zu prüfende Konten“ im Dashboard an. Alternativ muss das Konto Inhalte hinzufügen, die seine Produkte und Dienstleistungen darstellen. |
Verarbeitung von Identitätsverifizierungen
You can respond in two ways to an identity verification change. The first is to perform an Update Account call, correcting or adding information.
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.currently_due
aufgelisteten Felder können Sie feststellen, welche Dokumente hochzuladen sind:
person.verification.document
: Erfordert einen Farbscan oder ein Foto eines zulässigen Ausweises.person.verification.additional_document
: Erfordert einen Farbscan oder ein Foto eines Dokuments, aus dem die Adresse der Nutzerin/des Nutzers hervorgeht, zum Beispiel eine Nebenkostenabrechnung.company.verification.document
: Erfordert einen geschäftlichen Identitätsnachweis, aus dem die ID der juristischen Person hervorgeht, zum Beispiel eine Gründungsurkunde.
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
- Identity documents are JPG or PNG format
- Address or legal entity documents are JPG, PNG, or PDF format
Übergeben Sie die Dateidaten im Parameter file
und legen Sie den Parameter purpose
auf identity_document
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
After you upload the file and receive a representative token, provide the file ID using the appropriate field in your Update Account call.
Nachfolgend finden Sie ein Beispiel für ein Ausweisdokument:
Nachfolgend finden Sie ein Beispiel für ein Unternehmensdokument:
Durch diese Aktualisierung ändert sich 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 der Farbscan oder das Foto des Ausweises die Kontrollen von Stripe erfolgreich durchläuft, wird die Dokumentanforderung von requirements.currently_due
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.updated
ausgelöst.
Je nach Leserlichkeit des bereitgestellten Dokuments benötigt Stripe zwischen wenigen Minuten und einigen Geschäftstagen, um die Verifizierung abzuschließen.
If the verification attempt fails, the requirements.errors
array contains an error stating the cause. The error[reason]
, such as “The image supplied isn’t readable,” is safe to present to your user, but isn’t localized. The response also contains an error[code]
value, such as verification_document_not_readable
, which you can use to localize errors for your users. Upon failure, requirements.currently_due
indicates that a new ID upload is required. If the deadline for verification is near, requirements.current_deadline
might also be populated with a date. Verification failure also triggers an account.updated
webhook notification.
Interested in receiving risk-related requirements?
Thank you! We'll be in touch soon.