Verarbeitung von Verifizierungen mit der API

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.

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

1. 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 Typ person.updated Ausschau halten.
2. Ü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.
3. Achten Sie weiter auf Benachrichtigungen zu Ereignissen vom Typ account.updated, um zu sehen, ob sich der 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).

Ä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.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: 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 Liste currently_due. Wenn eine Anforderung erforderlich wird und ihr Fälligkeitsdatum vor der bestehenden current_deadline liegt, ändert sich die current_deadline in das Datum der Erzwingung des entsprechenden Schwellenwerts.
• currently_due: Anforderungen, die Sie bis zur current_deadline erfassen müssen, damit das Konto active bleibt. currently_due ist eine Untergruppe von eventually_due.
• past_due: Anforderungen, die Funktionen deaktiviert haben, weil sie nicht vor der current_deadline verifiziert wurden. past_dueist eine Untergruppe voncurrently_due`.
• errors: Details zu Validierungs- und Verifizierungsfehlern, für die bestimmte Anforderungen in currently_due oder past_due erneut erfasst werden müssen.
  • 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_reason: Beschreibt, warum das Konto nicht aktiviert ist und warum es keine Zahlungen oder Überweisungen verarbeiten kann.
• current_deadline: 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.
• pending_verification: Anforderungen, die je nach Ergebnis der Verifizierung oder Überprüfung erforderlich werden könnten. Es handelt sich um ein leeres Array, es sei denn, eine asynchrone Verifizierung steht aus. Eine nicht erfolgreiche Verifizierung verschiebt eine Anforderung auf eventually_due, currently_due oder past_due. Eine Anforderung, die sowohl fehlgeschlagenen als auch ausstehenden Verifizierungen unterliegt, 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": {
      "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"
          },
      ]
  },
  ...
}

Wenn requirements.currently_due Einträge enthält, müssen Sie requirements.current_deadline überprüfen. Bei der current_deadline handelt es sich um einen Unix-Zeitstempel, der angibt, wann die Informationen benötigt werden. Wenn Stripe die Informationen bis zur current_deadline 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 vollständige Stripe-Dashboard, einschließlich Standard-Konten, können im Dashboard auf zusätzliche Informationen (sofern verfügbar) zugreifen.
• Plattformen können auf der Seite Verbundene Konten nach einem Konto suchen, um die disabled_reason eines Kontos zu ermitteln. 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.

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 Array currently_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": 
"{{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, aber aktuell keine Anforderungen fällig sind, wird ein Webhook ausgelöst, der darauf hinweist, dass die erforderlichen Informationen später fällig werden.

Unternehmensinformationen

Wenn Informationen zu einem Unternehmen übermittelt werden, verifiziert Stripe die neuen Informationen. Beispielsweise kann Stripe ü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 zu überprüfen, rufen Sie den Hash requirements des Account ab.

Im Folgenden finden Sie eine Liste von Fehlern, die sich auf die Informationsverifizierung von Unternehmen beziehen:

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:

Unternehmensvertreter/innen

Sie müssen Informationen über die Personen erfassen und übermitteln, die mit einem verbundenen Konto verknüpft sind. Der Ablauf hängt davon ab, ob es sich bei Ihren verbundenen Konten um Unternehmen oder Einzelpersonen handelt:

• Nur Unternehmen: Verwenden Sie die Persons API, um Informationen zu einer Person hinzuzufügen, die mit dem Account verknüpft ist.
• Nur für Einzelpersonen: Sie können den API-Hash Persons oder individual für das Account-Objekt verwenden.
• Kombination aus Privatpersonen und Unternehmen: Verwenden Sie die Persons API, um Informationen zu einer mit dem Konto verknüpften Person hinzuzufügen. Dadurch können Sie dasselbe Verfahren für alle Ihre verbundenen Konten verwenden, unabhängig von deren Typ.

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:

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": 
"{{CONNECTED_ACCOUNT_ID}}",
  "object": "account",
  ...
  "company": {
    "verification": {
      "document": null
    },
    ...
  },
  ...
}

Sie können die Definition für jedes Verifizierungsattribut im Konto-Objekt nachschlagen.

Handhabung von Problemen mit Verifizierungsdokumenten

Probleme mit Identitätsnachweisen, entweder mit hochgeladenen Dateien selbst oder mit deren Verwendung zur Validierung anderer Informationen, verursachen viele Fehler bei der Anforderungsprüfung. In den folgenden Tabellen sind die code-Werte für Anforderungsfehler, die sich auf Dokumentprobleme beziehen, aufgeführt und bieten Anleitungen zu deren Behebung, damit Sie die häufigsten Probleme besser erkennen und handhaben können.

Die folgenden Fehler beziehen sich auf hochgeladene Dokumentdateien:

Die folgenden Fehler beziehen sich auf die Identitätsprüfung:

Die folgenden Fehler beziehen sich auf die Unternehmensverifizierung:

Die folgenden Fehler beziehen sich auf die Beziehungsüberprüfung:

Umgang mit URL-Verifizierungsfehlern

URLs für E-Commerce-Unternehmen müssen bestimmte Kartennetzwerkstandards einhalten. 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.

In vielen Fällen können Sie Verifizierungsfehler der Unternehmens-URL beheben, indem Sie einen Sanierungslink von Ihrem Plattform-Dashboard aus erstellen. Andernfalls aktualisieren Sie die business_profile.url des Account. Wenn Sie den Fehler auf andere Weise beheben, z. B. indem Sie ein Problem mit der Website des Unternehmens beheben, lösen Sie eine erneute Überprüfung aus, indem Sie die URL des Account in einen beliebigen anderen Wert ändern und ihn dann sofort wieder zurückä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, wenden Sie sich bitte an Ihr verbundenes Konto, Stripe Support zu kontaktieren.

Um Ihnen beim Erkennen und Behandeln der häufigsten Probleme zu helfen, enthält die folgende Tabelle Anforderungsfehler-code-Werte im Zusammenhang mit Problemen mit der Geschäfts-URL und Anleitungen zu deren Behebung.

Umgang mit Gültigkeitsanforderungen

Ein Konto kann eine oder mehrere Personen mit einer proof_of_liveness-Anforderung enthalten. Eine proof_of_livenessAnforderung kann die Erfassung eines elektronischen Ausweisdokuments, z. B. MyInfo in Singapur, oder die Verwendung von Stripe Identity zur Erfassung eines Dokuments oder Selfies erfordern. Wir empfehlen, das von Stripe gehostete oder eingebettete Onboarding zu verwenden, um alle Variationen der proof_of_liveness-Anforderung zu erfüllen.

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

Verarbeitung von Identitätsverifizierungen

In einigen Fällen, je nachdem, wie viel von den Identitätsinformationen eines Kontos Stripe verifizieren konnte, bitten wir Sie möglicherweise, ein oder mehrere Dokumente hochzuladen. Erforderliche Dokumente erscheinen im Hash requirements des Account.

Die folgenden Einträge in requirements.currently_due geben Dokumente an, die Sie hochladen müssen:

• 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 des/der Nutzers/in 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:

1. Datei bei Stripe hochladen
2. Datei dem Konto zuordnen

Datei hochladen

Eine Datei können Sie mit der Create File API hochladen. Senden Sie hierfür in einer multipart/form-data-Anfrage 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 Zweck entsprechend der Account- oder Person-Eigenschaft fest, die das Dokument enthält. Um den Zweck zu ermitteln, suchen Sie die Eigenschaft in der API-Dokumentation.

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 ein repräsentatives Token erhalten haben, aktualisieren Sie das Account oder die Person und geben Sie die Datei-ID im entsprechenden Parameter an.

Nachfolgend finden Sie ein Beispiel für ein Ausweisdokument:

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/persons/
{{PERSON_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "verification[document][front]"=
{{FILE_ID}}

Nachfolgend finden Sie ein Beispiel für ein Unternehmensdokument:

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 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, die die Ursache beschreiben. Die description enthält eine lesbare Meldung, wie z. B. „Das bereitgestellte Bild war nicht leserlich“, die sicher an Ihre/n Kontonutzer/in weitergegeben werden kann, jedoch nicht lokalisiert ist. Der Wert code ist eine Zeichenfolge wie verification_document_not_readable, die Sie verwenden können, um Fehlermeldungen für Ihre Kontonutzer/innen zu lokalisieren.

Eine fehlgeschlagene Verifizierung löst ebenfalls eine Webhook-Benachrichtigung vom Typ v2.core.account_person.updated oder v2.core.account[identity].updated aus.

Gehostete Dokumentensammlung mit Stripe Identity

Sie können Stripe Identity verwenden, um eine person.verification.document-Anforderung zu erfüllen, um ein Dokument zu erfassen und es direkt dem Konto zuzuordnen.

Erstellen Sie eine VerificationSession. Geben Sie den Parameter related_person an, um die erfassten Verifizierungsdaten der Person zuzuordnen, für die das document erforderlich ist, wie im folgenden Beispiel gezeigt.

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ückgegebenes client_secret, um den Nutzern/Nutzerinnen das Identity-Modal anzuzeigen oder sie an die url weiterzuleiten. Nach Abschluss der Verifizierung wird das Konto 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.

Umgang mit Risikoüberprüfungen

Stripe meldet Risiko- und Compliance-Anforderungen im Attribut accounts.requirements. Diese Anforderungen folgen im Allgemeinen dem folgenden Schema: <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.
• Der resolution_path gibt an, wie Sie oder Ihr verbundenes Konto die angeforderten Informationen bereitstellen können:
  • 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": 
"{{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:

• 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 folgende Tabelle enthält weitere Einzelheiten zu möglichen Beschreibungen von risikobezogenen und compliancebezogenen Anforderungen.