# Verwendung von Connect mit verbundenen Standard-Konten Nutzen Sie verbundene Standard-Konten, um sofort mit Connect loszulegen und überlassen Sie Stripe den Großteil der Nutzererfahrung der verbundenen Konten. > #### Neuere Connect-Integrationen > > Die Informationen auf dieser Seite gelten nur für Plattformen, die bereits verbundene Legacy-Konten verwenden. Wenn du eine neue Connect-Plattform einrichtest oder deine Integration die Accounts v2-API nutzt, siehe [Konfigurieren Sie das Verhalten der verbundenen Konten](https://docs.stripe.com/connect/accounts-v2/connected-account-configuration.md), um mehr über Konfigurationen von verbundenen Konten zu erfahren. Wenn deine Integration die Accounts v1-API verwendet, siehe [Eigenschaften des Konto-Controllers](https://docs.stripe.com/connect/migrate-to-controller-properties.md#account-controller-properties). Das hier beschriebene Verfahren ist die empfohlene Methode für die Erstellung von Standard-Konten. Wenn Sie eine Erweiterung oder eine Anwendung anbieten, die Zugriff auf ein bestehendes Konto benötigt, um Dienstleistungen für Ihre Nutzer/innen zu erbringen, können Sie aber auch [OAuth](https://docs.stripe.com/connect/oauth-reference.md) verwenden. Ein verbundenes *Standard*-Konto ist ein konventionelles Stripe-Konto, bei dem Ihr verbundenes Konto eine Beziehung mit Stripe unterhält, sich beim [Dashboard](https://dashboard.stripe.com) anmelden kann und eigenständig Zahlungen abwickeln kann. Die Musterintegration von Stripe, [Kavholm](https://github.com/stripe-samples/connect-onboarding-for-standard), zeigt, wie Sie [Connect Onboarding](https://stripe.com/connect/onboarding) für ein nahtloses Onboarding-Nutzererlebnis verwenden können. ![Screenshot des Connect Onboarding-Formulars](https://b.stripecdn.com/docs-statics-srv/assets/Kavholm-Seamless-Standard.78b64d90c0bf87130c8b6ba1ef53df7f.png) ## So verwenden Sie Connect Onboarding bei Standard-Konten 1. Navigieren Sie zur Seite [Connect-Einstellungen](https://dashboard.stripe.com/account/applications/settings), um die visuelle Darstellung des Formulars mit dem Namen, der Farbe und dem Symbol Ihrer Marke anzupassen. 1. [Erstellen](https://docs.stripe.com/api/accounts/create.md) Sie mithilfe der API `/v1/accounts` ein neues Konto und rufen Sie die Konto-ID ab. Sie können die Informationen zum Account-Objekt für den/die Nutzer/in bereits angeben, bevor Sie den Konto-Link generieren. Übergeben Sie den folgenden Parameter: - `type` = `standard` > Nachdem Sie das neue Konto erstellt haben, überprüfen Sie, ob es im Dashboard angezeigt wird. 1. Rufen Sie die [Account Links](https://docs.stripe.com/api/account_links.md) API auf, um einen Link für das Onboarding des Kontos zu erstellen. 1. Im Onboarding-Verfahren für Ihre eigene Plattform leiten Sie Ihre Nutzer/innen an die von [Konto-Links](https://docs.stripe.com/api/account_links.md) zurückgegebene `url` weiter. 1. Verwalten Sie zusätzliche Kontostatus und leiten Sie Ihr Konto bei Bedarf zum Connect Onboarding-Verfahren weiter. 1. *Optional*: Sie können weitere Verfahren, zum Beispiel Tax oder Climate, über die [Connect-Onboarding-Optionen](https://dashboard.stripe.com/settings/connect/onboarding-options) zum Connect Onboarding-Ablauf hinzufügen. ## Standard-Konten erstellen und Informationen vorab angeben Verwenden Sie die API zum [Erstellen von Konten](https://docs.stripe.com/api/accounts/create.md), um ein verbundenes Konto zu erstellen, wobei `type` auf `standard` festgelegt ist. Sie können alle Angaben vorab machen, müssen aber mindestens den `type` angeben. Das Land des Kontos ist standardmäßig dasselbe wie das Land Ihrer Plattform und das Konto bestätigt die Auswahl beim Onboarding. Wenn Sie wissen, welche [Funktionen](https://docs.stripe.com/connect/account-capabilities.md) das Konto benötigt, können Sie diese bei der Erstellung anfordern. > Dieses Beispiel enthält nur einige der Felder, die Sie beim Erstellen eines Kontos festlegen können. Eine vollständige Liste der Felder, die Sie festlegen können, z. B. `address` und `website_url`, finden Sie in der [Dokumentation für die API zum Erstellen von Konten](https://docs.stripe.com/api/accounts/create.md). ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d type=standard ``` ### Informationen vorausfüllen (Optional) Falls Sie bereits Informationen für Ihre verbundenen Konten erfasst haben, können Sie diese im `Account`-Objekt vorab angeben. Sie können alle Kontoinformationen vorab ausfüllen, einschließlich persönlicher und geschäftlicher Informationen, externer Kontoinformationen usw. Nachdem Sie das `Account` erstellt haben, erstellen Sie eine [Person](https://docs.stripe.com/api/persons/create.md), die die für die Kontoeröffnung verantwortliche Person repräsentiert, wobei Sie `relationship.representative` auf „true“ setzen und alle Kontoinformationen, die Sie vorab ausfüllen möchten (z. B. Vor- und Nachname), eingeben. ```curl curl https://api.stripe.com/v1/accounts/{{ACCOUNT_ID}}/persons \ -u "<>:" \ -d first_name=Jenny \ -d last_name=Rosen \ -d "relationship[representative]=true" ``` Connect Onboarding fragt keine vorab ausgefüllten Informationen ab. Kontoinhaber/innen müssen vorausgefüllte Informationen jedoch bestätigen, bevor sie den [Connect-Rahmenvertrag](https://docs.stripe.com/connect/service-agreement-types.md) akzeptieren können. Füllen Sie beim Testen Ihrer Integration die Kontoinformationen vorab mit [Testdaten](https://docs.stripe.com/connect/testing.md) aus. ## Konto-Link erstellen Sie können einen Konto-Link erstellen, indem Sie die [Account Links](https://docs.stripe.com/api/account_links.md) API mit den folgenden Parametern aufrufen: - `account` – verwenden Sie die von der API aus dem vorherigen Schritt zurückgegebene Konto-ID - `refresh_url` - `return_url` - `type` = `account_onboarding` ```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 ``` ## Nutzer/innen an die Konto-Link-URL weiterleiten Die Antwort auf Ihre Anfrage nach [Konto-Links](https://docs.stripe.com/api/account_links.md)-Anforderung enthält einen Wert für den Schlüssel `url`. Leiten Sie Ihre Nutzer/innen an diesen Link weiter, um sie in den Ablauf aufzunehmen. Sie können URLs von der [Account Links](https://docs.stripe.com/api/account_links.md) API nur einmal verwenden, da sie Zugang zu den persönlichen Daten des Kontoinhabers/der Kontoinhaberin gewähren. Führen Sie die Authentifizierung der Nutzer/innen in Ihrer Anwendung durch, bevor Sie sie an diese URL weiterleiten. Nachdem Sie eine Kontoverknüpfung für ein Standardkonto erstellt haben, können Sie keine [Know Your Customer](https://support.stripe.com/questions/know-your-customer) (KYC)-Informationen mehr lesen oder schreiben. Füllen Sie alle KYC-Informationen vorab aus, bevor Sie den ersten Konto-Link erstellen. > Versenden Sie keine Konto-Link-URLs per E-Mail, Textnachricht oder anderweitig außerhalb Ihrer Plattformanwendung. Stellen Sie die URLs Ihren authentifizierten Kontoinhaberinnen und Kontoinhabern stattdessen in Ihrer Anwendung zur Verfügung. ## Rückkehr der Nutzer/innen zu Ihrer Plattform steuern Connect Onboarding verlangt, dass Sie sowohl eine `return_url` als auch eine `refresh_url` übergeben, um alle Fälle steuern zu können, in denen Sie die Nutzer/innen an Ihre Plattform zurückleiten. Es ist wichtig, dass Sie diese URLs korrekt implementieren, um Ihren Nutzern/innen die bestmögliche Erfahrung zu bieten. > Sie können HTTP für Ihre `return_url` und `refresh_url` verwenden, während Sie sich in einer Testumgebung befinden (z. B. für einen Test mit localhost). Im Live-Modus können Sie aber nur HTTPS verwenden. Sie müssen alle Test-URLs gegen HTTPS-URLs austauschen, bevor Sie live gehen. #### return_url Stripe löst eine Weiterleitung zu dieser URL aus, wenn die Nutzer/innen das Connect Onboarding abschließen. Das heißt nicht, dass alle Informationen erfasst wurden oder keine offenen Anforderungen für das Konto bestehen. Es bedeutet lediglich, dass die Nutzer/innen das Verfahren ordnungsgemäß durchlaufen und beendet haben. Über diese URL wird kein Status übergeben. Nachdem ein/eine Nutzer/in zu Ihrer `return_url` weitergeleitet wurde, überprüfen Sie den Status des Parameters `details_submitted` für das jeweilige Konto, indem Sie eine der folgenden Aktionen ausführen: - Achten Sie auf `account.updated`-*Webhooks* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests). - Rufen Sie die [Accounts](https://docs.stripe.com/api/accounts.md)-API auf und prüfen Sie das zurückgegebene Objekt. #### refresh_url Ihre Nutzer/innen werden in den folgenden Fällen an die `refresh_url` weitergeleitet: - Der Link ist abgelaufen (seit Erstellung des Links sind ein paar Minuten vergangen). - Der/die Nutzer/in hat den Link bereits aufgerufen (er/sie hat die Seite aktualisiert oder auf die Zurück/Vorwärts-Schaltfläche geklickt) - Ihre Plattform hat keinen Zugang mehr zu diesem Konto. - Das Konto wurde abgelehnt. Ihre `refresh_url` löst eine Methode auf Ihrem Server aus, um [Account Links](https://docs.stripe.com/api/account_links.md) erneut mit denselben Parametern aufzurufen und Nutzer/innen an das Connect Onboarding zurückzuleiten, damit ein nahtloses Erlebnis entsteht. ## Umgang mit Nutzer/innen, die das Onboarding nicht abgeschlossen haben Wenn Nutzer/innen an Ihre `return_url` weitergeleitet werden, haben sie das Onboarding möglicherweise nicht abgeschlossen. Rufen Sie mithilfe des Endpoints `/v1/accounts` das Nutzerkonto auf und prüfen Sie den Wert für `charges_enabled`. Wenn das Onboarding für das Konto nicht komplett abgeschlossen wurde, geben Sie den Nutzerinnen/Nutzern mithilfe entsprechender Eingabeaufforderungen der Nutzeroberfläche die Möglichkeit, das Onboarding zu einem späteren Zeitpunkt fortzusetzen. Diese können ihre Konto-Aktivierung dann über einen neuen (von Ihrer Integration generierten) Link abschließen. Anhand des Status des Parameters `details_submitted` im Nutzerkonto können Sie überprüfen, ob das Onboarding abgeschlossen wurde. ## Optional: Überwachung der Steuerpflichten durch Stripe Tax aktivieren Verwenden Sie Stripe Tax, um es verbundenen Konten zu ermöglichen, ihre [Steuerpflichten](https://docs.stripe.com/tax/monitoring.md) während der Zahlungsabwicklung zu überwachen. Stripe sendet [Benachrichtigungen](https://docs.stripe.com/tax/monitoring.md#tax-threshold-notifications) an diese Konten, wenn sie bestimmte Steuerschwellenwerte überschreiten. Um die Überwachung der Verpflichtungen zu ermöglichen, aktivieren Sie Stripe Tax in Ihrem [Connect-Onboarding-Optionen](https://dashboard.stripe.com/settings/connect/onboarding-options). Dadurch wird ein zusätzlicher Schritt aktiviert, bei dem grundlegende Steuerinformationen angefordert werden, z. B. der [voreingestellte Steuercode](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#product-tax-code), Ihres verbundenen Kontos, der beim Onboarding-Vorgang für verbundene Konten mit Zugriff auf das Stripe-Dashboard angezeigt wird. Stripe Tax verwendet diese Informationen, um zu berechnen, wann Steuerschwellenwerte überschritten werden könnten. Erfahren Sie, wie Sie [Steuern als Plattform einziehen](https://docs.stripe.com/tax/connect.md). ## See also - [Zahlungen erstellen](https://docs.stripe.com/connect/charges.md) - [Authentifizierung](https://docs.stripe.com/connect/authentication.md) - [Referenz für OAuth](https://docs.stripe.com/connect/oauth-reference.md)