Umgang mit Verifizierungsaktualisierungen

Optionen für den Onboarding-Ablauf

Wenn sich die Anforderungen ändern, aktualisieren wir die von Stripe gehosteten und eingebetteten Onboarding-Abläufe, um die Änderungen widerzuspiegeln. Wenn Sie jedoch einen benutzerdefinierten API-basierten Onboarding-Ablauf verwenden, müssen Sie diesen aktualisieren, um alle geänderten Anforderungen zu erfüllen.

Unabhängig von der Art des Onboarding-Ablaufs müssen Sie die Änderungen der Anforderungen für Ihre bestehenden verbundenen Konten berücksichtigen.

Wenn Sie eingebettete Komponenten oder von Stripe gehostetes Onboarding verwenden, ist es aufgrund von Anforderungsänderungen nicht notwendig, Ihren Onboarding-Ablauf zu aktualisieren. Fahren Sie mit dem Abschnitt zum Erfassen von aktualisierten Informationen.

Wenn Sie einen benutzerdefinierten API-basierten Onboarding-Ablauf verwenden, können Sie die aktualisierten Anforderungen handhaben, indem Sie diese Schritte befolgen oder Ihren Onboarding-Ablauf durch eingebettete Komponenten oder von Stripe gehostetes Onboarding ersetzen.

Ändern Sie Ihren API-basierten Onboarding-Ablauf

Vorschau der aktualisierten Verifizierungsanforderungen

Wenn sich die Verifizierungsanforderungen ändern, müssen Sie die aktualisierten Informationen bis zu einem bestimmten Datum erfassen. Andernfalls können verbundene Konten die von Ihnen angeforderten Funktionen nicht verwenden (zum Beispiel card_payments). Siehe Details zu den Informationen, die Sie erfassen müssen, basierend auf der Region eines Kontos, den angeforderten Funktionen und anderen Faktoren.

Sie können Unterbrechungen der Funktionen Ihrer verbundenen Konten vermeiden, indem Sie die Erfassung aktualisierter Informationen vor der current_deadline planen. Eine Vorschau der Informationen über bevorstehende Änderungen der Anforderungen finden Sie im future_requirements hash des Account-Objekts.

{
  "id": 
"{{CONNECTED_ACCOUNT_ID}}",
  "object": "account",
  "future_requirements": {
    "current_deadline": 1656608400,
    "currently_due": [
      "company.tax_id"
    ],
    "disabled_reason": null,
    "errors": [],
    "eventually_due": [
      "company.tax_id"
    ],
    "past_due": [],
    "pending_verification": []
  },
  ...
}

Fügen Sie Pflichtfelder zu Ihrem Onboarding-Ablauf hinzu

Wenn Sie ermittelt haben, welche aktualisierten Informationen Sie erfassen müssen, fügen Sie die entsprechenden Felder zu Ihrem Onboarding-Ablauf hinzu und aktualisieren Sie Ihre verbundenen Konten mithilfe der Accounts API.

Um Unterbrechungen für Ihre verbundenen Konten zu vermeiden, lassen Sie Ihren Onboarding-Ablauf alle Anforderungen erfüllen, die der Liste future_requirements.currently_due des Account-Objekts aufgeführt sind.

Sie können sich auch auf Anforderungen vorbereiten, die gelten, wenn ein Konto seine Schwellenwerte erreicht, indem Sie die future_requirements.eventually_due berücksichtigen.

Testen Sie Ihren aktualisierten Onboarding-Ablauf

Um zukünftige Verifizierungsanforderungen zu simulieren, erstellen Sie ein Testkonto mit der Accounts API mit enforce_future_requirements im E-Mail-Feld. Dadurch wird der Hash requirements des Kontos mit allen bekannten zukünftigen Verifizierungsanforderungen gefüllt.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "controller[stripe_dashboard][type]"=none \
  -d "controller[fees][payer]"=application \
  -d "controller[losses][payments]"=application \
  -d "controller[requirement_collection]"=application \
  -d country=US \
  -d business_type=individual \
  -d "capabilities[card_payments][requested]"=true \
  -d "capabilities[transfers][requested]"=true \
  --data-urlencode email="jenny.rosen+enforce_future_requirements@example.com"

Um zu überprüfen, ob Ihr aktualisierter Onboarding-Ablauf die Kontoanforderungen erfüllt, führen Sie das Onboarding des Testkontos durch und überprüfen Sie dessen requirements-Hash. Wenn Ihr Schema alle Anforderungen abdeckt, ist die Liste currently_due leer.

Überwachen Sie Änderungen des Kontostatus, um die Funktionalität zu aktivieren

Erkennen Sie Änderungen des Kontostatus, indem Sie das Ereignis account.updated überwachen. Nachdem ein Konto Ihren Onboarding-Ablauf durchlaufen hat, überprüfen Sie die Listen currently_due und pending_verification im requirements-Hash des Kontos. Wenn beide leer sind und requirements.disabled_reason null ist, können Sie die Funktionalität für das Konto aktivieren. Wenn payouts_enabled true ist, kann das Konto Auszahlungen empfangen. Wenn charges_enabled true ist, werden Zahlungen für das Konto freigegeben.

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

{
  "id": 
"{{CONNECTED_ACCOUNT_ID}}",
  "object": "account",
  "charges_enabled": true,
  "payouts_enabled": true,
  "requirements": {
    "alternatives": [],
    "current_deadline": null,
    "currently_due": [],
    "disabled_reason": null,
    "errors": [],
    "eventually_due": [],
    "past_due": [],
    "pending_verification": []
  },
  ...
}

Sie können aktualisierte Informationen von Ihren verbundenen Konten mithilfe von eingebetteten Komponenten, von Stripe gehostetem Onboarding oder der Stripe API erfassen. Wir empfehlen, entweder eingebettete Komponenten zu integrieren oder Ihre verbundenen Konten über Konto-Links an von Stripe gehostetes Onboarding weiterzuleiten.

Befolgen Sie in jedem Fall die folgenden Schritte:

Passen Sie Ihre Integration an, um neue Verifizierungsantworten zu verarbeiten

Wenn Stripe aktualisierte Informationen über Ihre verbundenen Konten erhält, dauert es einige Zeit, die entsprechenden Kontofelder zu verifizieren. Gehen Sie bis zum Abschluss der Verifizierung davon aus, dass alle zugehörigen Funktionen deaktiviert bleiben. Um Aktualisierungen der Feldverifizierung zu erkennen, überwachen Sie account.updated-Ereignisse und untersuchen Sie diese auf Verifizierungsfehler. Wenn Sie einen Fehler nicht vor Ablauf der Frist beheben, werden die angeforderten Funktionen für die betroffenen Konten deaktiviert.

Der requirements-Hash einer deaktivierten Funktion enthält einen disabled_reason, den Sie verwenden können, um die erforderliche Aktion zu bestimmen. Um Untersuchungen anzustellen oder erforderliche Informationen bereitzustellen, verwenden Sie die Registerkarte Zu überprüfende Konten in Ihrem Connect-Dashboard.

Konten mit ausstehenden Anforderungen identifizieren

Wählen Sie in Ihrem Connect-Dashboard Zu prüfende Konten aus. Dort sehen Sie eine Liste der verbundenen Konten mit aktuellen oder zukünftigen ausstehenden Anforderungen. Sie können die Liste nach Kontoproblem und -status filtern.

Sie können außerdem im Hash future_requirements des Account-Objekts oder mithilfe einer Sigma-Abfrage sehen, welche Informationen jedes verbundene Konto bereitstellen muss.

Vorbereitung auf die Durchsetzung aktualisierter Anforderungen

Am Implementierungsdatum für ein Konto (future_requirements.current_deadline) wird der Inhalt des Hash future_requirements in den Hash requirements verschoben und Stripe generiert ein account.updated-Ereignis. Da diese erzwungene Implementierung dazu führen kann, dass mehr Konten überprüft werden müssen, ist dieses Datum ein gute Erinnerung daran, die Registerkarte Zu prüfenden Konten in Ihrem Connect-Dashboard zu überprüfen.

Verbundene Konten zur Informationserfassung weiterleiten

Wenn für ein Konto currently_due-Anforderungen oder Verifizierungsfehler vorliegen, müssen Sie diese bis spätestens current_deadline beheben. An diesem Stichtag werden die Anforderungen aus dem Array requirements.currently_due zu requirements.past_due hinzugefügt und alle zugehörigen Funktionen werden deaktiviert, bis Sie die Informationen bereitstellen und die Fehler beheben.

Zukünftige Anforderungen können sich sofort auf die Funktionen eines Kontos auswirken, wenn sie zu aktuellen Anforderungen werden. Stellen Sie sicher, dass Sie alle Anforderungen vor Ablauf ihrer Fristen erfüllen, auch wenn sie sich noch in future_requirements befinden.

Wenn Ihre Konten requirements haben, die currently_due sind, weisen Sie Ihre Konten an, die Probleme gemäß Ihrem Onboarding-Ablauf oder mit Sanierungslinks zu beheben:

• API-basiertes Onboarding: Verwenden Sie Ihren benutzerdefinierten Onboarding-Ablauf. Optional können Sie auch future_requirements erfassen.
• Eingebettetes Onboarding: Rendern Sie die eingebettete Onboarding-Komponente für betroffene Konten.
• Von Stripe gehostetes Onboarding: Verwenden Sie die Account Links API, um einen einmaligen Link zum von Stripe gehosteten Onboarding zu generieren. Senden Sie Ihre verbundenen Konten von Ihrer Anwendung an diesen Link.
• Sanierungslinks: Verwenden Sie das Dashboard, um Sanierungslinks zu generieren, mit denen Ihre verbundenen Konten die erforderlichen Informationen bereitstellen können.