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 bei einem verbundenen KontoAnforderungen ausstehen, fordert die eingebettete Kontoverwaltung das verbundene Konto auf, seine Informationen zu aktualisieren. Sie erfasst ständig currently_due-Anforderungen, und Sie können das Attribut collectionOptions-verwenden, um darüber hinaus jegliche der folgenden Optionen anzufordern:

• eventually_due-Anforderungen
• zukünftige Anforderungen
• Detaillierte Einschränkungen der Anforderung

Einschränkungen von Anforderungen

Beim Angeben von Inkasso-Optionen können Sie detaillierte Anforderungseinschränkungen nur oder ausschließend konfigurieren. Beide Optionen ermöglichen es, ein Array von Zeichenfolgen anzugeben, die entweder currently_due- oder eventually_due-Anforderungen für ein Konto darstellen. Details dazu, welche Anforderungen für Ihre verbundenen Konten gelten, finden Sie unter Erforderliche Verifizierungsinformationen.

Stellen Sie sich die Optionen als Filter vor, wobei ausschließen passende Konto Anforderungen herausfiltert undnur als Schnittmenge zwischen den Konto-Anforderungen und den angegebenen Werten fungiert. Sie unterstützen auch den Platzhalterabgleich mit * und Beziehungspräfixe.

Wenn Sie z. B. über ein verbundenes Konto mit mehreren Inhabern verfügen, können Sie die Adressinformationen für alle Inhaber/innen einziehen, indem Sie Folgendes angeben:nur: ["owners.address.*"].

Einer Person können mehrere Beziehungen zugeordnet sein, und Beziehungen können mehreren Personen zugewiesen werden. Wenn Sie Beziehungspräfixe nutzen, gelten sie daher für alle Personen auf dem Konto mit der angegebenen Beziehung. Dies ist besonders nützlich in Situationen, in denen Sie die ID einer bestimmten Person nicht kennen, dafür aber ihre Beziehung.

Wichtige Überlegungen:

• Konten müssen weiterhin alle KYC-Anforderungen erfüllen, um die Funktionen zu aktivieren. Die Option ausschließen entfernt keine Anforderung, sie verhindert nur die Erfassung zu diesem Zeitpunkt. Die Informationen müssen dennoch erfasst werden.
• Diese Einschränkungen gelten nur innerhalb eingebetteter Komponenten. Sie wirken sich nicht auf Konten aus, die andere Arten von Dashboards verwenden.
• Diese Funktion dient dazu, die Benutzerfreundlichkeit zu verbessern, und nicht, um zu verhindern, dass Konten auf Informationen zugreifen.

Die Anforderungseinschränkung „Nur“

Diese Option beschränkt die Erfassung auf den angegebenen Satz an Anforderungen, die auch für das Konto ausstehen. Sie wird am häufigsten verwendet, um eine Sanierung zu erstellen, und ist besonders nützlich für Anforderungen, die eine Form des Hochladens von Dokumenten oder der Identitätsüberprüfung erfordern.

Diese Option verhindert, dass beim Konto-Onboarding der Schritt der standardmäßigen abschließenden Zusammenfassung angezeigt wird. Wenn alle spezifizierten Anforderungen erfüllt sind, wird die Konto-Onboarding-Komponente sofort beendet.

Die Anforderungseinschränkung „Ausschließen“

Bei dieser Option werden die angegebenen Felder ausgeblendet, wodurch verhindert wird, dass ein verbundenes Konto diese Informationen bereitstellt oder bearbeitet. Es werden nur Felder aus der Komponente ausgeblendet. Die Informationsanforderungen werden nicht aufgehoben. Diese Option ist nützlich, wenn Sie Informationen vorab ausfüllen möchten, auf die das verbundene Konto während des Onboardings nicht zugreifen soll.

Bei Express-Konten gilt: Wenn Sie die Anforderung business_type ausschließen (z.B. um zu verhindern, dass ein Konto seinen Unternehmenstyp ändert), müssen das Land und die Funktionen des Kontos festgelegt werden.

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.

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.

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',
// })