# 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 Treasury-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 [Accounts als Kundinnen und Kunden verwenden](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md). Um Stripe Treasury for platforms 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 Treasury für Plattformen einfügen, finden Sie im Leitfaden [Kontenstruktur von Treasury für Plattformen](https://docs.stripe.com/treasury/connect/account-management/accounts-structure.md). Treasury für Plattformen unterstützt 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 Treasury für Plattformen arbeiten. Als Plattform mit verbundenen Konten sind Sie dafür verantwortlich, eine Mindest-API-Version zu pflegen, Aktualisierungen der Allgemeinen Geschäftsbedingungen 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/treasury/connect/examples/fraud-guide.md). Für verbundene Konten müssen bestimmte Funktionen auf dem Konto aktiviert sein, um die Funktionen von Treasury für Plattformen nutzen zu können. Welche das sind, ist je nach Funktion unterschiedlich, und möglicherweise sind zusätzliche Informationen über die Inhaber/innen Ihrer verbundenen Konten erforderlich. Die Funktion `Treasury` stellt beispielsweise eine Anforderung an verbundene Konten für deren Zugriff auf Treasury für Plattformen dar. Wenn Sie `Treasury` für ein Konto anfordern, sind zusätzliche Felder für dieses verbundene Konto erforderlich, bevor das Konto Treasury für Plattformen verwenden kann. Bevor Sie verbundene Konten im Live-Modus für Ihre Integration von Treasury 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 Um ein verbundenes Konto für Treasury für Plattformen zu erstellen, müssen Sie die richtigen Funktionen anfordern. > Dieser Leitfaden zeigt, wie Sie ein neues verbundenes Konto mithilfe der Stripe API für Treasury für Plattformen erstellen, und erhebt keinen Anspruch auf Vollständigkeit. 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 zur Verwendung von Treasury 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/treasury/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 diejenigen verbundenen Konten zu aktualisieren, denen bereits ein `FinancialAccount` zugewiesen wurde. Siehe [Arbeiten mit Finanzkonten](https://docs.stripe.com/treasury/connect/account-management/financial-accounts.md) oder die Dokumentation zur [FinancialAccount-Objekt](https://docs.stripe.com/api/treasury/financial_accounts/object.md)-API 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 Inhaberinnen und Inhabern verbundener Konten in Treasury für Plattformen: [gehostetes Onboarding](https://docs.stripe.com/treasury/connect/account-management/connected-accounts.md#using-hosted-onboarding) und [benutzerdefiniertes Onboarding](https://docs.stripe.com/treasury/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 im Auge behalten, damit Ihr Onboarding-Workflow auf dem neuesten Stand bleibt. 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 Treasury 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/die Inhaber/in des verbundenen Kontos die [Vereinbarung zu Treasury für Plattformen](https://stripe.com/treasury-connect-account/legal) gelesen und akzeptiert hat . Siehe [Verarbeitung von Verifizierungen 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 Nutzer/innen von Treasury für Plattformen Pflichtfelder. | 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 Allgemeinen Geschäftsbedingungen von Treasury 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 Allgemeinen Geschäftsbedingungen von Treasury 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 Treasury für Plattformen aktualisieren. Das `requirements.eventually_due` -Array auf dem `Konto`-Objekt erfasst die aktualisierten Informationen, die für diese Vorschriftsänderungen erforderlich sind. Erfahren Sie mehr über den Hash [Anforderungen](https://docs.stripe.com/api/accounts/object.md#account_object-requirements).