# Erfassen Sie ein Bankkonto, um ACH Direct Debit-Zahlungen mit Kontodaten zu verwenden Verwenden Sie Kontodaten wie Salden mit Ihrer Zahlungsintegration. Sie sind sich nicht sicher, welche Financial Connections-Integration Sie verwenden sollen? Sehen Sie sich unsere [Übersicht der Integrationsoptionen](https://docs.stripe.com/financial-connections/use-cases.md) an. Stripe bietet verschiedene Möglichkeiten, wie Sie Zahlungen per ACH Direct Debit von Ihren Nutzerinnen und Nutzern akzeptieren können. Bei all diesen Methoden ist es jedoch erforderlich, dass Sie das Nutzerkonto vorab [verifizieren](https://docs.stripe.com/payments/ach-direct-debit.md#verification), bevor Sie Abbuchungen vornehmen können. Sie können Financial Connections verwenden, um eine sofortige Verifizierung des Bankkontos zusammen mit Funktionen wie Saldo- oder Eigentumsschaftsprüfungen durchzuführen. Wenn Sie Financial Connections für Ihre ACH-Zahlungsabwicklungen verwenden, können Sie: - Reduzieren Sie die Quote fehlgeschlagener Zahlungen durch geschlossene oder inaktive Konten - Die Konversion von Zahlungen verbessern, da Nutzer/innen bei der Zahlung in Ihrer Sitzung bleiben können und diese nicht verlassen müssen, um ihre Kontonummern und Bankleitzahlen einzugeben - Entwicklungszeit sparen und müssen kein individuelles Bankkonto-Einzugsformular erstellen - Die Erfassung zusätzlicher Bankkontodaten wie Salden und Kontoinhaberschaft ermöglichen ## Before you begin Financial Connections ist die Standard-Verifizierungsmethode für alle gehosteten ACH-Zahlungsabläufe, wie Checkout oder das Payment Element. Wenn Sie einen gehosteten Ablauf verwenden, können Sie direkt zu [Zugriff auf zusätzliche Kontodaten](https://docs.stripe.com/financial-connections/ach-direct-debit-payments.md#access) gehen. Falls noch nicht geschehen, richten Sie Ihre Integration so ein, dass [ACH-Zahlungen eingezogen werden](https://docs.stripe.com/payments/ach-direct-debit/accept-a-payment.md?platform=web&ui=stripe-hosted). ## Financial Connections aktivieren Der Parameter `verification_method` steuert bei verschiedenen API-Referenzen, ob Financial Connections für die Verifizierung der Bankkonten aktiviert ist. Financial Connections mit der Ausweichoption „Testeinzahlungen“ ist die Standardeinstellung. > Bankkonten, die Ihre Kundinnen/Kunden durch manuelle Eingabe und Testeinzahlungen verknüpfen, haben keinen Zugriff auf zusätzliche Bankkontodaten wie Salden, Kontoinhaberschaft und Transaktionen. | Verifizierungsmethode | Beschreibung | | ---------------------- | --------------------------------------------------------------------------------------------------------------------- | | `automatic` (Standard) | Financial Connections mit der Option zur manuellen Eingabe von Bankkontodaten und zur Verwendung von Testeinzahlungen | | `instant` | Nur Financial Connections, ohne manuelle Eingabe und Ausweichoption für Testeinzahlungen | | `microdeposits` | Nur manuelle Eingabe und Testeinzahlungen | Diese Option ist für die folgenden APIs verfügbar: Für Unternehmen, die keine von Stripe gehostete Integration wie Payment Element, Checkout oder Hosted Invoicing verwenden, sind zusätzliche Schritte wie der Einzug von Nacha-Mandaten erforderlich. Weitere Informationen finden Sie in [diesem Abschnitt des ACH Leitfadens](https://docs.stripe.com/payments/ach-direct-debit/accept-a-payment.md?platform=web&ui=direct-api#web-collect-details). - [PaymentIntent](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-payment_method_options-us_bank_account-verification_method) - [SetupIntent](https://docs.stripe.com/api/setup_intents/create.md#create_setup_intent-payment_method_options-us_bank_account-verification_method) - [CheckoutSession](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_method_options-us_bank_account-verification_method) - [Rechnung](https://docs.stripe.com/api/invoices/create.md#create_invoice-payment_settings-payment_method_options-us_bank_account-verification_method) - [Abonnement](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-payment_settings-payment_method_options-us_bank_account-verification_method) - [Payment Element](https://docs.stripe.com/js/elements_object/create_without_intent#stripe_elements_no_intent-options-paymentMethodOptions-us_bank_account-verification_method) ## Kundin/Kunde erstellen [Recommended] Wir empfehlen Ihnen, *einen Kunden/eine Kundin* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments) mit einer jeweils zugehörigen E-Mail-Adresse und Telefonnummer zu erstellen, die Sie dann Ihrer Zahlung hinzufügen. Wenn Sie ein `Customer`-Objekt hinzufügen, können Sie später [zuvor verknüpfte Konten auflisten](https://docs.stripe.com/api/financial_connections/accounts/list.md). Durch Angabe einer E-Mail-Adresse und Telefonnummer für das `Customer`-Objekt kann Financial Connections den Authentifizierungsvorgang optimieren, indem es für eine reibungslose Anmeldung oder Registrierung auf Kundenseite sorgt, je nachdem, ob es sich um wiederkehrende [Link](https://support.stripe.com/questions/link-for-financial-connections-support-for-businesses)-Nutzer/innen handelt. ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ -d email={{CUSTOMER_EMAIL}} \ -d phone={{CUSTOMER_PHONE}} ``` ## Zugriff auf zusätzliche Kontodaten anfordern Um auf zusätzliche Kontendaten zu Financial Connections-Konten zuzugreifen, müssen Sie zunächst Ihren Antrag für Financial Connections einreichen, indem Sie ein Häkchen bei den [Financial Connections-Einstellungen im Dashboard](https://dashboard.stripe.com/settings/financial-connections) setzen. Sie können diese Seite aufrufen, nachdem Sie Financial Connections aktiviert haben. Ihre Integration bestimmt, wie Sie den Zugriff auf verschiedene Arten von Kontendaten konfigurieren. #### Dynamische Zahlungsmethoden Wenn Sie die [Funktion für dynamische Zahlungsmethoden](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md) von Stripe nutzen, um ACH Zahlungen für Anwendungsszenarien zu erfassen, die nicht mit Connect abgewickelt werden, können Sie die angeforderten Financial Connections-Daten direkt auf der Seite [ACH Dashboard-Einstellungen](https://dashboard.stripe.com/test/settings/payment_methods) konfigurieren. Bei ACH-Lastschriften müssen immer die Kontonummer und die Bankleitzahl angegeben werden – andere Datentypen sind optional. > Wir empfehlen, die Berechtigungen im Dashboard zu konfigurieren. So können Sie ändern, welche Daten Sie erfassen, ohne Änderungen am Code vornehmen zu müssen. Um die Dashboard-Konfiguration zu überschreiben, legen Sie die Berechtigungen für Financial Connections direkt in der API fest. So gehen Sie für PaymentIntents vor: ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=2000 \ -d currency=usd \ -d "customer={{CUSTOMER_ID}}" \ -d "automatic_payment_methods[enabled]=true" \ -d "payment_method_options[us_bank_account][financial_connections][permissions][]=payment_method" \ -d "payment_method_options[us_bank_account][financial_connections][permissions][]=balances" \ -d "payment_method_options[us_bank_account][financial_connections][permissions][]=ownership" \ -d "payment_method_options[us_bank_account][financial_connections][permissions][]=transactions" ``` #### Arten von Zahlungsmethoden Wenn Sie `payment_method_types` direkt in der API übergeben, müssen Sie explizit angeben, welche Datenberechtigungen von Financial Connections Sie in jedem API-Aufruf haben möchten. Für [CheckoutSession](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_method_options-us_bank_account-financial_connections-permissions) gehen Sie folgendermaßen vor: ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ --data-urlencode "success_url=https://example.com/success" \ -d "line_items[0][price]={PRICE_ID}" \ -d "line_items[0][quantity]=1" \ -d "payment_method_options[us_bank_account][financial_connections][permissions][0]=payment_method" \ -d "payment_method_options[us_bank_account][financial_connections][permissions][1]=balances" \ -d "payment_method_options[us_bank_account][financial_connections][permissions][2]=ownership" \ -d "payment_method_options[us_bank_account][financial_connections][permissions][3]=transactions" ``` ## Verwenden Sie Daten mit Ihrer ACH-Integration Nachdem Sie die Berechtigung für zusätzliche Bankkontodaten erhalten haben, z. B. Salden oder Kontoinhaberschaft, können Sie diese Daten verwenden, um die Leistung von ACH-Zahlungen zu verbessern. So können Sie beispielsweise Saldodaten verwenden, um das Risiko von Ausfällen durch unzureichende Deckung zu verringern. Beispiele finden Sie in den zugehörigen Leitfäden: - [Salden](https://docs.stripe.com/financial-connections/balances.md): Prüfen Sie den Kontostand, bevor Sie die Zahlung veranlassen, um *Ablehnungen aufgrund unzureichender Deckung* (A shorthand way of referring to the Non-sufficient Funds ACH return code R01) zu vermeiden. - [Kontoinhaberschaft](https://docs.stripe.com/financial-connections/ownership.md): Rufen Sie Kontoinhaber/innen ab und vergleichen diese mit Ihren internen Datenmodellen, um potenziellem Betrug vorzubeugen. - [Transaktionen](https://docs.stripe.com/financial-connections/transactions.md): Rufen Sie den Transaktionsverlauf eines Kontos auf, um zu erfahren, wann der Gehaltsscheck der Kundin/des Kundin voraussichtlich eingehen wird. > Die Risk Intelligence API ist eine Vorschaufunktion, die zusätzliche aggregierte Daten bereitstellt, um das Risikomanagement zu unterstützen, wie z. B. den durchschnittlichen Kontostand in den letzten 30/60/90 Tagen, die Gesamtzahl der Gutschrifttransaktionen in den letzten 30/60/90 Tagen und mehr. Wenn Sie diese Vorschaufunktion verwenden möchten, senden Sie uns eine [E-Mail](mailto:financial-connections-beta+risk-intelligence@stripe.com), um Zugriff anzufordern. ### Die ID des Financial Connections-Kontos finden Um Datenaktualisierungen zu veranlassen und Daten für ein Financial Connections Konto abzurufen, müssen Sie zunächst die Konto-ID von der verknüpften Zahlungsmethode abrufen, indem Sie die Eigenschaft `payment_method` des PaymentIntent erweitern: ```curl curl -G https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT}} \ -u "<>:" \ -d "expand[]=payment_method" ``` Die Financial Connections Konto-ID finden Sie im [Hash `us_bank_account`](https://docs.stripe.com/api/payment_methods/object.md#payment_method_object-us_bank_account) der erweiterten Zahlungsmethode. Wenn Sie eine [manuelle Eingabeoption](https://docs.stripe.com/financial-connections/ach-direct-debit-payments.md#enable) zulassen und der/die Nutzer/in seine/ihre Kontoinformationen manuell eingegeben hat, ist dieses Feld `null`. ```json { "id": "pi_3OK3g4FitzZY8Nvm11121Lhb", "object": "payment_intent", "payment_method": { "us_bank_account": {"financial_connections_account": "fca_1OK123bitUAA8SvmruWkck76" } // ... other fields on the Payment Method } // ... other fields on the Payment Intent } ```