# Mit verbundenen Konten arbeiten Fordern Sie die Treasury-Funktion an und erfassen Sie Onboarding-Anforderungen für Ihre verbundenen Konten. > #### Kompatibilität mit der Accounts v2 API > > Die Accounts v2 API unterstützt keine Financial Accounts-Workflows. Wenn Sie Konten mit Accounts v2 erstellt haben, können Sie Accounts v1 verwenden, um die Funktionen `treasury` and `card_issuing` zu verwalten. Weitere Informationen finden Sie unter [Konten als Kundinnen und Kunden verwenden](https://docs.stripe.com/connect/use-accounts-as-customers.md). Um Finanzkonten für Plattformen verwenden zu können, muss Ihre Plattform über eine Stripe *Connect* (Connect is Stripe's solution for multi-party businesses, such as marketplace or software platforms, to route payments between sellers, customers, and other recipients)-Integration verfügen. Stripe Connect ermöglicht es einer Plattform, Verkäufern und Dienstleistern verbundene Konten zur Verfügung zu stellen. Einen Überblick darüber, wie sich verbundene Konten in die Kontostruktur von Finanzkonten für Plattformen einfügen, finden Sie im Leitfaden [Kontenstruktur von Finanzkonten für Plattformen](https://docs.stripe.com/financial-accounts/connect/account-management/accounts-structure.md). Finanzkonten für Plattformen unterstützen nur verbundene Konten, die kein von Stripe gehostetes Dashboard verwenden und bei denen Ihre Plattform für die Erfassung von Anforderungen und die Verlusthaftung verantwortlich ist, einschließlich verbundener Custom-Konten. Erfahren Sie, wie Sie [verbundene Konten erstellen](https://docs.stripe.com/connect/interactive-platform-guide.md?connect-charge-type=direct&connect-loss-liability-owner=platform) die mit Finanzkonten für Plattformen arbeiten. Als Plattform mit verbundenen Konten sind Sie dafür verantwortlich, eine Mindest-API-Version zu pflegen, Aktualisierungen der Nutzungsbedingungen an Ihre verbundenen Konten zu kommunizieren, Informationsanfragen von ihnen zu bearbeiten und ihnen Support zu bieten. Da Ihre Plattform letztendlich für die Verluste verantwortlich ist, die Ihre verbundenen Konten erleiden, sind Sie auch dafür verantwortlich, sie auf Betrug zu überprüfen. Um mehr zu erfahren, lesen Sie den Leitfaden [Finanzkonten für Plattformen – Betrug](https://docs.stripe.com/financial-accounts/connect/examples/fraud-guide.md). Für verbundene Konten müssen bestimmte Funktionen auf dem Konto aktiviert sein, um die Funktionen von Finanzkonten für Plattformen nutzen zu können. Unterschiedliche Funktionen erfordern unterschiedliche Fähigkeiten, die möglicherweise zusätzliche Informationen über die Inhaber Ihres verbundenen Kontos erfordern. Die `treasury`-Funktion ist beispielsweise eine Anforderung an verbundene Konten für deren Zugang zu Finanzkonten für Plattformen. Wenn Sie `treasury` für ein Konto anfordern, sind zusätzliche Felder für dieses verbundene Konto erforderlich, bevor das Konto die Lösung Finanzkonten für Plattformen verwenden kann. Bevor Sie verbundene Konten im Live-Modus für die Integration Ihrer Finanzkonten für Plattformen erstellen, empfehlen wir Ihnen, zunächst verbundene Testkonten in einer *sandbox*-Umgebung zu erstellen. Verbundene Testkonten können kein echtes Geld empfangen oder senden und können nicht im Live-Modus verwendet werden, sind aber ansonsten in Konfiguration und Funktionalität identisch. ## Arten aktueller verbundener Konten prüfen Wenn Ihre Plattform bereits über eine Connect-Integration mit verbundenen Konten verfügt, Sie sich aber bezüglich deren Typs unsicher sind, können Sie diese Information über das Dashboard oder die API abrufen. #### Dashboard Navigieren Sie im Dashboard zur Seite [Verbundene Konten](https://dashboard.stripe.com/test/connect/accounts/overview). Wir listen Ihre verbundenen Konten in einem Tabellenformat auf. Um die Kontofunktionen zu finden, wählen Sie in der Tabelle ein Konto aus, um die Detailansicht zu öffnen, und klicken Sie dann auf **Profil** > **Kontoinformationen**. #### API-Anfrage Verwenden Sie `GET /v1/accounts`, um eine Liste der Konten auf Ihrer Plattform abzurufen. ```json { "object": "list", "data": [ { "id": "acct_1KUbgB2E0Hr5XQiY", "object": "account", "controller": { "type": "application", "dashboard": { "type": "none" }, "losses": { "payments": "application" }, "requirement_collection": "application", "fees": { "payer": "application" } }, ... } ] } ``` ## Erstellen Sie ein neues verbundenes Konto mit der Treasury-Funktion > Dieser Leitfaden zeigt, wie Sie ein neues verbundenes Konto mithilfe der Stripe API für Finanzkonten für Plattformen erstellen, und ist nicht vollständig. Eine vollständige Dokumentation zum Erstellen eines verbundenen Kontos, auch durch gehostetes Onboarding, finden Sie im [Leitfaden zur Connect-Integration](https://docs.stripe.com/connect/interactive-platform-guide.md?connect-charge-type=direct&connect-loss-liability-owner=platform). Verwenden Sie `POST /v1/accounts` , um ein neues verbundenes Konto zu erstellen. Fordern Sie die folgenden Funktionen für das Konto an, die für die Verwendung von Finanzkonten für Plattformen erforderlich sind: - `transfers` (erforderlich für alle verbundenen Konten) - `treasury` > Sie können das Konto später aktualisieren, um diese Funktionen anzufordern, wenn Sie dies nicht beim Erstellen des Kontos tun. Wenn Sie Karten mit Stripe Issuing für Ihr verbundenes Konto ausstellen möchten, müssen Sie die Funktion `card_issuing` anfordern. Siehe den Leitfaden [Arbeiten mit Karten von Stripe Issuing](https://docs.stripe.com/financial-accounts/connect/account-management/issuing-cards.md) für weitere Informationen. Wenn Sie ACH nutzen möchten, um Gelder von oder zu einem externen Konto zu überweisen, müssen Sie auch die Funktion `us_bank_account_ach_payments` anfordern. Mit allen vorherigen Optionen sieht die Anfrage wie folgt aus: ```javascript const account = await stripe.accounts.create({ country: 'US', email: email, capabilities: { transfers: {requested: true}, treasury: {requested: true}, card_issuing: {requested: true}, }, controller: { dashboard: {type: "none"}, losses: {payments: "application"}, requirement_collection: "application", fees: {payer: "application"} }, }); ``` Bei Erfolg bestätigt die Antwort, die Sie erhalten, das verbundene Konto und die angeforderten `capabilities`. ```json { "id": "acct_1234", "object": "account", "capabilities": { "card_issuing": "inactive", // Should be requested only for Stripe Issuing users. "treasury": "inactive", "us_bank_account_ach_payments": "inactive" }, ... } ``` Weitere Informationen zu Funktionen für verbundene Konten finden Sie im Leitfaden [Kontofunktionen](https://docs.stripe.com/connect/account-capabilities.md) für Connect. ## Aktualisieren Sie ein verbundenes Konto, um die Treasury-Funktion einzubeziehen Wenn Sie bereits ein verbundenes Konto mit aktivierten `card_payments` haben, verwenden Sie `POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}`, um das Konto mit der zugehörigen ID mit einer Anforderung für die Funktion `treasury` zu aktualisieren. Die folgende Anfrage aktualisiert ein verbundenes Konto mit einer Anfrage für die Funktion `treasury` und enthält die optionalen Funktionen `card_issuing` und `us_bank_account_ach_payments`: ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" \ -d "capabilities[treasury][requested]=true" \ -d "capabilities[card_issuing][requested]=true" \ -d "capabilities[us_bank_account_ach_payments][requested]=true" ``` Verwenden Sie `POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}`, um die Funktionen für verbundene Konten für solche verbundene Konten zu aktualisieren, denen bereits ein `FinancialAccount` zugewiesen wurde. Siehe [Arbeiten mit Finanzkonten](https://docs.stripe.com/financial-accounts/connect/account-management/financial-accounts.md) oder die [FinancialAccount objekt](https://docs.stripe.com/api/treasury/financial_accounts/object.md)-API-Dokumentation für weitere Informationen. ## Onboarding des verbundenen Kontos Nach der Erstellung eines Kontos müssen Sie das Onboarding des Verkäufers bzw. Dienstleisters durchführen, um die Eigentumsrechte zu erhalten. Das [`Account`](https://docs.stripe.com/api/accounts/object.md#account_object-requirements-currently_due)-Objekt, das das verbundene Konto darstellt, hat einen `requirements`-Hash, der die `currently_due` Anforderungen an die [Identitätsprüfung](https://docs.stripe.com/connect/handling-api-verification.md) enthält. Der Verkäufer oder Dienstleister auf Ihrer Plattform muss die im `requirements`-Hash aufgeführten Details angeben, um Zahlungen und [Auszahlungen](https://docs.stripe.com/payouts.md) für sein verbundenes Konto zu aktivieren und alle angeforderten Funktionen seines Finanzkontos zu aktivieren. Sie haben zwei Optionen für das Onboarding von Inhabern verbundener Konten in Finanzkonten für Plattformen: [gehostetes Onboarding](https://docs.stripe.com/financial-accounts/connect/account-management/connected-accounts.md#using-hosted-onboarding) und [benutzerdefiniertes Onboarding](https://docs.stripe.com/financial-accounts/connect/account-management/connected-accounts.md#using-custom-onboarding). Wir empfehlen ein gehostetes Onboarding. Wenn Sie ein `Account`-Objekt im Test-Modus erstellen und die Onboarding-Anforderungen umgehen möchten, um die Funktionalität zu testen, verwenden Sie `POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}`, um [Testwerte bereitzustellen](https://docs.stripe.com/connect/testing-verification.md), die alle Anforderungen erfüllen. Die folgende Anfrage wendet die erforderlichen Kontodetails mithilfe eines zuvor erstellten verbundenen Kontos an. ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" \ -d "tos_acceptance[date]=1547923073" \ -d "tos_acceptance[ip]=172.18.80.19" \ -d "settings[treasury][tos_acceptance][date]=1547923073" \ -d "settings[treasury][tos_acceptance][ip]=172.18.80.19" \ -d "business_profile[mcc]=5045" \ --data-urlencode "business_profile[url]=https://bestcookieco.com" \ -d "company[address][city]=Schenectady" \ -d "company[address][line1]=123 State St" \ -d "company[address][postal_code]=12345" \ -d "company[address][state]=NY" \ -d "company[tax_id]=000000000" \ -d "company[name]=The Best Cookie Co" \ -d "company[phone]=8888675309" \ -d "individual[first_name]=Jenny" \ -d "individual[last_name]=Rosen" ``` ### Gehostetes Onboarding verwenden Nutzen Sie Connect Onboarding, um die erforderlichen Informationen effizient zu erfassen. Dadurch wird die Verifizierungskomplexität von Ihrer Plattform auf Stripe verlagert und die Bedingungen des Rahmenvertrags werden erfasst. Alternativ können Sie Ihre eigenen API-Anforderungen für die Erstintegration schreiben, müssen jedoch die Änderungen der Compliance-Anforderungen m Auge behalten, um Ihren Onboarding-Workflow auf dem neuesten Stand zu halten. Erfahren Sie, wie Sie [verbundene Konten erstellen](https://docs.stripe.com/connect/interactive-platform-guide.md?connect-charge-type=direct&connect-loss-liability-owner=platform) die mit Finanzkonten für Plattformen arbeiten. Bevor Sie Connect Onboarding verwenden können, müssen Sie den Namen, die Farbe und das Symbol Ihrer Marke im Abschnitt **Branding** auf der [Seite mit Ihren Connect-Einstellungen](https://dashboard.stripe.com/test/settings/connect) angeben. Dadurch wird das visuelle Erscheinungsbild des Formulars angepasst, mit dem Verkäufer/innen und Dienstleister/innen nach dem Onboarding auf Ihrer Plattform interagieren. Um die Vorteile von Connect Onboarding zu nutzen, verwenden Sie `POST /v1/account_links`, um einen `AccountLink` zu erstellen, der dem/der Verkäufer/in bzw. Dienstleister/in bereitgestellt wird, der/die das verbundene Konto übernehmen wird: > Senden Sie Konto-Link-URLs aus Sicherheitsgründen nicht per E-Mail, Textnachricht oder anderweitig direkt an Ihre Nutzer/innen. Leiten Sie stattdessen authentifizierte Nutzer/innen von der Anwendung Ihrer Plattform an die Konto-Link-URL weiter. ```curl curl https://api.stripe.com/v1/account_links \ -u "<>:" \ -d "account={{CONNECTEDACCOUNT_ID}}" \ --data-urlencode "refresh_url=https://example.com/reauth" \ --data-urlencode "return_url=https://example.com/return" \ -d type=account_onboarding ``` Die Antwort, die Sie empfangen, enthält die URL, die Sie Ihrem Nutzer/Ihrer Nutzerin zur Verfügung stellen müssen. ```json { "object": "account_link", "created": 1612927106, "expires_at": 1612927406, "url": "https://connect.stripe.com/setup/s/iCtLfmYb2tEU" } ``` ### Eingebettetes Onboarding verwenden Die eingebettete Onboarding-Nutzeroberfläche weist nur wenig Stripe-Branding auf und kann an Ihre Marke angepasst werden. Sie bietet Ihnen mehr Kontrolle über das Nutzererlebnis als die gehostete Onboarding-Lösung von Stripe. Mit eingebettetem Onboarding erhalten Sie einen angepassten Onboarding-Ablauf ohne die Komplexität und den Pflegeaufwand, die mit der Aktualisierung Ihrer Onboarding-Integration bei sich ändernden Compliance-Anforderungen verbunden sind. Ihre Plattform bettet die [Konto-Onboarding-Komponente](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md) in Ihre Anwendung ein und Ihre verbundenen Konten interagieren mit der eingebetteten Komponente, ohne Ihre Anwendung zu verlassen. Das eingebettete Onboarding verwendet die [Accounts API](https://docs.stripe.com/api/accounts.md), um die Anforderungen zu lesen und ein Onboarding-Formular mit zuverlässiger Datenvalidierung zu generieren, das für alle von Stripe unterstützten Länder lokal angepasst ist. ### Nutzerdefiniertes Onboarding verwenden Wenn Sie lieber ein individuelles Onboarding für Ihre Nutzer/innen schaffen möchten, verwenden Sie `POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}` und `POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}/persons/{{PERSON_ID}}`, um die entsprechenden `Account`- und `Person`-Objekte mit den benötigten Informationen zu aktualisieren. Sie müssen auch bestätigen, dass der Inhaber des verbundenen Kontos die [Vereinbarung zu Finanzkonten für Plattformen](https://stripe.com/treasury-connect-account/legal) gelesen und akzeptiert hat . Siehe [Durchführung der Verifizierung mit der API](https://docs.stripe.com/connect/handling-api-verification.md) für weitere Informationen zur Erfüllung der Onboarding-Anforderungen. ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" \ -d "company[name]=Homebox" \ -d "company[address][line1]=123 Market St." \ -d "company[address][city]=San Francisco" \ -d "company[address][state]=CA" \ -d "company[address][postal_code]=94107" \ -d "company[address][country]=US" ``` ### Anforderungen Die Felder in der folgenden Tabelle sind für Benutzer/innen von Finanzkonten für Plattformen erforderlich. | Typ der juristischen Person | Beim Onboarding | | ------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Einzelperson, Einzelunternehmen | Angaben zum Unternehmen: - Unternehmensnamen (kundenorientiert und rechtlich) - Typ der juristischen Person - Geschäftsadresse - Geschäftliche Telefonnummer - Produkt- oder Dienstleistungsbeschreibung - Branchen- oder Händlerkategorie-Code - Steuernummer (SSN, ITIN oder EIN) - Akzeptanz der Nutzungsbedingungen (TOS) von Finanzkonten für Plattformen - Annahme der Nutzungsbedingungen von Stripe Angaben zum/zur Inhaber/in: - Rechtsgültiger Name - Geburtsdatum - E-Mail-Adresse - Privatanschrift - Vollständige Sozialversicherungsnummer (Social Security Number, SSN) oder Scan des ID-Dokuments für Personen außerhalb der USA oder wenn die Sozialversicherungsnummer nicht verifiziert werden kann - Titel - Telefonnummer | | Unternehmen (LLCs, Corporations, gemeinnützige Organisationen, Partnerschaften usw.) | Angaben zum Unternehmen: - Unternehmensnamen (kundenorientiert und rechtlich) - Typ der juristischen Person - Geschäftsadresse - Geschäftliche Telefonnummer - Produkt- oder Dienstleistungsbeschreibung - Branchen- oder Händlerkategorie-Code - Steuernummer (EIN) - Akzeptanz der Nutzungsbedingungen (TOS) von Finanzkonten für Plattformen - Annahme der Nutzungsbedingungen von Stripe Details zum/zur Inhaber/in und/oder Verantwortlichen: - Rechtsgültiger Name - Geburtsdatum - E-Mail-Adresse - Privatanschrift - Telefonnummer - Titel - Prozentualer Eigentumsanteil am Unternehmen - Vollständige Sozialversicherungsnummer (Social Security Number, SSN) oder Scan des ID-Dokuments für Personen außerhalb der USA oder wenn die Sozialversicherungsnummer nicht verifiziert werden kann | ### Abschluss Der Onboarding-Vorgang des verbundenen Kontos ist abgeschlossen, wenn Sie den [Webhook](https://docs.stripe.com/webhooks.md) `account.updated` erhalten, der die folgenden Felder in Ihrem verbundenen Konto bestätigt: ``` { "object": { "object": "account", "id": "acct_1234", "capabilities": { "treasury": "active", "card_issuing": "active", // Only appears if requesting the `card_issuing` capability. "us_bank_account_ach_payments": "active" // Only appears if requesting the `us_bank_account_ach_payments` capability. }, ... } } ``` Die Latenz für das Konto-Onboarding beträgt weniger als 5 Minuten, wenn Evolve Bank & Trust der Bankpartner Ihrer Plattform ist. ### Aktualisierte Anforderungen Um sich an Änderungen der Finanzvorschriften anzupassen, muss Stripe gelegentlich die Anforderungen an die Datenerfassung für Finanzkonten für Plattformen aktualisieren. Das `requirements.eventually_due` -Array auf dem `Account`-Objekt erfasst die aktualisierten Informationen, die für diese Verordnungsänderungen erforderlich sind. Erfahren Sie mehr über den Hash [requirements](https://docs.stripe.com/api/accounts/object.md#account_object-requirements).