Eingebettetes Onboarding
Die Nutzeroberfläche des eingebetteten Onboardings hat nur wenig Stripe-Branding und kann perfekt an Ihre Marke angepasst werden. Ihre Plattform bettet die Komponente für Konto-Onboarding in Ihre Anwendung ein und Ihre verbundenen Konten interagieren mit der eingebetteten Komponente, ohne Ihre Anwendung verlassen zu müssen. Das eingebettete Onboarding verwendet die Accounts API, um Anforderungen zu ermitteln und ein Onboarding-Formular mit zuverlässiger Datenvalidierung zu generieren, das für alle von Stripe unterstützten Länder lokalisiert ist. Darüber hinaus übernimmt das eingebettete Onboarding Folgendes:
- Unternehmenstypen
- Konfigurationen der Unternehmensvertreter/innen
- Verifizierungsdokument wird hochgeladen
- Verifizierung und Status identifizieren
- Internationale Bankkonten
- Fehlerstatus
Konten erstellen und Informationen vorab angebenServerseitig
Erstellen Sie ein verbundenes Konto, indem Sie den Kontotyp angeben.
Wenn Sie das Land für Ihr verbundenes Konto kennen, können Sie diese Informationen bei der Kontoerstellung angeben. Wenn Sie keine Angaben machen, ist das Land standardmäßig das gleiche wie Ihre Plattform.
Wenn Sie Funktionen für Ihr verbundenes Konto anfordern müssen, können Sie diese bei der Kontoerstellung angeben, und die Onboarding-Nutzeroberflächen von Stripe erfassen die erforderlichen Informationen für diese Funktionen. Fordern Sie nur Funktionen an, die Sie benötigen, um den Onboarding-Aufwand zu reduzieren. Wenn Sie Funktionen auslassen und Ihr verbundenes Konto über Zugriff auf das Express-Dashboard verfügt, nutzt das von Stripe gehostete Onboarding die Konfigurationseinstellungen, um Funktionen automatisch je nach Land des Kontos anzufordern.
Wenn Sie über Informationen über den Kontoinhaber/die Kontoinhaberin verfügen (zum Beipiel der Name, die Adresse oder andere Details), können Sie diese beim Erstellen oder Aktualisieren des Kontos proaktiv bereitstellen. Beim von Stripe gehosteten Onboarding wird der Kontoinhaber/die Kotoinhaberin gebeten, die vorausgefüllten Informationen zu bestätigen, bevor er/sie den Connect-Rahmenvertrag akzeptiert. Durch die Angabe weiterer Informationen über die API wird die Anzahl der Eingabeaufforderungen reduziert und der Onboarding-Ablauf für Ihr verbundenes Konto verbessert.
Wenn Sie das Onboarding eines Kontos ohne seine eigene Website durchführen und Ihren Plattform dem Konto eine URL zur Verfügung stellt, füllen Sie außerdem die business_profile.url des Kontos vorab aus. Wenn das Konto keine URL hat, können Sie stattdessen seine business_profile.product_description vorab ausfüllen.
Verwenden Sie beim Testen Ihrer Integration Testdaten, um verschiedene Ergebnisse zu simulieren, zum Beispiel Identitätsprüfung, Verifizierung der Unternehmensinformationen, Auszahlungsfehler und mehr.
Die zu erfassenden Informationen bestimmen
Sie als Plattform müssen entscheiden, ob die erforderlichen Informationen von den verbundenen Konten vorab oder inkrementell erfasst werden sollen. Beim Onboarding im Voraus werden die eventually_due
Anforderungen für das Konto erfasst, während beim inkrementellen Onboarding nur die currently_due
Anforderungen erfasst werden.
Onboarding im Voraus | Inkrementelles Onboarding | |
---|---|---|
Vorteile |
|
|
Nachteile |
|
|
Um zu bestimmen, ob Sie das Onboarding im Voraus oder inkrementelles Onboarding nutzen möchten, lesen Sie die erforderlichen Informationen für die Länder, in denen sich Ihre verbundenen Konten befinden, um die Anforderungen zu verstehen, die letztendlich fällig werden. Auch wenn Stripe versucht, etwaige Auswirkungen auf verbundene Konten zu minimieren, können sich Anforderungen im Laufe der Zeit ändern.
Bei verbundenen Konten, bei denen Sie für die Anforderungserfassung verantwortlich sind, können Sie das Verhalten zukünftiger Anforderungen mithilfe des Attributs collectionOptions
bei der Integration der Konto-Onboarding-Komponente anpassen.
Richtlinien anpassen, die Ihren Nutzern/Nutzerinnen angezeigt werden
Connected accounts see Stripe’s service agreement and Privacy Policy during embedded onboarding. Connected account users who haven’t accepted Stripe’s services agreement must accept it on the final onboarding screen. Embedded onboarding also has a footer with links to Stripe’s service agreement and Privacy Policy.
For connected accounts where the platform is responsible for requirement collection, you have additional options to customize the onboarding flow, as outlined below.
Handle service agreement acceptance on your own
If you’re a platform onboarding connected accounts where you’re responsible for requirement collection, you can collect Terms of Service acceptance using your own process instead of using the embedded account onboarding component. If using your own process, the final onboarding screen only asks your connected accounts to confirm the information they entered, and you must secure their acceptance of Stripe’s service agreement.
Embedded onboarding still has links to the terms of service (for example, in the footer) that you can replace by linking to your own agreements and privacy policy.
Link to your agreements and privacy policy
Connected accounts see the Stripe service agreement and Privacy Policy throughout embedded onboarding. For the connected accounts where you’re responsible for requirement collection, you can replace the links with your own agreements and policy. Follow the instructions to incorporate the Stripe services agreement and link to the Stripe Privacy Policy.
Komponente für Konto-Onboarding integrierenServerseitigClientseitig
Erstellen Sie eine Kontositzung, indem Sie die ID des verbundenen Kontos und account_onboarding
als zu aktivierende Komponente angeben.
Create an Account Session
When creating an Account Session, enable account onboarding by specifying account_onboarding
in the components
parameter.
Nachdem die Kontositzung erstellt und ConnectJS initialisiert wurde, können Sie die Komponente für Konto-Onboarding im Frontend darstellen:
Umgang mit neuen Anforderungen, die fällig werdenServerseitig
Richten Sie Ihre Integration so ein, dass Änderungen der Kontoanforderungen überwacht werden. Sie können den Umgang mit neuen Anforderungen (und wie diese möglicherweise Zahlungen und Auszahlungen deaktivieren) mit den Testmodus-Auslöserkarten testen. Stripe benachrichtigt Sie, wenn bevorstehende Aktualisierungen der Anforderungen Ihre verbundenen Konten betreffen.
Sie können proaktiv Informationen sammeln, um zukünftige Anforderungen zu erfüllen. Ausgehend von den Verifizierungsanforderungen Ihrer Anwendung senden Sie das verbundene Konto je nach Bedarf zurück an das Onboarding, um die Anforderungen currently_due
oder eventually_due
zu erfüllen. Sie können dies als Signal dafür verwenden, wann Sie Ihr verbundenes Konto zurück in den Ablauf schicken müssen.
Sie müssen sich keine Gedanken über die Anforderungen machen – wenn Sie das verbundene Konto zum Onboarding zurücksenden, werden die richtigen Informationen erfasst. Wenn Ihr verbundenes Konto beispielsweise seine Daten falsch eingibt und nicht verifiziert werden kann, wird es möglicherweise gebeten, ein Identitätsdokument vorzulegen (zum Beispiel einen Führerschein in den USA). Wenn Sie diese/n Nutzer/in an das Onboarding senden, wird er/sie aufgefordert, zur Verifizierung ein solches Dokument hochzuladen.
Umgang mit Verifizierungsfehlern
Überwachen Sie das Ereignis account.updated. Wenn das Konto zum Zeitpunkt der current_deadline
Felder mit der Bezeichnung currently_due
enthält, wird die entsprechende Funktion deaktiviert und diese Felder werden zu past_due
hinzugefügt.
Lassen Sie Ihre Konten die Verifizierungsanforderungen regeln, indem Sie sie an die Komponente für Konto-Onboarding leiten.