# Auszahlungskonten für verbundene Konten verwalten Erfahren Sie, wie Sie externe Bankkonten und Debitkarten für verbundene Konten verwalten *Auszahlung* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit)skonten können Bankkonten oder Debitkarten sein. Stripe empfiehlt, externe Kontodaten mit dem Webformular von Connect Onboarding zu erfassen, das Ihnen bei Folgendem hilft: - Sparen Sie Zeit bei Design und Entwicklung. - Sie müssen keine Daten wie Konto- und Routingnummern mehr auf Ihrem Server speichern. - Es ist nicht mehr erforderlich, Formularvalidierungen zu erstellen, wenn verbundene Konten Kontodaten eingeben. In den USA empfehlen wir außerdem die Verwendung von [Stripe Financial Connections](https://docs.stripe.com/financial-connections.md), mit dem Ihre verbundenen Konten ihre Finanzkonten sicher mit Ihrem Unternehmen verknüpfen können. Dies unterstützt Sie dabei: - Steigern Sie die Konversion beim Onboarding, indem Sie verhindern, dass Ihre Kundinnen und Kunden den Vorgang unterbrechen müssen, um ihre Konto- und Routingnummern zu finden. - Reduziert die Fehlerquote bei der ersten Auszahlung, indem Fehler vermieden werden, die durch die manuelle Eingabe von Konto- und Routingnummern entstehen. - Sie müssen keine Daten wie Konto- und Routingnummern mehr auf Ihrem Server speichern. - Sie müssen keine Formularvalidierungen erstellen, wenn Konten Kontodetails in nutzerdefinierte Onboarding-Formulare eingeben. - (Nur Accounts v1) Lassen Sie Ihre Konten von einer schnelleren Authentifizierung profitieren, indem Sie die Wiederverwendung der bei [Link](https://support.stripe.com/questions/link-for-financial-connections-support-for-businesses) gespeicherten Bankkontodaten ermöglichen. Konten, die ihre Kontoinformationen bei einem der Stripe-Unternehmen über Link speichern, können ihre Kontodetails bei der nächsten Verwendung von Financial Connections mit Ihrer Plattform teilen. - Greifen Sie auf zusätzliche Informationen zum externen Bankkonto eines Kontos zu, z. B. [Salden](https://docs.stripe.com/financial-connections/balances.md), [Details zur Inhaberschaft](https://docs.stripe.com/financial-connections/ownership.md) und [Transaktionen](https://docs.stripe.com/financial-connections/transactions.md). Sie können Betrug beim Onboarding verringern, indem Sie solche Informationen wie beispielsweise den Namen und die Adresse des Inhabers/der Inhaberin des externen Bankkontos überprüfen. Wenn [Link aktiviert ist](https://dashboard.stripe.com/settings/connect/payouts/external_accounts), fallen für von Stripe gehostetes und eingebettetes Onboarding keine Zahlungen für Financial Connections-Verifizierungen an. Andernfalls gelten die [Standardpreise für Financial Connections-Verifizierungen](https://stripe.com/financial-connections#pricing). Wenn Sie das API-Onboarding für Ihre verbundenen Konten verwenden, können Sie Auszahlungskontodaten mit einem nutzerdefinierten Formular im Onboarding-Ablauf Ihres Kontos erfassen. ### Erfassung externer Konten ablehnen Für Konten, bei denen die Plattform für die Erfassung der Anforderungen verantwortlich ist, wie z. B. Custom-Konten, können Sie sich dafür entscheiden, beim Onboarding keine externen Kontoinformationen zu erfassen. Dies bietet sich an, wenn Sie beispielsweise Ihren eigenen Onboarding-Ablauf erstellen, bei dem Sie externe Kontoinformationen erfassen möchten. Im eingebetteten Onboarding können Sie den [Einzug externer Konten deaktivieren](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md?#external-account-collection), indem Sie die Funktion `external_account_collection` in der Account-Session auf false setzen. Alternativ können Sie im gehosteten Onboarding zu Ihren [Connect-Einstellungen für externe Konten](https://dashboard.stripe.com/settings/connect/payouts/external_accounts) gehen und dann unter **Konten, bei denen die Plattform für das Einziehen von Anforderungen zuständig ist** das Einziehen von externen Kontoinformationen aktivieren oder deaktivieren. Beachten Sie, dass dies standardmäßig ausgeschaltet ist. ## Erfassung externer Konten #### Von Stripe gehostetes oder eingebettetes Onboarding [Das von Stripe gehostete und eingebettete Onboarding](https://docs.stripe.com/connect/onboarding.md) verwendet anpassbare Webformulare, um die für die Einbindung verbundener Konten erforderlichen Informationen zu erfassen. Es können sowohl Bankkonten als auch Debitkarten erfasst werden. Mit Financial Connections können Sie Bankkontodaten erfassen, jedoch keine Debitkartendaten. Bei verbundenen Konten, bei denen Ihre Plattform für negative Guthaben verantwortlich ist, können Sie den Einzugsverlauf externer Konten in Ihren Einstellungen für [externe Konten](https://dashboard.stripe.com/settings/connect/payouts/external_accounts) anpassen. In den Einstellungen Ihres **externen Kontos** können Sie Folgendes tun: - Aktivieren oder deaktivieren Sie die Erfassung von Debitkarten, indem Sie unter **Debitkarten zulassen?** eine Auswahl treffen. - Es ist erforderlich, dass verknüpfte Konten mindestens ein Bankkonto hinzufügen müssen, bevor andere externe Konten, wie z. B. eine Debitkarte, hinzugefügt werden können. Sie können diese Einstellung unter **Sie benötigen mindestens ein Bankkonto?** aufrufen. Dies ist nützlich, um die Unterstützung von [automatischen Lastschriften](https://docs.stripe.com/connect/account-balances.md#automatically-debit-connected-accounts) sicherzustellen. - Legen Sie fest, ob verbundene Konten mehr als ein externes Konto in einer bestimmten Währung hinzufügen dürfen oder nicht. Es gibt ein Limit von fünf externen Konten pro Währung. Sie können diese Einstellung unter **Mehrere externe Konten pro Währung erfassen** aufrufen. #### Stripe Financial Connections verwenden ### Verfügbar in - US Stripe-Plattformen in den USA können [Stripe Financial Connections](https://docs.stripe.com/financial-connections.md) innerhalb des von Stripe gehosteten oder eingebetteten Onboarding-Formulars aktivieren, indem Sie folgende Schritte ausführen: 1. Gehen Sie zu den [Einstellungen Ihres externen Kontos](https://dashboard.stripe.com/settings/connect/payouts/external_accounts), in denen Sie die optionalen Onboarding-Funktionen von Connect verwalten. 1. Für verbundene Konten, bei denen Ihre Plattform Kontoinformationen erfasst, wenn sich die Anforderungen ändern, müssen Sie Stripe-gehostetes und eingebettetes Onboarding zulassen, um externe Kontodaten zu erfassen. Aktivieren Sie unter **Stripe-gehostetes Onboarding für benutzerdefinierte Konten** die Option, um Stripe die Erfassung externer Kontoinformationen zu gestatten. 1. Wählen Sie unter **Wie werden Bankkontodetails erfasst?** die Option **Financial Connections** aus. 1. (Optional) Beantragen Sie die Berechtigung zum Zugriff auf zusätzliche Daten zu den Konten, die sofort mit Financial Connections verifiziert wurden, wie z. B. Guthaben, Angaben zur Kontoinhaberin bzw. zum Kontoinhaber und Transaktionen. Wenn Sie diesen zusätzlichen Zugriff beantragen, werden Sie aufgefordert, sich für Stripe Financial Connections anzumelden. Wenn die Erfassung externer Kontodaten aktiviert ist, fordert der Onboarding-Prozess alle verbundenen Konten auf, ihr Bankkonto zu authentifizieren. ![Bild, das einen Connect-Onboarding-Ablauf zeigt, bei dem Stripe Financial Connections verwendet wird, um ein Auszahlungskonto zu erfassen.](https://b.stripecdn.com/docs-statics-srv/assets/connect-custom-onboarding-financial-connections-onboarding.8937a023f6682c90bab8c0b39873909a.png) Ein Connect Onboarding-Ablauf mit Stripe Financial Connections zur Erfassung eines Auszahlungskontos. Wenn ein verbundenes Konto sein Bankkonto nicht sofort mit Financial Connections verifizieren kann, greift der Verifizierungsvorgang automatisch auf die manuelle Eingabe zurück. ![Abbildung, die einen Connect-Onboarding-Ablauf zeigt, bei dem der Stripe Financial Connections-Dialog verwendet wird, um ein Auszahlungskonto durch manuelle Eingabe zu erfassen.](https://b.stripecdn.com/docs-statics-srv/assets/connect-custom-onboarding-financial-connections-manual-entry.930da1e01c9026b9014008d75958bc8c.png) Ein Connect-Onboarding-Ablauf, der den Stripe-Financial-Connections-Dialog verwendet, um ein Auszahlungskonto durch manuelle Eingabe zu erfassen. Nach dem Onboarding wird das angegebene Bankkonto automatisch mit dem verbundenen Konto verbunden. ## Daten von einem Financial Connections-Konto abrufen (Server-side) Sie können anhand der `Konto`-ID ermitteln, ob ein verbundenes Konto mit einem Financial Connections-Konto verknüpft ist, indem Sie alle verknüpften Financial Connections-Konten abrufen. Geben Sie die `Konto`-ID als `account_holder.account` und im Header `Stripe-Account` an. ```curl curl -G https://api.stripe.com/v1/financial_connections/accounts \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "account_holder[account]={{CONNECTEDACCOUNT_ID}}" ``` Dadurch wird eine API-Antwort ähnlich der folgenden zurückgegeben: ```json { "object": "list", "data": [ { "id": "fca_zbyrdjTrwcYZJZc6WBs6GPid", "object": "financial_connections.account", "account_holder": { "account": "{{CONNECTED_ACCOUNT_ID}}", "type": "account" }, ... "supported_payment_method_types": [ "us_bank_account" ] } ... ] } ``` Wenn Financial Connections-Konten aufgeführt sind, gibt dies an, dass das verbundene Konto sie während des Onboarding-Vorgangs verknüpft hat. Sie können den `id`-Wert verwenden, um auf die Daten, die Sie in den [Einstellungen Ihres externen Kontos](https://dashboard.stripe.com/settings/connect/payouts/external_accounts) angegeben haben, zuzugreifen oder sie zu aktualisieren. Um die Privatsphäre der Daten Ihres verbundenen Kontos zu schützen, können Sie nur auf die von Ihnen angegebenen Daten zugreifen. Um mit dem Abrufen von Kontodaten zu beginnen, befolgen Sie die Leitfäden für [Salden](https://docs.stripe.com/financial-connections/balances.md), [Inhaberschaft](https://docs.stripe.com/financial-connections/ownership.md) und [Transaktionen](https://docs.stripe.com/financial-connections/transactions.md). Geben Sie bei allen nachfolgenden Anfragen zum Abrufen und Aktualisieren von Konten den Header `Stripe-Account` mit der ID des verbundenen Kontos an: ```curl curl https://api.stripe.com/v1/financial_connections/accounts/fca_zbyrdjTrwcYZJZc6WBs6GPid/refresh \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "features[]=balance" ``` #### Manuelle Eingabe von Bankkontodaten aktivieren Führen Sie die folgenden Schritte aus, damit Stripe manuell Bankkontodaten von verbundenen Konten im Onboarding-Formular erfassen kann: 1. Öffnen Sie Ihre Connect-Einstellungen und gehen Sie zu Auszahlungen > Externe Konten, wo Sie die Connect Onboarding-Optionen verwalten können. 1. Wählen Sie unter **Wie werden Bankkontodetails erfasst?** die Option zur manuellen Erfassung von Bankkontodaten aus. 1. Für verbundene Konten, bei denen Ihre Plattform Kontoinformationen erfasst, wenn sich die Anforderungen ändern, müssen Sie Stripe-gehostetes und eingebettetes Onboarding zulassen, um externe Kontodaten zu erfassen. Aktivieren Sie unter **Konten, bei denen die Plattform für die Erfassung der Anforderungen verantwortlich ist** die Option, um Stripe die Erfassung externer Kontoinformationen zu gestatten. ![Bild, das einen Connect-Onboarding-Ablauf zeigt, bei dem ein Formular verwendet wird, um ein Auszahlungskonto mit manueller Eingabe zu erfassen.](https://b.stripecdn.com/docs-statics-srv/assets/connect-custom-onboarding-payout-manual-entry-form.6764993258659b2ad6517e0825181e49.png) Connect Onboarding-Ablauf, bei dem ein Formular zur Erfassung eines Auszahlungskontos mit manueller Eingabe verwendet wird. Jedes Land hat ein etwas anderes Format für die Bankkontodaten. In dem Formular werden automatisch die geeigneten Felder für das Land angezeigt, in dem Sie tätig sind. #### Direkte API-Aufrufe über ein nutzerdefiniertes Formular Für verbundene Konten, bei denen Ihre Plattform bei sich ändernden Anforderungen Kontodaten erfasst, können Sie externe Kontodaten erfassen, indem Sie direkte API-Aufrufe von einem nutzerdefinierten Formular aus durchführen. #### Stripe Financial Connections aktivieren ### Verfügbar in - US Stripe-Plattformen in den USA können [Stripe Financial Connections](https://stripe.com/financial-connections) in ihrem nutzerdefinierten Onboarding-Formular aktivieren. Nachdem Sie Stripe Financial Connections in Ihrem Formular aktiviert haben, authentifizieren verbundene Konten ihr Bankkonto sofort im Rahmen des [Authentifizierungsvorgangs](https://docs.stripe.com/financial-connections/fundamentals.md#authentication-flow). [Registrieren Sie sich für Financial Connections](https://dashboard.stripe.com/financial-connections/application), um zum Live-Modus zugelassen zu werden. ### SetupIntent erstellen (Server-side) Fügen Sie in Ihr Onboarding-Formular eine Schaltfläche oder einen Link ein, der einen serverseitigen Endpunkt aufruft, um einen [SetupIntent](https://docs.stripe.com/api/setup_intents.md) zu erstellen. Der SetupIntent steht für Ihre Absicht, die Bankkontodaten eines verbundenen Kontos zu erfassen. Ihre Schaltfläche könnte beispielsweise die Aufschrift **Bankkonto verknüpfen** tragen. Wir empfehlen Ihnen, für jedes verbundene Konto eine/n *Kundin/Kunden* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments) mit einer E-Mail-Adresse anzulegen. Durch das Hinzufügen eines Kundenobjekts können Sie [zuvor verknüpfte externe Konten später auflisten](https://docs.stripe.com/api/financial_connections/accounts/list.md). Geben Sie beim Anlegen der Kundin bzw. des Kunden eine E-Mail-Adresse an, damit sich diese/r mit weniger Schritten bei ihrem/seinen Konten authentifizieren kann, indem sie/er ihre/seine Bankdaten mit [Link](https://support.stripe.com/questions/link-for-financial-connections-support-for-businesses) über Stripe-Unternehmen hinweg mithilfe des Financial [Connections-Authentifizierungsablaufs](https://docs.stripe.com/financial-connections/fundamentals.md#authentication-flow) speichert und wiederverwendet. Wenn Sie einen SetupIntent zum Erfassen von Bankkontodaten für ein verbundenes Konto erstellen, legen Sie die folgenden Parameter fest: 1. `customer`-Typ auf die [Kunden-ID](https://docs.stripe.com/api/customers/object.md#customer_object-id) festlegen 1. `payment_method_types` auf `["us_bank_account"]` festlegen 1. `flow_directions` auf `["outbound"]` festlegen 1. (Optional) Berücksichtigen Sie zusätzliche Daten, die für die Ausführung Ihres Use case erforderlich sind, und fordern Sie die Berechtigung zum Zugriff auf diese Daten an. Legen Sie beispielsweise `payment_method_options[us_bank_account][financial_connections][permissions]` auf `["payment_method", "ownership"]` fest, um Zugriff auf die Eigentumsdaten für das Financial Connections-Konto anzufordern, nachdem der/die Nutzer/in sein/ihr Bankkonto mithilfe von Financial Connections verknüpft hat. Nachfolgend finden Sie ein Beispiel für die Mindestanforderungen für die Erstellung eines SetupIntent zur Erfassung von Bankkontodaten: ```curl curl https://api.stripe.com/v1/setup_intents \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "flow_directions[]=outbound" \ -d "payment_method_types[]=us_bank_account" ``` Der SetupIntent in der Antwort enthält ein `client_secret`, mit dem Sie die modale Nutzeroberfläche von Stripe.js auf der Seite starten können, die die Erfassung und Verifizierung von Bankkontodaten handhabt. Achten Sie auf einen vorsichtigen Umgang mit dem `client_secret`, da es den Zugang zum SetupIntent nur mit einem veröffentlichbaren Schlüssel ermöglicht. Sie dürfen nicht protokolliert, in URLs eingebettet oder Personen außer Ihren verbundenen Konten zugänglich gemacht werden. #### Internet ## Angaben zu Zahlungsmethoden erfassen (Client-side) Fügen Sie das Stripe.js-Skript auf Ihrer Erfassungsseite für Bankkonten ein, indem Sie es zum Header der HTML-Datei hinzufügen. ```html Payout ``` Erstellen Sie einen Instanz von Stripe.js mit dem folgenden JavaScript auf Ihrer Erfassungsseite der Bankkonten. ```javascript // Set your publishable key. Remember to change this to your live publishable key in production! // See your keys here: https://dashboard.stripe.com/apikeys var stripe = Stripe('<>', { apiVersion: "{{DATE_VERSION}}" }); ``` Übergeben Sie das `client_secret` des `SetupIntent` und den vollständigen Nutzernamen Ihres verbundenen Kontos an `stripe.collectBankAccountForSetup`, um die Zahlungsmethode zu erfassen. ```javascript // Assume you have a form to collect payout accounts var form = document.getElementById('payout-form'); form.addEventListener('submit', (event) => { event.preventDefault(); // clientSecret is the SetupIntent's client_secret property stripe.collectBankAccountForSetup({ clientSecret, params: { payment_method_type: 'us_bank_account', payment_method_data: { billing_details: { // name is required name: 'Jenny Rosen', email: 'jenny@example.com' }, }, }, // Optional, helpful for client-side logic expand: ['payment_method'] }).then(({setupIntent, error}) => { if (error) { // Inform your connected account user that there was an error. console.log(error.message); } else { if (setupIntent.status === "requires_confirmation") { // Your connected account user provided bank account details // When you pass `expand: ['payment_method']` to `collectBankAccountForSetup`, // `setupIntent.payment_method` has data about the Payment Method, including // the Financial Connections Account ID, if your connected account user used // Financial Connections to provide their bank account details. const usedFinancialConnections = typeof setupIntent.payment_method.financial_connections_account === 'string'; console.log(setupIntent.payment_method.id); // => 'pm_1Mb4UkJGNKiWrCEmJ1PS72Cd' return stripe.confirmUsBankAccountSetup(clientSecret).then(({setupIntent, error}) => { if (error) { // Inform your connected account user that there was an error, and check your request logs for errors console.log(error.message); } else { if (setupIntent.status === 'succeeded') { // SetupIntent confirmed, Payment Method attached to the Customer // Your logic to create a payout account could go here } else { // Unable to confirm the SetupIntent, re-fetch the SetupIntent for details } } }); } else { // Your connected account user didn't provide bank account details. You // can re-prompt them using `collectBankAccountForSetup` return null; } } }); }); ``` `collectBankAccountForSetup` gibt ein `Promise` zurück. Sobald Ihr verbundenes Konto den Stripe.js-Dialog abgeschlossen hat, wird das `Promise` mit einem `Ergebnisobjekt` aufgelöst, das einen der folgenden Schlüssel enthält: - `setupIntent`, wenn Ihr verbundenes Konto den Dialog verlässt - `Fehler`, wenn bei der Anzeige des Dialogs ein nicht behebbarer Fehler auftritt Wenn das `Promise` mit einem `setupIntent`-Schlüssel aufgelöst wird und `result.setupIntent.status` gleich `"requires_confirmation"` ist, bestätigen Sie den `SetupIntent`, indem Sie `confirmUsBankAccountSetup` mit dem `client_secret` des `SetupIntent` aufrufen. `confirmUsBankAccountSetup` gibt auch ein `Promise` zurück, das mit dem gleichen Typ des `Ergebnisobjekts` aufgelöst wird wie `collectBankAccountForSetup`. Bei erfolgreicher Bestätigung ist `result.setupIntent.status` gleich `"succeeded"`. Das bedeutet, dass Sie die `payment_method` des `SetupIntent` verwenden können, um ein Bankkonto-Token auf Ihrem Server zu erstellen. Wenn Sie `stripe.collectBankAccountForSetup` aufrufen, lädt Stripe.js den [Authentifizierungsablauf](https://docs.stripe.com/financial-connections/fundamentals.md#authentication-flow). Dabei handelt es sich um ein Dialog auf der Seite, das Ihren verbundenen Konten Informationen darüber bereitstellt, welche Daten sie freigeben, ihnen ermöglicht, ihr Finanzinstitut zu finden und auszuwählen und ihnen eine sichere Anmeldung bei ihrem Konto zur Verifizierung des Zugriffs ermöglicht. Standardmäßig können Ihre verbundenen Konten im Authentifizierungsablauf nur ein Girokonto oder Sparkonto hinzufügen, da Stripe nur Auszahlungen auf ein für ACH freigegebenes Konto ermöglichen kann. Die manuelle Eingabe der Kontonummer und der Routingnummer ist ebenfalls möglich, falls Ihr verbundenes Konto die Bank nicht finden oder das Konto nicht authentifizieren kann. Der Ablauf bei einer manuellen Eingabe könnte wie folgt aussehen: ![Authentifizierungsablauf mit Ausweichlösung für manuelle Eingabe](https://b.stripecdn.com/docs-statics-srv/assets/manual_fallback.c910f590ec792b6133bb88947332604c.png) Wenn Sie verhindern möchten, dass Ihre Nutzer/innen ihre Bankkontodaten manuell eingeben, übergeben Sie beim Erstellen des `SetupIntent` `payment_method_options[us_bank_account][verification_method]=instant`. ### Externes Konto erstellen, das Sie für Auszahlungen verwenden können (Server-side) Nachdem Sie den SetupIntent bestätigt haben, verwenden Sie die angehängte Zahlungsmethode, um ein Bankkonto-Token zu erstellen. Verwenden Sie das Token dann, um ein externes Auszahlungskonto zu erstellen. Erstellen Sie zuerst ein Bankkonto-Token. ```curl curl https://api.stripe.com/v1/tokens \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "bank_account[payment_method]={{PAYMENTMETHOD_ID}}" \ -d "customer={{CUSTOMER_ID}}" ``` Verwenden Sie dann die ID des Tokens, um ein externes Auszahlungskonto zu erstellen. ```curl curl https://api.stripe.com/v1/accounts/{{ACCOUNT_ID}} \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "external_account={{TOKEN_ID}}" ``` Wenn Sie ein externes Konto angeben, wird dieses als neues externes Standardkonto für die entsprechende Währung festgelegt, und das alte Standardkonto (falls vorhanden) wird gelöscht. Sie können jetzt Auszahlungen an Ihr verbundenes Konto senden. Weitere Informationen zum Erstellen und Verwalten eines externen Kontos für Auszahlungen finden Sie unter [Erstellen eines externen Bankkontos](https://docs.stripe.com/api/external_account_bank_accounts/create.md). ### Daten von einem Financial Connections-Konto abrufen (Server-side) Sie können ermitteln, ob Ihr/e Nutzer/in über ein verknüpftes Financial Connections-Konto verfügt, indem der SetupIntent mit der erweiterten Eigenschaft `payment_method` abgerufen wird. ```curl curl -G https://api.stripe.com/v1/setup_intents/{{SETUP_INTENT_ID}} \ -u "<>:" \ -d "expand[]=payment_method" ``` Dadurch wird eine API-Antwort ähnlich der folgenden zurückgegeben: ```javascript { "id": "{{SETUP_INTENT_ID}}", "object": "setup_intent", // ... "payment_method": { "id": "{{PAYMENT_METHOD_ID}}", "object": "payment_method", // ... "type": "us_bank_account", "us_bank_account": { // ... // the value of "financial_connections_account" may be null "financial_connections_account": "{{FINANCIAL_CONNECTIONS_ACCOUNT_ID}}", // ... } }, // ... } ``` Wenn das `us_bank_account`-Objekt des `payment_method`-Objekts für den SetupIntent die Eigenschaft `financial_connections_account` enthält, verfügt der/die Nutzer/in über ein verknüpftes Financial Connections-Konto. Sie können den Wert `financial_connections_account` verwenden, um auf die Daten, die Sie im Parameter `payment_method_options[us_bank_account][financial_connections][permissions]` des SetupIntent angegeben haben, zuzugreifen oder sie zu aktualisieren. Um die Privatsphäre der Daten Ihrer Nutzer/innen zu schützen, sind die Kontodaten, auf die Sie zugreifen können, auf die Daten beschränkt, die Sie in diesem Parameter angegeben haben. Beachten Sie die Leitfäden für [Salden](https://docs.stripe.com/financial-connections/balances.md), [Inhaberschaft](https://docs.stripe.com/financial-connections/ownership.md) und Daten zu [Transaktionen](https://docs.stripe.com/financial-connections/transactions.md), um mit dem Abrufen von Kontodaten zu beginnen. ### (Optional) Zahlungsmethode zur Verarbeitung von Zahlungen verwenden Sie können eine mit der obigen Integration erfasste PaymentMethod nicht verwenden, um Zahlungen mit PaymentIntents zu verarbeiten, da der SetupIntent nur eine `"outbound"`-Berechtigung anfordert und Sie keine Autorisierung von Ihren Nutzer/innen durch Anzeige eines [Mandats](https://docs.stripe.com/payments/ach-direct-debit/set-up-payment.md#web-collect-mandate-and-submit) erhalten haben. Wenn Sie Ihren Nutzer/innen gestatten möchten, dasselbe Konto zur Durchführung von Zahlungen und für den Erhalt von Auszahlungen zu verwenden, 1. Entfernen Sie den Parameter `flow_directions` aus dem API-Aufruf zum Erstellen eines SetupIntent. 1. Erfassen Sie ein [Mandat](https://docs.stripe.com/payments/ach-direct-debit/set-up-payment.md#web-collect-mandate-and-submit) von Ihrem/Ihrer Nutzer/in. Weitere Informationen finden Sie im [Leitfaden zu ACH-Lastschriften](https://docs.stripe.com/payments/ach-direct-debit/set-up-payment.md). Dieses Integrationsmuster löst die Verifizierung von Testeinzahlungen aus, wenn Ihr/e Nutzer/in seine/ihre Bankkontodaten mit dem Formular für die manuelle Eingabe zur Verfügung stellt. #### iOS ## Zusätzliche Abhängigkeit für Financial Connections aufnehmen(Client-side) Das [Stripe iOS SDK](https://github.com/stripe/stripe-ios) ist Open Source, [vollständig dokumentiert](https://stripe.dev/stripe-ios/index.html) und kompatibel mit Apps, die iOS 13 oder höher unterstützen. #### Swift Package Manager Führen Sie zur Installation des SDK die folgenden Schritte aus: 1. Wählen Sie in Xcode **Datei** > **Add Package Dependencies** (Paketabhängigkeiten hinzufügen) aus und geben Sie als Repository-URL `https://github.com/stripe/stripe-ios-spm` ein. 1. Wählen auf unserer [Veröffentlichungsseite](https://github.com/stripe/stripe-ios/releases) die neueste Version aus. 1. Fügen Sie das Produkt **StripeFinancialConnections** zum [Ziel Ihrer App](https://developer.apple.com/documentation/swift_packages/adding_package_dependencies_to_your_app) hinzu. #### CocoaPods 1. Falls noch nicht geschehen, installieren Sie bitte die aktuellste Version von [CocoaPods](https://guides.cocoapods.org/using/getting-started.html). 1. Wenn Sie keine bestehende [Podfile](https://guides.cocoapods.org/syntax/podfile.html) haben, führen Sie folgenden Befehl aus, um eine zu erstellen: ```bash pod init ``` 1. Fügen Sie folgende Zeile in Ihre `Podfile` ein: ```podfile pod 'StripeFinancialConnections' ``` 1. Führen Sie folgenden Befehl aus: ```bash pod install ``` 1. Vergessen Sie nicht, ab jetzt in Zukunft anstelle der Datei `.xcodeproj` die Datei `.xcworkspace` zum Öffnen Ihres Projekts in Xcode zu verwenden. 1. Führen Sie für zukünftige Updates auf die jeweils aktuelle Version des SDK Folgendes aus: ```bash pod update StripeFinancialConnections ``` #### Carthage 1. Falls noch nicht geschehen, installieren Sie bitte die aktuelle Version von [Carthage](https://github.com/Carthage/Carthage#installing-carthage). 1. Fügen Sie folgende Zeile in Ihre `Cartfile` ein: ```cartfile github "stripe/stripe-ios" ``` 1. Befolgen Sie die [Carthage-Installationsanweisungen](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos). Vergewissern Sie sich, dass Sie alle [hier](https://github.com/stripe/stripe-ios/tree/master/StripeFinancialConnections/README.md#manual-linking) aufgeführten erforderlichen Frameworks einbetten. 1. Führen Sie für zukünftige Updates auf die aktuelle Version unseres SDK einfach folgenden Befehl aus: ```bash carthage update stripe-ios --platform ios ``` #### Manuelles Framework 1. Gehen Sie auf unsere [GitHub-Release-Seite](https://github.com/stripe/stripe-ios/releases/latest), laden Sie **Stripe.xcframework.zip** herunter und entpacken Sie die Datei. 1. Ziehen Sie **StripeFinancialConnections.xcframework** in den Abschnitt **Embedded Binaries** (Eingebettete Binärdateien) der Einstellungen unter **General** (Allgemeines) Ihres Xcode-Projekts. Aktivieren Sie dabei die Option **Copy items if needed** (Elemente kopieren, falls nötig). 1. Wiederholen Sie Schritt 2 für alle [hier](https://github.com/stripe/stripe-ios/tree/master/StripeFinancialConnections/README.md#manual-linking) aufgeführten erforderlichen Frameworks. 1. Wiederholen Sie für zukünftige Updates auf die jeweils aktuelle Version des SDK die Schritte 1–3. > Details zur aktuellen SDK-Version und zu vorherigen Versionen finden Sie auf der Seite [Releases](https://github.com/stripe/stripe-ios/releases) auf GitHub. Um bei Veröffentlichung einer neuen Version eine Benachrichtigung zu erhalten, [achten Sie auf die Releases zum jeweiligen Repository](https://help.github.com/en/articles/watching-and-unwatching-releases-for-a-repository#watching-releases-for-a-repository). ## Rückgabe-URL einrichten (Client-side) Der Kunde/Die Kundin verlässt ggf. Ihre App, um sich zu authentifizieren (z. B. in Safari oder einer Banking-App). Damit sie nach der Authentifizierung automatisch zu Ihrer App zurückkehren können, [konfigurieren Sie ein benutzerdefiniertes URL-Schema](https://developer.apple.com/documentation/xcode/defining-a-custom-url-scheme-for-your-app) und richten Sie Ihren App-Delegate so ein, dass die URL an das SDK weitergeleitet wird. Stripe unterstützt keine [universellen Links](https://developer.apple.com/documentation/xcode/allowing-apps-and-websites-to-link-to-your-content). #### SceneDelegate #### Swift ```swift // This method handles opening custom URL schemes (for example, "your-app://stripe-redirect") func scene(_ scene: UIScene, openURLContexts URLContexts: Set) { guard let url = URLContexts.first?.url else { return } let stripeHandled = StripeAPI.handleURLCallback(with: url) if (!stripeHandled) { // This was not a Stripe url – handle the URL normally as you would } } ``` #### AppDelegate #### Swift ```swift // This method handles opening custom URL schemes (for example, "your-app://stripe-redirect") func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool { let stripeHandled = StripeAPI.handleURLCallback(with: url) if (stripeHandled) { return true } else { // This was not a Stripe url – handle the URL normally as you would } return false } ``` #### SwiftUI #### Swift ```swift @main struct MyApp: App { var body: some Scene { WindowGroup { Text("Hello, world!").onOpenURL { incomingURL in let stripeHandled = StripeAPI.handleURLCallback(with: incomingURL) if (!stripeHandled) { // This was not a Stripe url – handle the URL normally as you would } } } } } ``` ## Angaben zu Zahlungsmethoden erfassen (Client-side) Verwenden Sie die Klassenfunktion `collectUSBankAccountParams` in `STPCollectBankAccountParams`, um die Parameter zu erstellen, die zum Aufrufen von `collectBankAccountForSetup` erforderlich sind. Sie müssen den vollständigen Nutzernamen Ihres verbundenen Kontos angeben, um eine ACH-Lastschrift-`Zahlungsmethode` zu erfassen. Erstellen Sie eine Instanz von `BankAccountCollector`, um `collectBankAccountForSetup` aufzurufen und Bankkontodaten zu erfassen, eine `PaymentMethod` zu erstellen und diese `PaymentMethod` dem `SetupIntent` hinzuzufügen. Übergeben Sie das `client_secret` des `SetupIntent`, Ihre Rückgabe-URL und die `STPCollectBankAccountParams`-Parameter an `collectBankAccountForSetup`. #### Swift ```swift // Build params let collectParams = STPCollectBankAccountParams.collectUSBankAccountParams(with: name, email: email) // Calling this method displays a dialog for collecting bank account information let bankAccountCollector = STPBankAccountCollector() bankAccountCollector.collectBankAccountForSetup(clientSecret: clientSecret, returnURL: "your-app://stripe-redirect", params: collectParams, from: self) { intent, error in guard let intent = intent else { // handle error return } if case .requiresPaymentMethod = intent.status { // Customer canceled the Financial Connections dialog. Present them with other // payment method type options. } else if case .requiresConfirmation = intent.status { // We collected an account - possibly instantly verified, but possibly // manually-entered. let setupIntentParams = STPSetupIntentConfirmParams(clientSecret: clientSecret, paymentMethodType: .USBankAccount) // Confirm the SetupIntent STPPaymentHandler.shared().confirmSetupIntent( setupIntentParams, with: self ) { (status, intent, error) in switch status { case .failed: // Setup failed case .canceled: // Setup was canceled case .succeeded: // Setup succeeded, Payment Method attached to the Customer // Your logic to create a payout account could go here @unknown default: fatalError() } } } } ``` Dadurch wird der [Authentifizierungsablauf](https://docs.stripe.com/financial-connections/fundamentals.md#authentication-flow) geladen, ein Dialog, das Ihren verbundenen Konten Informationen darüber bereitstellt, welche Daten sie freigeben werden, ihnen ermöglicht, ihr Finanzinstitut zu finden und auszuwählen, und ihnen erlaubt, sich sicher bei ihrem Konto anzumelden, um den Zugriff zu verifizieren. Die Funktion `collectBankAccountForSetupWithClientSecret` wird entweder mit dem `SetupIntent` oder mit einem Fehler abgeschlossen. Wird sie mit einem `SetupIntent` abgeschlossen und der Status ist `requires_confirmation`, bestätigen Sie den `SetupIntent` durch Aufruf von `confirmSetupIntent` für die gemeinsam genutzte `STPPaymentHandler`-Instanz. `confirmSetupIntent` wird mit den gleichen Parametern wie `collectBankAccountForSetupWithClientSecret` abgeschlossen. Nach erfolgreicher Bestätigung erhält der `SetupIntent` den Status `succeeded`. Dies bedeutet, dass Sie die `payment_method` des `SetupIntent` verwenden können, um ein Bankkonto-Token auf Ihrem Server zu erstellen. Standardmäßig können Ihre verbundenen Konten im Authentifizierungsablauf nur ein Girokonto oder Sparkonto hinzufügen, da Stripe nur Auszahlungen auf ein ACH-fähiges Konto ermöglichen kann. Die manuelle Eingabe der Kontonummer und der Routingnummer ist ebenfalls möglich, wenn Ihr verbundenes Konto die Bank nicht finden oder das Konto nicht authentifizieren kann. Der Ablauf bei einer manuellen Eingabe könnte wie folgt aussehen: ![Authentifizierungsablauf mit Ausweichlösung für manuelle Eingabe](https://b.stripecdn.com/docs-statics-srv/assets/manual_fallback.c910f590ec792b6133bb88947332604c.png) Wenn Sie verhindern möchten, dass Ihre Nutzer/innen ihre Bankkontodaten manuell eingeben, übergeben Sie beim Erstellen des `SetupIntent` `payment_method_options[us_bank_account][verification_method]=instant`. ### Externes Konto erstellen, das Sie für Auszahlungen verwenden können (Server-side) Nachdem Sie den SetupIntent bestätigt haben, verwenden Sie die angehängte Zahlungsmethode, um ein Bankkonto-Token zu erstellen. Verwenden Sie das Token dann, um ein externes Auszahlungskonto zu erstellen. Erstellen Sie zuerst ein Bankkonto-Token. ```curl curl https://api.stripe.com/v1/tokens \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "bank_account[payment_method]={{PAYMENTMETHOD_ID}}" \ -d "customer={{CUSTOMER_ID}}" ``` Verwenden Sie dann die ID des Tokens, um ein externes Auszahlungskonto zu erstellen. ```curl curl https://api.stripe.com/v1/accounts/{{ACCOUNT_ID}} \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "external_account={{TOKEN_ID}}" ``` Wenn Sie ein externes Konto angeben, wird dieses als neues externes Standardkonto für die entsprechende Währung festgelegt, und das alte Standardkonto (falls vorhanden) wird gelöscht. Sie können jetzt Auszahlungen an Ihr verbundenes Konto senden. Weitere Informationen zum Erstellen und Verwalten eines externen Kontos für Auszahlungen finden Sie unter [Erstellen eines externen Bankkontos](https://docs.stripe.com/api/external_account_bank_accounts/create.md). ### Daten von einem Financial Connections-Konto abrufen (Server-side) Sie können ermitteln, ob Ihr/e Nutzer/in über ein verknüpftes Financial Connections-Konto verfügt, indem der SetupIntent mit der erweiterten Eigenschaft `payment_method` abgerufen wird. ```curl curl -G https://api.stripe.com/v1/setup_intents/{{SETUP_INTENT_ID}} \ -u "<>:" \ -d "expand[]=payment_method" ``` Dadurch wird eine API-Antwort ähnlich der folgenden zurückgegeben: ```javascript { "id": "{{SETUP_INTENT_ID}}", "object": "setup_intent", // ... "payment_method": { "id": "{{PAYMENT_METHOD_ID}}", "object": "payment_method", // ... "type": "us_bank_account", "us_bank_account": { // ... // the value of "financial_connections_account" may be null "financial_connections_account": "{{FINANCIAL_CONNECTIONS_ACCOUNT_ID}}", // ... } }, // ... } ``` Wenn das `us_bank_account`-Objekt des `payment_method`-Objekts für den SetupIntent die Eigenschaft `financial_connections_account` enthält, verfügt der/die Nutzer/in über ein verknüpftes Financial Connections-Konto. Sie können den Wert `financial_connections_account` verwenden, um auf die Daten, die Sie im Parameter `payment_method_options[us_bank_account][financial_connections][permissions]` des SetupIntent angegeben haben, zuzugreifen oder sie zu aktualisieren. Um die Privatsphäre der Daten Ihrer Nutzer/innen zu schützen, sind die Kontodaten, auf die Sie zugreifen können, auf die Daten beschränkt, die Sie in diesem Parameter angegeben haben. Beachten Sie die Leitfäden für [Salden](https://docs.stripe.com/financial-connections/balances.md), [Inhaberschaft](https://docs.stripe.com/financial-connections/ownership.md) und Daten zu [Transaktionen](https://docs.stripe.com/financial-connections/transactions.md), um mit dem Abrufen von Kontodaten zu beginnen. ### (Optional) Zahlungsmethode zur Verarbeitung von Zahlungen verwenden Sie können eine mit der obigen Integration erfasste PaymentMethod nicht verwenden, um Zahlungen mit PaymentIntents zu verarbeiten, da der SetupIntent nur eine `"outbound"`-Berechtigung anfordert und Sie keine Autorisierung von Ihren Nutzer/innen durch Anzeige eines [Mandats](https://docs.stripe.com/payments/ach-direct-debit/set-up-payment.md#web-collect-mandate-and-submit) erhalten haben. Wenn Sie Ihren Nutzer/innen gestatten möchten, dasselbe Konto zur Durchführung von Zahlungen und für den Erhalt von Auszahlungen zu verwenden, 1. Entfernen Sie den Parameter `flow_directions` aus dem API-Aufruf zum Erstellen eines SetupIntent. 1. Erfassen Sie ein [Mandat](https://docs.stripe.com/payments/ach-direct-debit/set-up-payment.md#web-collect-mandate-and-submit) von Ihrem/Ihrer Nutzer/in. Weitere Informationen finden Sie im [Leitfaden zu ACH-Lastschriften](https://docs.stripe.com/payments/ach-direct-debit/set-up-payment.md). Dieses Integrationsmuster löst die Verifizierung von Testeinzahlungen aus, wenn Ihr/e Nutzer/in seine/ihre Bankkontodaten mit dem Formular für die manuelle Eingabe zur Verfügung stellt. #### Android ## Zusätzliche Abhängigkeit für Financial Connections aufnehmen(Client-side) Das [Stripe Android SDK](https://github.com/stripe/stripe-android) ist Open Source und [vollständig dokumentiert](https://stripe.dev/stripe-android/). Um das SDK zu installieren, fügen Sie `financial-connections` in den Block `dependencies` Ihrer [app/build.gradle](https://developer.android.com/studio/build/dependencies)-Datei ein: #### Kotlin ```kotlin plugins { id("com.android.application") } android { ... } dependencies { // ... // Financial Connections Android SDK implementation("com.stripe:financial-connections:23.5.0") } ``` > Details zur aktuellen SDK-Version und zu vorherigen Versionen finden Sie auf der Seite [Releases](https://github.com/stripe/stripe-android/releases) auf GitHub. Um bei Veröffentlichung eines neuen Release eine Benachrichtigung zu erhalten, [beobachten Sie Veröffentlichungen für das jeweilige Repository](https://docs.github.com/en/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#configuring-your-watch-settings-for-an-individual-repository). ## Angaben zu Zahlungsmethoden erfassen (Client-side) Verwenden Sie `CollectBankAccountConfiguration.USBankAccount`, um die für den Aufruf von `presentWithSetupIntent` erforderlichen Parameter zu erstellen. Sie müssen den vollständigen Nutzernahmen Ihres verbundenen Kontos angeben, um eine ACH-Lastschrift-`Zahlungsmethode` zu erfassen. Initialisieren Sie eine CollectBankAccountLauncher-Instanz innerhalb von `onCreate` Ihrer Auszahlungsaktivität und übergeben Sie eine Methode zur Verarbeitung des Ergebnisses. Rufen Sie dann `presentWithSetupIntent` auf, um Bankkontodaten zu erfassen, eine `PaymentMethod` zu erstellen und diese `PaymentMethod` an den `SetupIntent` anzuhängen. #### Kotlin ```kotlin import androidx.appcompat.app.AppCompatActivity class PayoutActivity : AppCompatActivity() { private lateinit var setupIntentClientSecret: String private lateinit var collectBankAccountLauncher: CollectBankAccountLauncher private val paymentLauncher: PaymentLauncher = PaymentLauncher.Companion.create( this, "YOUR_PUBLISHABLE_KEY", null, ::onPaymentResult ) override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) // Create collector collectBankAccountLauncher = CollectBankAccountLauncher.create( this ) { result: CollectBankAccountResult -> when (result) { is CollectBankAccountResult.Completed -> { val intent = result.response.intent if (intent.status == StripeIntent.Status.RequiresPaymentMethod) { // Customer canceled the Financial Connections dialog. Present them with other // payment method type options. } else if (intent.status == StripeIntent.Status.RequiresConfirmation) { // We collected an account - possibly instantly verified, but possibly // manually-entered. // Confirm the SetupIntent val confirmParams = ConfirmSetupIntentParams.create( clientSecret = setupIntentClientSecret, paymentMethodType = PaymentMethod.Type.USBankAccount ) paymentLauncher.confirm(confirmParams) } } is CollectBankAccountResult.Cancelled -> { // handle cancellation } is CollectBankAccountResult.Failed -> { // handle error print("Error: ${result.error}") } } } } fun collectPayoutAccount() { // ... // Build params val collectParams: CollectBankAccountConfiguration = CollectBankAccountConfiguration.USBankAccount( name, email ) // Calling this method triggers the Financial Connections dialog to be displayed collectBankAccountLauncher.presentWithSetupIntent( publishableKey, setupIntentClientSecret, collectParams ) } private fun onPaymentResult(paymentResult: PaymentResult) { when (paymentResult) { is PaymentResult.Completed -> { // Setup succeeded, Payment Method attached to the Customer // Your logic to create a payout account could go here } is PaymentResult.Canceled -> { // handle cancel flow } is PaymentResult.Failed -> { // handle failures } } } } ``` Dadurch wird der [Authentifizierungsablauf](https://docs.stripe.com/financial-connections/fundamentals.md#authentication-flow) geladen, ein Dialog, das Ihren verbundenen Konten Informationen darüber bereitstellt, welche Daten sie freigeben werden, ihnen ermöglicht, ihr Finanzinstitut zu finden und auszuwählen, und ihnen erlaubt, sich sicher bei ihrem Konto anzumelden, um den Zugriff zu verifizieren. `CollectBankAccountLauncher` wird mit einem Ergebnisobjekt abgeschlossen, das entweder den `SetupIntent` oder einen Fehler enthält. Wenn die Funktion mit einem `SetupIntent` abgeschlossen wurde und ihr Status `"requires_confirmation"` ist, bestätigen Sie den `SetupIntent` mit der Methode `confirm` in einer `PaymentLauncher`-Instanz. Nach Abschluss ruft `confirm` eine konfigurierbare Methode mit einem [PaymentResult](https://stripe.dev/stripe-android/payments-core/com.stripe.android.payments.paymentlauncher/-payment-result/index.html?query=sealed%20class%20PaymentResult%20:%20Parcelable)-Objekt auf. Bei erfolgreicher Bestätigung ist das `PaymentResult`-Objekt ein `PaymentResult.Completed`. Dies bedeutet, dass Sie mit der `payment_method` von `SetupIntent` ein Bankkontotoken auf Ihrem Server erstellen können. Standardmäßig können Ihre verbundenen Konten im Authentifizierungsablauf nur ein Girokonto oder Sparkonto hinzufügen, da Stripe nur Auszahlungen auf ein ACH-fähiges Konto ermöglichen kann. Die manuelle Eingabe der Kontonummer und der Routingnummer ist ebenfalls möglich, wenn Ihr verbundenes Konto die Bank nicht finden oder das Konto nicht authentifizieren kann. Der Ablauf bei einer manuellen Eingabe könnte wie folgt aussehen: ![Authentifizierungsablauf mit Ausweichlösung für manuelle Eingabe](https://b.stripecdn.com/docs-statics-srv/assets/manual_fallback.c910f590ec792b6133bb88947332604c.png) Wenn Sie verhindern möchten, dass Ihre Nutzer/innen ihre Bankkontodaten manuell eingeben, übergeben Sie beim Erstellen des `SetupIntent` `payment_method_options[us_bank_account][verification_method]=instant`. ### Externes Konto erstellen, das Sie für Auszahlungen verwenden können (Server-side) Nachdem Sie den SetupIntent bestätigt haben, verwenden Sie die angehängte Zahlungsmethode, um ein Bankkonto-Token zu erstellen. Verwenden Sie das Token dann, um ein externes Auszahlungskonto zu erstellen. Erstellen Sie zuerst ein Bankkonto-Token. ```curl curl https://api.stripe.com/v1/tokens \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "bank_account[payment_method]={{PAYMENTMETHOD_ID}}" \ -d "customer={{CUSTOMER_ID}}" ``` Verwenden Sie dann die ID des Tokens, um ein externes Auszahlungskonto zu erstellen. ```curl curl https://api.stripe.com/v1/accounts/{{ACCOUNT_ID}} \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "external_account={{TOKEN_ID}}" ``` Wenn Sie ein externes Konto angeben, wird dieses als neues externes Standardkonto für die entsprechende Währung festgelegt, und das alte Standardkonto (falls vorhanden) wird gelöscht. Sie können jetzt Auszahlungen an Ihr verbundenes Konto senden. Weitere Informationen zum Erstellen und Verwalten eines externen Kontos für Auszahlungen finden Sie unter [Erstellen eines externen Bankkontos](https://docs.stripe.com/api/external_account_bank_accounts/create.md). ### Daten von einem Financial Connections-Konto abrufen (Server-side) Sie können ermitteln, ob Ihr/e Nutzer/in über ein verknüpftes Financial Connections-Konto verfügt, indem der SetupIntent mit der erweiterten Eigenschaft `payment_method` abgerufen wird. ```curl curl -G https://api.stripe.com/v1/setup_intents/{{SETUP_INTENT_ID}} \ -u "<>:" \ -d "expand[]=payment_method" ``` Dadurch wird eine API-Antwort ähnlich der folgenden zurückgegeben: ```javascript { "id": "{{SETUP_INTENT_ID}}", "object": "setup_intent", // ... "payment_method": { "id": "{{PAYMENT_METHOD_ID}}", "object": "payment_method", // ... "type": "us_bank_account", "us_bank_account": { // ... // the value of "financial_connections_account" may be null "financial_connections_account": "{{FINANCIAL_CONNECTIONS_ACCOUNT_ID}}", // ... } }, // ... } ``` Wenn das `us_bank_account`-Objekt des `payment_method`-Objekts für den SetupIntent die Eigenschaft `financial_connections_account` enthält, verfügt der/die Nutzer/in über ein verknüpftes Financial Connections-Konto. Sie können den Wert `financial_connections_account` verwenden, um auf die Daten, die Sie im Parameter `payment_method_options[us_bank_account][financial_connections][permissions]` des SetupIntent angegeben haben, zuzugreifen oder sie zu aktualisieren. Um die Privatsphäre der Daten Ihrer Nutzer/innen zu schützen, sind die Kontodaten, auf die Sie zugreifen können, auf die Daten beschränkt, die Sie in diesem Parameter angegeben haben. Beachten Sie die Leitfäden für [Salden](https://docs.stripe.com/financial-connections/balances.md), [Inhaberschaft](https://docs.stripe.com/financial-connections/ownership.md) und Daten zu [Transaktionen](https://docs.stripe.com/financial-connections/transactions.md), um mit dem Abrufen von Kontodaten zu beginnen. ### (Optional) Zahlungsmethode zur Verarbeitung von Zahlungen verwenden Sie können eine mit der obigen Integration erfasste PaymentMethod nicht verwenden, um Zahlungen mit PaymentIntents zu verarbeiten, da der SetupIntent nur eine `"outbound"`-Berechtigung anfordert und Sie keine Autorisierung von Ihren Nutzer/innen durch Anzeige eines [Mandats](https://docs.stripe.com/payments/ach-direct-debit/set-up-payment.md#web-collect-mandate-and-submit) erhalten haben. Wenn Sie Ihren Nutzer/innen gestatten möchten, dasselbe Konto zur Durchführung von Zahlungen und für den Erhalt von Auszahlungen zu verwenden, 1. Entfernen Sie den Parameter `flow_directions` aus dem API-Aufruf zum Erstellen eines SetupIntent. 1. Erfassen Sie ein [Mandat](https://docs.stripe.com/payments/ach-direct-debit/set-up-payment.md#web-collect-mandate-and-submit) von Ihrem/Ihrer Nutzer/in. Weitere Informationen finden Sie im [Leitfaden zu ACH-Lastschriften](https://docs.stripe.com/payments/ach-direct-debit/set-up-payment.md). Dieses Integrationsmuster löst die Verifizierung von Testeinzahlungen aus, wenn Ihr/e Nutzer/in seine/ihre Bankkontodaten mit dem Formular für die manuelle Eingabe zur Verfügung stellt. #### React Native ## Angaben zu Zahlungsmethoden erfassen (Client-side) Übergeben Sie das `client_secret` des `SetupIntent` und den vollständigen Nutzernamen Ihres verbundenen Kontos an `collectBankAccountForSetup`, um die Zahlungsmethode zu erfassen. ```javascript import {collectBankAccountForSetup, confirmSetup} from '@stripe/stripe-react-native'; export default function PayoutAccountCollectionButton() { // Get SetupIntent client secret, connected account user's full name, and email address. // in this example, from a custom hook. const {clientSecret, name, email} = useMyCustomState(); const handleCollectBankAccountPress = async (clientSecret) => { const {setupIntent, error} = await collectBankAccountForSetup( clientSecret, { paymentMethodType: 'USBankAccount', paymentMethodData: { billingDetails: { name, email } } }, ); if (error) { // Inform your connected account user that there was an error. } else if (setupIntent) { if (setupIntent.status === SetupIntents.Status.RequiresConfirmation) { // Your connected account user provided bank account details // Confirm the SetupIntent const {error: confirmError, setupIntent: confirmedSetupIntent} = await confirmSetup(clientSecret, { type: 'USBankAccount' }); if (confirmError) { // Unable to confirm the SetupIntent, inform your connected account user there was an error } else if (confirmedSetupIntent) { if (confirmedSetupIntent.status === SetupIntents.Status.Succeeded) { // Setup succeeded, Payment Method attached to the Customer // Your logic to create a payout account could go here } else { // Unable to confirm the SetupIntent, re-fetch the SetupIntent for details } } } else { // Connected account user didn't link an account or provide details manually } } }; return (