Eingebettetes Onboarding

Erstellen Sie ein verbundenes Konto mit den standardmäßigen Controllereigenschaften. Weitere Informationen zu Controllereigenschaften finden Sie unter Konzipieren einer Integration. Alternativ können Sie ein verbundenes Konto durch Angabe eines Kontotyps erstellen.

Wenn Sie das Land des Kontos angeben oder Funktionen dafür anfordern, kann der/die Kontoinhaber/in das Land nicht ändern. Andernfalls hängt es vom Dashboard-Zugriff des Kontos ab:

• Vollständiges Stripe-Dashboard: Während der Registrierung kann der/die Kontoinhaber/in ein beliebiges Akquisitionsland auswählen, genau wie bei der Anmeldung für ein normales Stripe-Konto. Stripe fordert je nach ausgewähltem Land automatisch eine Reihe von Funktionen für das Konto an.
• Express-Dashboard: Beim Onboarding kann der/die Kontoinhaber/in aus einer Liste von Ländern wählen, die Sie in den Onboarding-Optionen Ihres Plattform-Dashboards konfigurieren. Sie können diese Optionen auch konfigurieren, um die Standardfunktionen anzugeben, die für Konten in jedem Land angefordert werden sollen.
• Kein Stripe-Dashboard: Wenn Stripe für die Erfassung der Anforderungen verantwortlich ist, kann der Kontoinhaber im Onboarding-Prozess ein beliebiges Akquisitionsland auswählen. Andernfalls müssen in Ihrem nutzerdefinierten Onboarding-Ablauf das Land festgelegt und Funktionen angefordert werden.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "controller[fees][payer]"=application \
  -d "controller[losses][payments]"=application \
  -d "controller[stripe_dashboard][type]"=express

Die Antwort enthält die ID, die Sie verwenden, um in Ihrer gesamten Integration auf das Account zu verweisen.

Funktionen anfordern

Sie können Funktionen beim Erstellen eines Kontos anfordern, indem Sie die Eigenschaft requested der gewünschten Funktionen auf „true“ festlegen. Bei Konten mit Zugriff auf das Express-Dashboard können Sie Ihre Onboarding-Optionen auch so konfigurieren, dass bestimmte Funktionen beim Erstellen eines Kontos automatisch angefordert werden.

Die Onboarding-Nutzeroberflächen von Stripe erfassen automatisch die Anforderungen für angeforderte Funktionen. Fordern Sie nur Funktionen an, die Sie benötigen, um den Onboarding-Aufwand zu reduzieren.

Informationen vorab angeben

Wenn Sie Informationen über den/die Kontoinhaber/in haben (wie Name, Adresse oder andere Details), können Sie das Onboarding vereinfachen, indem Sie diese bei der Erstellung oder Aktualisierung des Kontos angeben. Die Onboarding-Schnittstelle fordert den/die Kontoinhaber/in auf, die vorausgefüllten Informationen zu bestätigen, bevor er/sie den Connect-Rahmenvertrag akzeptiert. Der/die Kontoinhaber/in kann alle vorausgefüllten Informationen bearbeiten, bevor er/sie den Rahmenvertrag akzeptiert, selbst wenn Sie die Informationen über die Accounts API bereitgestellt haben.

Wenn Sie das Onboarding eines Kontos durchlaufen haben und Ihre Plattform eine URL dafür bereitstellt, füllen Sie die business_profile.url des Kontos vorab aus. Wenn das Unternehmen 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.

Benutzerdefinierten Satz an Anforderungen erfassen

Sie können die eingebettete Komponente so konfigurieren, dass sie bestimmte Anforderungen erfasst, indem Sie die Optionen exclude und only verwenden. Auf diese Weise können Sie einen benutzerdefinierten Ablauf zum Erfassen bestimmter Anforderungen erstellen und die eingebettete Komponente für alle anderen Anforderungen verwenden. Zum Beispiel:

• Verwenden Sie exclude, um zu verhindern, dass verbundene Konten über die Komponente auf die angegebenen Anforderungen zugreifen können.
• Verwenden Sie only, um verbundene Konten darauf zu beschränken, nur auf die angegebenen Anforderungen über die Komponente zuzugreifen.

Einzelheiten zur Verwendung dieser Erfassungsoptionen finden Sie in der Dokumentation zur Konto-Onboarding-Komponente oder zur Konto-Verwaltungskomponente.

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.

Um zu bestimmen, ob Sie das Onboarding im Voraus oder inkrementelles Onboarding nutzen möchten, überprüfen Sie die Anforderungen für die Standorte und Funktionen Ihrer verbundenen Konten. 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 Parameters collection_options anpassen. Um die zukünftigen Anforderungen des Kontos zu erfassen, setzen Sie collection_options.future_requirements auf include.

Der Rahmenvertrag und die Datenschutzerklärung von Stripe werden verbundenen Konten im eingebetteten Onboarding angezeigt. Nutzer/innen verbundener Konten, die den Rahmenvertrag von Stripe nicht akzeptiert haben, müssen dies im letzten Bildschirm des Onboardings nachholen. Das eingebettete Onboarding verfügt außerdem über eine Fußzeile mit Links zum Rahmenvertrag und zur Datenschutzerklärung von Stripe.

Für verbundene Konten, bei denen die Plattform für die Erfassung der Anforderungen zuständig ist, haben Sie zusätzliche Optionen zur Anpassung des Onboarding-Ablaufs, die im Folgenden beschrieben werden.

Kümmern Sie sich selbst um die Zustimmung zum Rahmenvertrag

Wenn Sie eine Plattform sind, die das Onboarding von verbundenen Konten durchführt und dabei für die Erfassung der Anforderungen verantwortlich sind, können Sie die Zustimmung zu den Allgemeinen Geschäftsbedingungen über Ihre eigene Methode statt über die integrierte Konto-Onboarding-Komponente einholen. In diesem Fall werden Ihre verbundenen Konten im letzten Onboarding-Bildschirm nur aufgefordert, die von ihnen eingegebenen Informationen zu bestätigen, und Sie müssen ihre Zustimmung zum Rahmenvertrag von Stripe einholen.

Das eingebettete Onboarding enthält weiterhin Links zu den allgemeinen Geschäftsbedingungen (zum Beispiel in der Fußzeile), die Sie durch Verknüpfung mit Ihren eigenen Vereinbarungen und Ihrer Datenschutzerklärung ersetzen können.

Link zu Ihren Vereinbarungen und Ihrer Datenschutzerklärung

Verbundene Konten können den Stripe-Rahmenvertrag und die Datenschutzerklärung während des eingebetteten Onboardings einsehen. Für Ihre verbundenen Konten, bei denen Sie für die Erfassung der Anforderungen verantwortlich sind, können Sie diese Links durch Ihre eigenen Vereinbarungen und Richtlinien ersetzen. Befolgen Sie diese Anweisungen, um den Stripe-Rahmenvertrag aufzunehmen und stellen Sie einen Link zur Datenschutzerklärung von Stripe zur Verfügung.

Erstellen Sie eine Kontositzung, indem Sie die ID des verbundenen Kontos und account_onboarding als zu aktivierende Komponente angeben.

Kontositzung erstellen

Aktivieren Sie beim Erstellen einer Kontositzung das Konto-Onboarding, indem Sie account_onboarding im Parameter components angeben.

curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}" \
  -d "components[account_onboarding][enabled]"=true

Komponente für das Konto-Onboarding rendern

Nachdem die Kontositzung erstellt und ConnectJS initialisiert wurde, können Sie die Komponente für Konto-Onboarding im Frontend darstellen:

// Include this element in your HTML
const accountOnboarding = stripeConnectInstance.create('account-onboarding');
accountOnboarding.setOnExit(() => {
  console.log('User exited the onboarding flow');
});
container.appendChild(accountOnboarding);

// Optional: make sure to follow our policy instructions above
// accountOnboarding.setFullTermsOfServiceUrl('{{URL}}')
// accountOnboarding.setRecipientTermsOfServiceUrl('{{URL}}')
// accountOnboarding.setPrivacyPolicyUrl('{{URL}}')
// accountOnboarding.setCollectionOptions({
//   fields: 'eventually_due',
//   futureRequirements: 'include',
// })
// accountOnboarding.setOnStepChange((stepChange) => {
//   console.log(`User entered: ${stepChange.step}`);
// });

Siehe Konto Onboarding für Onboarding-Funktionen wie:

• Handler wie setOnStepChange für Analysen hinzufügen.
• Onboarding mit unseren iOS und Android SDKs in Ihre Mobile App einbetten.
• Konditionen und Datenschutz-URLs anpassen.
• Einzugsoptionen angeben.

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 Test-Auslöserkarten testen.

Senden Sie ein verbundenes Konto über das Onboarding zurück, wenn es currently_due- oder eventually_due-Anforderungen erfüllt. Sie müssen die spezifischen Anforderungen nicht identifizieren, da die Onboarding-Schnittstelle weiß, welche Informationen sie erfassen muss. Wenn beispielsweise ein Tippfehler die Verifizierung der Identität des Kontoinhabers/der Kontoinhaberin verhindert, fordert das Onboarding ihn/sie auf, ein Identitätsdokument hochzuladen.

Stripe benachrichtigt Sie über alle bevorstehenden Aktualisierungen der Anforderungen, die Ihre verbundenen Konten betreffen. Sie können diese Informationen proaktiv erfassen, indem Sie die zukünftigen Anforderungen für Ihre Konten überprüfen.

Erhalten Sie für verbundene Konten, bei denen controller.requirement_collection stripe ist, nach dem Erstellen einer Konto-Link oder einer Kontositzung keine Updates mehr für Identitätsinformationen.

Konten speichern Identitätsinformationen in den Hashes company und individual.

Verifizierungsfehler handhaben

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

Stripe-Nutzerauthentifizierung deaktivieren

Bei Verwendung des eingebetteten Onboarding ist die Nutzerauthentifizierung durch Stripe standardmäßig aktiviert. Dieses Verhalten können Sie mithilfe von disable_stripe_user_authentication aufheben.

Wir empfehlen den Einsatz der Zwei-Faktor-Authentifizierung oder gleichwertiger Sicherheitsmaßnahmen als Best Practice. Bei Kontokonfigurationen, die diese Funktion unterstützen, wie z. B. Custom, übernehmen Sie die Haftung für verbundene Konten, wenn diese Negativsalden nicht zurückzahlen können.