Konfigurieren Sie das Verhalten von verbundenen Konten

Erfahren Sie, wie Sie Ihre verbundenen Konten mit der Accounts v2 API konfigurieren.

Sie definieren die Interaktionen zwischen Ihrer Plattform, den verbundenen Konten und Stripe, beispielsweise Geldbewegungen und Verlusthaftung, indem Sie Ihre verbundenen Konten konfigurieren. Richten Sie Ihre Integration so ein, dass diese konfiguriert werden, indem Sie bei der Erstellung der entsprechenden Accounts v2-Objekte Werte für bestimmte Eigenschaften angeben. Eigenschaften im Hash defaults.responsibilities weisen beispielsweise die Haftung für negative Salden Ihrer verbundenen Konten zu und geben an, wie Stripe Zahlungsgebühren einzieht.

Die Werte, die Sie Ihren verbundenen Kontoeigenschaften zuweisen, wirken sich auch auf andere Aspekte Ihrer Integration aus. Beispiel: Die Verantwortung für die Verifizierung der Identitätsangaben wird Stripe oder Ihrer Plattform auf der Grundlage der Haftung für negative Salden und des Zugriffs verbundener Konten auf Stripe Dashboards zugewiesen.

Hinweis

Verantwortlichkeiten und die Eigenschaft dashboard in Accounts v2 entsprechen den Controller-Eigenschaften in Accounts v1. Dieses Dokument enthält eine Zuordnung der Controller-Eigenschaften zu den Accounts v2-Eigenschaften.

Verantwortlichkeiten festlegen

Sie müssen die Eigenschaften defaults.responsibilities definieren, wenn Sie die Händlerkonfiguration zu einem Konto hinzufügen. Sie können ihre Werte später nicht mehr aktualisieren.

Eigenschaft	Beschreibung	Werte
defaults.responsibilities.fees_collector	Definiert, wie Stripe Zahlungsgebühren für Direct Charges auf dem verbundenen Konto einzieht. (Für Destinations Charges oder separate Zahlungen zieht Stripe immer Gebühren von Ihrer Plattform ein.)	`application`: Ihre Plattform erhebt Pattformgebühren vom verbundenen Konto und Stripe erhebt Zahlungsgebühren von Ihrer Plattform. `stripe`: Stripe zieht Zahlungsgebühren direkt vom verbundenen Konto ein.
defaults.responsibilities.losses_collector	Weist die Verantwortung für negative Salden des verbundenen Kontos zu.	`application`: Ihre Plattform ist für negative Salden verantwortlich und verwaltet das Risiko für das verbundene Konto. `stripe`: Stripe haftet für die negativen Salden des verbundenen Kontos. Ihre Plattform haftet weiterhin für negative Salden auf Ihrem Plattformkonto.

Die Zuständigkeiten unterliegen den folgenden Einschränkungen:

Wenn Sie losses_collector auf application setzen, müssen Sie auch fees_collector auf application setzen.
Wenn Sie Destination Charges mit einem Konto verwenden, empfehlen wir Ihnen, sowohl losses_collector als auch fees_collector auf application zu setzen.

Weitere Informationen zu unterstützten Konfigurationen finden Sie unter Integrationsempfehlungen.

Zugriff auf das Dashboard einrichten

Sie müssen den Eigenschaftswert von dashboard festlegen (wenn sein vorhandener Wert Null ist), wenn Sie die Händler-Konfiguration zu einem Konto hinzufügen. Sie müssen auch den Wert von dashboard festlegen (wenn sein vorhandener Wert Null ist), wenn Sie die Funktion stripe_transfers für die Empfänger-Konfiguration für ein Konto anfordern. Wählen Sie aus den folgenden Werten:

express: Das verbundene Konto kann auf das Stripe Express-Dashboard zugreifen, das eingeschränkte Funktionen bietet. Sie können das Erscheinungsbild mit dem Branding Ihrer Plattform anpassen.
full: Das verbundene Konto kann auf das vollständige Stripe-Dashboard zugreifen. Im vollständigen Stripe-Dashboard können Ihre verbundenen Konten ihre Finanzen und Berichte anzeigen und verwalten.
none: Das verbundene Konto kann auf kein Stripe-Dashboard zugreifen. Ihre Plattform muss alle mit Stripe zusammenhängenden Funktionen bereitstellen.

Unabhängig von der Einstellung dashboard kann Ihre Plattform in Connect eingebettete Komponenten verwenden, um Ihren verbundenen Konten ähnliche Funktionen in einer nutzerdefinierten Oberfläche zur Verfügung zu stellen.

Für Dashboards gelten folgende Einschränkungen:

Wenn Sie dashboard auf express setzen, müssen Sie auch sowohl losses_collector als auch fees_collector auf application setzen.
Wenn Sie dashboard auf full setzen, müssen Sie auch sowohl losses_collector als auch fees_collector auf stripe setzen.

Weitere Informationen zu unterstützten Konfigurationen finden Sie unter Integrationsempfehlungen.

Erfassen Sie die Anforderungen für Know Your Customer (KYC)

Die Verantwortung für das Erfassen der KYC-Anforderungen basiert auf den Werten defaults.responsibilities.losses_collector und dashboard. In den meisten Konfigurationen ist Stripe für das Erfassen der KYC-Anforderungen aus Ihren verbundenen Konten verantwortlich. Ihre Plattform ist nur dann verantwortlich, wenn Sie defaults.responsibilities.losses_collector auf application und dashboard auf none setzen. Sie können die Konfiguration überprüfen, indem Sie defaults.responsibilities.requirements_collector überprüfen, das entweder stripe oder application sein kann.

Hinweis

Konfigurieren Sie die Plattformverantwortung für die Erfassung von Anforderungen nur, wenn Sie bereit sind, die operative Komplexität zu bewältigen, die zur Überprüfung der Anforderungsinformationen und zur Einhaltung aller Aktualisierungen der Anforderungen erforderlich ist.

Zuordnung der Controller-Eigenschaften für Accounts v1

Die in diesem Dokument beschriebenen Einstellungen entsprechen den Eigenschaften des Accounts v1-Controllers wie folgt:

Accounts v1-Eigenschaft	Accounts v2-Eigenschaft	Beschreibung
controller.fees.payer	defaults.responsibilities.fees_collector	Legt fest, wer Zahlungsgebühren für Direct Charges auf dem verbundenen Konto einzieht. (Für Destination Charges erhebt Stripe immer Gebühren von Ihrer Plattform.)
controller.losses.payments	defaults.responsibilities.losses_collector	Definiert die Verantwortung für negative Salden, die durch das verbundene Konto entstehen.
controller.requirement_collection	defaults.responsibilities.requirements_collector	In Accounts v2 wird dieser Wert automatisch auf Grundlage der Werte für `losses_collector` und `dashboard` berechnet. Sie können ihn nicht festlegen.
controller.stripe_dashboard.type	Dashboard	Gibt den Zugriff verbundener Konten auf Stripe-Dashboards an.