Onboarding von Konten

Optionen für die Erfassung von Anforderungen

Mit dem integrierten Onboarding können Sie nur die Erfassung der currently_due oder eventually_due-Anforderungen sowie die Einbeziehung zukünftiger Anforderungen steuern. Sie können dieses Verhalten anpassen, indem Sie das Attribut collectionOptions bei der Integration der Onboarding-Komponente für Konten verwenden. Weitere Informationen zu den Anforderungen für Ihren Kontotyp finden Sie unter Erforderliche Verifizierungsinformationen.

Erfassung externer Konten

Verwenden Sie die Funktion external_account_collection, um zu steuern, ob die Komponente externe Kontoinformationen erfasst. Dieser Parameter ist standardmäßig aktiviert und nur Plattformen, die für die Erfassung aktualisierter Informationen verantwortlich sind, wenn Anforderungen fällig sind oder sich ändern (einschließlich Custom-Konten), können ihn deaktivieren. Wenn external_account_collection aktiviert ist, ist eine Nutzerauthentifizierung erforderlich. Sie können die Stripe-Nutzerauthentifizierung mit dem Parameter disable_stripe_user_authentication deaktivieren.

Stripe-Nutzerauthentifizierung deaktivieren

Verwenden Sie die Funktion disable_stripe_user_authentication, um zu steuern, ob für die Komponente eine Nutzerauthentifizierung durch Stripe erforderlich ist. Der Standardwert ist das Gegenteil des Werts external_account_collection. Wenn Sie z. B. external_account_collection nicht festlegen, wird der Wert standardmäßig „true“ und disable_stripe_user_authentication standardmäßig „false“. Dieser Wert kann nur wahr sein für Konten, bei denen controller.requirement_collection gleich application ist.

Wir empfehlen die Implementierung von 2FA oder gleichwertigen Sicherheitsmaßnahmen als Best Practice. Bei Kontokonfigurationen, die diese Funktion unterstützen, wie z. B. Custom-Konten, übernehmen Sie die Haftung für verbundene Konten, wenn diese Negativsalden nicht zurückzahlen können.

Passen Sie die Ihren Nutzer/innen angezeigten Richtlinien an

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.

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

class MyViewController: UIViewController, AccountOnboardingControllerDelegate {
    override func viewDidLoad() {
        super.viewDidLoad()

        // Optional. If you use CollectionOptions, make sure to follow our policy instructions.
        // let collectionOptions = AccountCollectionOptions()
        // collectionOptions.fields = .eventuallyDue
        // collectionOptions.futureRequirements = .include

        let accountOnboardingController = embeddedComponentManager.createAccountOnboardingController(
            // fullTermsOfServiceUrl: URL(string: "{{URL}}")!,
            // recipientTermsOfServiceUrl: URL(string: "{{URL}}")!,
            // privacyPolicyUrl: URL(string: "{{URL}}")!,
            // skipTermsOfServiceCollection: false,
            // collectionOptions: collectionOptions
        )

        accountOnboardingController.delegate = self

        // Display the component in your app
        accountOnboardingController.present(from: self)
    }

    // MARK: - AccountOnboardingControllerDelegate

    func accountOnboardingDidExit(_ accountOnboarding: AccountOnboardingController) {
        print("User exited the onboarding flow")
    }
}