Alle Plattformen erhalten über Webhook-Ereignisse in der Accounts API einen konsistenten Einblick in die risikobezogenen Anforderungen für Ihre verbundenen Konten. Über die API können Sie alle Compliance- und risikobezogenen Anforderungen überwachen und programmgestützt verwalten, einschließlich Anfragen zu Nutzungsbedingungen und ausstehenden Kontoschließungen. Weitere Details finden Sie in der API-Dokumentation.
Was bedeutet diese Änderung für Sie?
Sie müssen sicherstellen, dass alle Benachrichtigungen, die Sie an Ihre Kundinnen und Kunden senden (E-Mail, Push), die durch account.updated-Webhook-Ereignisse für neue Risikoanforderungen ausgelöst werden, Ihr verbundenes Konto zur entsprechenden Stripe-Nutzeroberfläche oder Komponente weiterleiten. Sie können Compliance-Anforderungen weiterhin per API-Antwort regeln.
Nutzen Sie für neue Risikoanforderungen einen der folgenden Korrekturpfade:
In Connect eingebettete Komponenten: Betten Sie Connect-Komponenten direkt in Ihre Website ein. 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 zu informieren.
Von Stripe gehostetes Onboarding: Generieren Sie Links, um Ihre verbundenen Konten anzuweisen, ausstehende Anforderungen auf der von Stripe gehosteten Onboarding-Seite durchzuführen. Sie können Kontolinks programmgesteuert oder manuell über das Dashboard generieren, um Links zum gehosteten Onboarding zu erstellen.
Im Auftrag Ihrer Konten vervollständigen: Sie können das Dashboard verwenden, um formularbasierte Risikoanforderungen im Auftrag Ihrer Konten auf der Seite mit den Details des verbundenen Kontos zu ermitteln und zu erfüllen.
Wir empfehlen, dass Sie alle automatisierten Aktionen überprüfen, die durch den account.updated-Webhook ausgelöst werden, und gegebenenfalls Ihre Support-Teams vorbereiten, falls Ihre Nutzer/innen Fragen zu den Änderungen haben.
Wie kann ich neue API-Funktionen testen?
Wechseln Sie mit der Schaltfläche oben rechts in den Test-Modus des Dashboards.
Verwenden Sie ein bestehendes verbundenes Konto, indem Sie auf eine der Zeilen unten auf der Connect-Seite klicken, oder erstellen Sie ein neues verbundenes Konto, indem Sie oben rechts auf die Schaltfläche Erstellen klicken.
Im Dashboard Ihres verbundenen Kontos öffnen Sie dann das Überlaufmenü oben rechts und klicken auf Informationen anfordern.
Wenn Sie auf Informationen anfordern klicken, wird das folgende Modal geöffnet.
Wählen Sie eine Anforderungsoption aus dem Drop-down-Menü aus. Für Unbefugte IP – Physische Waren wird ein Formular benötigt, das die Anforderung nach Einreichung des Formulars auf pending_verification festlegt. Esc Charity erfüllt die Anforderung nach Einreichung des Formulars automatisch. Klicken Sie auf Hinzufügen, um das Modal zu schließen. Aktualisieren Sie anschließend die Seite, um die neue Anforderung anzuzeigen.
Interventionen über die API anzeigen
Bei der Verwendung der API zum Anzeigen von Interventionen werden die IDs der Anforderungen im Antwort-Objekt in past_due, currently_due oder eventually_due angegeben. Diese Angaben hängen von der current_deadline ab, die der Anforderung zugeordnet ist.
{
id: "acct_123",
...
requirements: {
"alternatives": [],
"current_deadline": 1709769600,
"currently_due": [
"interv_abc123.supportability.industry_diligence.form"
],
"disabled_reason": null,
"errors": [],
"eventually_due": [
"interv_abc123.supportability.industry_diligence.form"
],
"past_due": [],
"pending_verification": []
},
...
}
Auflösung von Interventionen im Test-Modus
Auf der Detailseite des Connect-Kontos für dieses Konto können Sie sehen, wie sich Interventionen im Laufe der Anforderungen auf das accounts-Objekt auswirken.
Klicken Sie unter Aktion erforderlich auf die neue Aufgabe, um die Seite mit den Aufgabendetails zu öffnen. Klicken Sie dann unter Aktualisieren auf Direkt an uns übermitteln, um das Formular im Namen des verbundenen Kontos auszufüllen. Der Status der Informationen wechselt dadurch in den Status „ausstehend“, und das accounts-Objekt wird entsprechend aktualisiert.
{
id: "acct_123",
...
requirements: {
"alternatives": [],
"current_deadline": 1709769600,
"currently_due": [],
"disabled_reason": null,
"errors": [],
"eventually_due": [],
"past_due": [],
"pending_verification": [
"interv_abc123.supportability.industry_diligence.support"
]
},
...
}
Diese Interventionen im Test-Modus werden automatisch innerhalb von 15 bis 25 Minuten aufgelöst. Zukünftige Anfragen an das accounts-Objekt sollten dies entsprechend anzeigen, siehe Beispielantwort unten.
{
id: "acct_123",
...
requirements: {
"alternatives": [],
"current_deadline": null,
"currently_due": [],
"disabled_reason": null,
"errors": [],
"eventually_due": [],
"past_due": [],
"pending_verification": []
},
...
}