Kontoverwaltung

„Kontoverwaltung“ zeigt eine Komponente der Nutzeroberfläche für verbundene Konten an, um deren Kontodetails anzuzeigen und zu verwalten. Verbundene Konten können Kontoinformationen wie persönliche oder geschäftliche Angaben, öffentliche Informationen und für Auszahlungen verwendete Bankkonten anzeigen und bearbeiten.

„Kontoverwaltung“ ist nicht darauf ausgelegt, fehlende Kontoinformationen zu erfassen, und übernimmt keine Risikoverifizierungen. Für diese Anwendungsfälle sollten Sie das Konto-Onboarding oder das Benachrichtigungsbanner verwenden .

Optionen für die Erfassung von Anforderungen

Wenn ein verbundenes Konto ausstehende Anforderungen hat, fordert die integrierte Kontoverwaltung das verbundene Konto auf, seine Informationen zu aktualisieren. Sie können die Erfassung der Anforderungen currently_due oder eventually_due steuern und entscheiden selbst, ob zukünftige Anforderungen mithilfe des collectionOptions-Attributs einbezogen werden soll.

Das Attribut „Kontoinformationen übermittelt“

Die Kontoverwaltungskomponente wird nur für Konten gerendert, bie denen das Attribut details_submitted true ist. Wenn ein Konto das Onboarding nicht durchlaufen hat, kann die Kontoverwaltungskomponente nicht gerendert werden. In diesen Szenarien empfehlen wir die Verwendung der Komponente Onboarding von Konten.

Angezeigte Felder

Die Felder, die die Kontoverwaltungskomponente anzeigt, hängen davon ab, wie Sie das verbundene Konto konfiguriert haben – insbesondere vom Land des verbundenen Kontos, vom Geschäftstyp, von den Funktionen und vom Servicevertragstyp. Dies funktioniert ähnlich wie bei der Onboarding-Komponente, die nur die Informationen erfasst, die für die Konfiguration des verbundenen Kontos erforderlich sind.

External account collection

Use the external_account_collection feature to control whether the component collects external account information. This parameter is enabled by default, and only platforms responsible for collecting updated information when requirements are due or change (including Custom accounts) can disable it. When external_account_collection is enabled, user authentication is required. You can opt out of Stripe user authentication with the disable_stripe_user_authentication parameter.

Disable Stripe user authentication

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.

We recommend implementing 2FA or equivalent security measures as a best practice. For account configurations that support this feature, such as Custom accounts, you assume liability for connected accounts if they can’t pay back negative balances.

Kontositzung erstellen

Aktivieren Sie beim Erstellen einer Kontositzung die Kontoverwaltung, indem Sie account_management im Parameter components angeben.

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

Kontoverwaltungskomponente rendern

// Include this element in your HTML
const accountManagement = stripeConnectInstance.create('account-management');
container.appendChild(accountManagement);

// Optional:
// accountManagement.setCollectionOptions({
//   fields: 'eventually_due',
//   futureRequirements: 'include',
// })