# Finanzkontofunktionen Erfahren Sie mehr über die für Finanzkonten verfügbaren Funktionen. > #### Kompatibilität mit der Accounts v2 API > > Die Accounts v2 API unterstützt keine Treasury and Issuing-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). Sie fügen [Finanzkonten](https://docs.stripe.com/treasury/connect/account-management/financial-accounts.md)-Funktionen hinzu, die es Ihnen ermöglichen, Geld zwischen Konten zu bewegen, Zahlungskarten anzuhängen und vieles mehr. In der Regel weisen Sie die gewünschten `Feature`-Objekte während der Erstellung von `FinancialAccount`-Objekten zu, können diese aber jederzeit hinzufügen oder entfernen. Einige `Features` erfordern, dass für das mit dem Finanzkonto verknüpfte verbundene Konto, bestimmte Funktionen aktiviert sind. Dies gilt beispielsweise für die Funktion `card_issuing`. Diese muss aktiviert sein, bevor Sie `card_issuing` für das mit diesem verbundenen Konto verknüpfte Finanzkonto anfordern können. ## Verfügbare Funktionen Die folgende Tabelle führt die verfügbaren `Features` für ein `FinancialAccount` sowie die Funktionen auf, die auf dem zugehörigen verbundenen Konto aktiviert sein müssen, um sie hinzuzufügen. > Sie müssen die folgenden Funktionen anfordern oder aktiviert haben, bevor Sie die `treasury`-Funktion für verbundene Konten anfordern können: > > - `transfers` | Funktion | Beschreibung | Erforderliche Funktionen | | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | | `card_issuing` | Erlaubt die Erstellung eines [Card-Objekts](https://docs.stripe.com/api/.md#issuing_card_object), das mit diesem Finanzkonto verknüpft ist. | `card_issuing` | | `deposit_insurance` | Fordert FDIC-Versicherungsanspruch für das Finanzkonto an. | `treasury` | | `financial_addresses.aba` | Löst die Erstellung einer `FinancialAddress` vom Typ ABA aus, die mit diesem Finanzkonto verknüpft ist. Wenn diese Funktion aktiviert ist, kann die Adresse Geld über ACH oder per Überweisung empfangen, und Geld kann von externen Bankkonten abgebucht werden. | `treasury` | | `inbound_transfers.ach` | Ermöglicht die Erstellung von `InboundTransfer`-Objekten zur Finanzierung des Finanzkontos durch Belastung eines externen US-Bankkontos. | `treasury`, `us_bank_account_ach_payments` | | `intra_stripe_flows` | Ermöglicht es diesem Finanzkonto, über das `stripe`-Netzwerk Geld an andere Finanzkonten zu senden oder von diesen zu empfangen. Beide Finanzkonten (Urheber und Empfänger) müssen diese Funktion aktivieren, damit ausgehende Zahlungen im `stripe`-Netzwerk funktionieren. | `treasury` | | `outbound_payments.ach` | Ermöglicht es diesem Finanzkonto, ACH-Überweisungen mit den `OutboundPayment`-Objekten der Stripe API zu senden. | `treasury`, `us_bank_account_ach_payments` | | `outbound_payments.us_domestic_wire` | Ermöglicht es diesem Finanzkonto, US-Inlandsüberweisungen mit den `OutboundPayment`-Objekten der Stripe API zu senden. | `treasury` | | `outbound_transfers.ach` | Ermöglicht es diesem Finanzkonto, ACH-Überweisungen mit den `OutboundTransfer`-Objekten der Stripe API zu senden. | `treasury`, `us_bank_account_ach_payments` | | `outbound_transfers.us_domestic_wire` | Ermöglicht es diesem Finanzkonto, US-Inlandsüberweisungen mit den `OutboundTransfer`-Objekten der Stripe API zu senden. | `treasury` | ### ACH-Abwicklung am selben Tag > Die ACH-Abwicklung am selben Tag befindet sich derzeit in der Vorschau und hat nur eine begrenzte Verfügbarkeit. Geeignete Nutzer/innen werden von Stripe überprüft und genehmigt. Um Zugriff anzufordern, senden Sie eine E-Mail an [treasury-support@stripe.com](mailto:treasury-support@stripe.com). > > Wenn Sie keinen Zugriff haben, geben API-Aufrufe, die ACH-Funktionen oder -Parameter vom selben Tag enthalten, einen Fehler zurück. Die folgenden Funktionen ermöglichen es Finanzkonten, taggleiche ACH-Funktionalität zu verwenden. Sie müssen die entsprechende Funktion `*.ach` für ein Finanzkonto anfordern, um sie zu verwenden. Beispiel: Wenn Sie möchten, dass ein Finanzkonto eine [OutboundPayment](https://docs.stripe.com/treasury/connect/moving-money/out-of/outbound-payments.md) innerhalb eines Tages sendet, müssen Sie `outbound_payments.ach` und`outbound_payments.ach.same_day` auf diesem Finanzkonto anfordern: | | | | | Funktion | Beschreibung | Erforderliche Funktionen | | `outbound_payments.ach.same_day` | So kann dieses Finanzkonto ACH Überweisungen mit `OutboundPayment`-Objekten senden, die am selben Werktag im Zielkonto eintreffen. | `treasury`, `us_bank_account_ach_payments` | | `outbound_transfers.ach.same_day` | So kann dieses Finanzkonto ACH Überweisungen mit `OutboundTransfer`-Objekten senden, die am selben Werktag im Zielkonto eintreffen. | `treasury`, `us_bank_account_ach_payments` | | `inbound_transfers.ach.same_day` | Ermöglicht die Erstellung von `InboundTransfer`-Objekten, um das Finanzkonto noch am selben Werktag aufzuladen. | `treasury`, `us_bank_account_ach_payments` | ## Funktionen anfordern In der Regel fordern Sie Funktionen für Ihr Finanzkonto an, wenn Sie [das Finanzkonto erstellen](https://docs.stripe.com/treasury/connect/account-management/financial-accounts.md#create-a-financialaccount). Die folgende Anfrage erstellt ein Finanzkonto und fordert im selben Aufruf Funktionen an. ```curl curl https://api.stripe.com/v1/treasury/financial_accounts \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "supported_currencies[]=usd" \ -d "features[card_issuing][requested]=true" \ -d "features[financial_addresses][aba][requested]=true" ``` Wenn Sie mit bestehenden Finanzkonten arbeiten, verwenden Sie `POST /v1/treasury/financial_accounts/{{FINANCIAL_ACCOUNT_ID}}/features`, um zusätzliche Funktionen anzufordern. ```curl curl https://api.stripe.com/v1/treasury/financial_accounts/{{TREASURYFINANCIALACCOUNT_ID}}/features \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "card_issuing[requested]=true" \ -d "deposit_insurance[requested]=true" \ -d "financial_addresses[aba][requested]=true" \ -d "inbound_transfers[ach][requested]=true" \ -d "intra_stripe_flows[requested]=true" \ -d "outbound_payments[ach][requested]=true" \ -d "outbound_payments[us_domestic_wire][requested]=true" \ -d "outbound_transfers[ach][requested]=true" \ -d "outbound_transfers[us_domestic_wire][requested]=true" ``` ### Aktivierung von Funktionen Nachdem Sie eine Funktion angefordert und alle Verifizierungsanforderungen für das Onboarding des verbundenen Kontos auf Ihre Plattform erfüllt haben, wird die Funktion aktiviert. Bei einigen Funktionen kann die Aktivierung sofort erfolgen (zum Beispiel `card_issuing` ). Andere Funktionen, wie `financial_addresses.aba` werden hingegen [asynchron aktiviert](https://docs.stripe.com/treasury/connect/account-management/financial-account-features.md#webhooks). Der folgende API-Aufruf erstellt ein Finanzkonto und fordert die Funktionen ‘financial_addresses.aba’ und ‘card_issuing’ an. ```curl curl https://api.stripe.com/v1/treasury/financial_accounts \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "supported_currencies[]=usd" \ -d "features[financial_addresses][aba][requested]=true" \ -d "features[card_issuing][requested]=true" ``` Wenn Sie Funktionen bei der Finanzkontoerstellung anfordern, zeigt die Antwort deren Status in den Eigenschaften `active_features`, `pending_features` und `restricted_features` an. Weitere Informationen finden Sie im Abschnitt [Funktionen abrufen](https://docs.stripe.com/treasury/connect/account-management/financial-account-features.md#retrieving-features). ```json { "object": "treasury.financial_account", "created": 1612927106, "id": "fa_123", "country": "US", "supported_currencies": ["usd"],"active_features": ["card_issuing"], "pending_features": ["financial_addresses.aba"], "restricted_features": [], // No FinancialAddress added as the financial_addresses.aba feature is not yet active "financial_addresses": [], "livemode": true, "status": "open", ... } ``` Sie können Funktionen für das im vorherigen Beispiel erstellte Finanzkonto mithilfe von `GET /v1/treasury/financial_accounts/{{FINANCIAL_ACCOUNT_ID}}/features` abrufen. ```curl curl https://api.stripe.com/v1/treasury/financial_accounts/{{TREASURYFINANCIALACCOUNT_ID}}/features \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" ``` Die Antwort zeigt `financial_addresses.aba` mit einem `status` von `pending` und `status_details` mit einem `code` von `activating`. ```json { "object": "treasury.financial_account_features","financial_addresses": { "aba": { "requested": true, "status": "pending", "status_details": [ { "code": "activating" } ] } }, "card_issuing": { "requested": true, "status": "active", "status_details": [] }, ... } ``` Eine Funktion kann bis zu 30 Minuten in diesem Status verbleiben, während Stripe mit externen Systemen kommuniziert. Wenn die Funktion `financial_addresses.aba` aktiviert ist, empfängt das Finanzkonto ein `FinancialAddress`-Objekt und löst den [Webhook](https://docs.stripe.com/webhooks.md) `treasury.financial_account.features_status_updated` aus. Die folgende Anfrage ruft die `FinancialAccount`-Details mit erweiterten `financial_addresses.aba`-Details ab. ```curl curl https://api.stripe.com/v1/treasury/financial_accounts \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "expand[]=financial_addresses.aba.account_number" \ -d "supported_currencies[]=usd" ``` Die Antwort enthält die Kontodetails, einschließlich der vollständigen finanziellen Adressangaben. ```json { "object": "treasury.financial_account", "id": "{{FINANCIAL_ACCOUNT_ID}}", "country": "US", "supported_currencies": ["usd"], "active_features": ["card_issuing", "financial_addresses.aba"], "pending_features": [], "restricted_features": [], "financial_addresses": [ { "type": "aba", "supported_networks": ["ach", "domestic_wire_us"], "aba": { "account_number_last4": "7890", "account_number": "1234567890", "routing_number": "000000001", "bank_name": "Goldman Sachs" } } ], "livemode": true, ... } ``` Das Finanzkonto kann jetzt Gutschriften oder Lastschriften für diese ABA-Finanzadresse empfangen. ## Funktionen werden entfernt Um eine Funktion zu entfernen, verwenden Sie `POST /v1/treasury/financial_accounts/{{FINANCIALACCOUNT_ID}}/features` und setzen den Wert der Funktion auf `false`. ```curl curl https://api.stripe.com/v1/treasury/financial_accounts/{{TREASURYFINANCIALACCOUNT_ID}}/features \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "card_issuing[requested]=false" ``` Wenn dieser Aufruf erfolgreich ist, erhalten Sie das [`Features`-Objekt](https://docs.stripe.com/api/treasury/financial_account_features.md) als Antwort mit der Funktion, die Sie aus dem Objekt entfernt haben. ## Funktionen abrufen Um die Funktionen eines Finanzkontos abzurufen, verwenden Sie `GET /v1/treasury/financial_accounts/{{FINANCIAL_ACCOUNT_ID}}/features`. ```curl curl https://api.stripe.com/v1/treasury/financial_accounts/{{TREASURYFINANCIALACCOUNT_ID}}/features \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" ``` Die JSON-Antwort stellt die Funktionsdetails bereit, die durch drei Eigenschaften definiert sind: - `requested`: Gibt an, ob die Funktion angefordert wurde. - `status`: Beschreibt den aktuellen Status der Funktion: `active`, `pending` oder `restricted`. - `status_details`: Ein Array von Hashes, die einen Code und eine Auflösung enthalten. ```json { "card_issuing": { "requested": true, "status": "active", "status_details": [] }, "deposit_insurance": { "requested": true, "status": "restricted", "status_details": [ { "code": "requirements_past_due", "resolution": "provide_information" } ] } } ``` Die folgende Tabelle zeigt die möglichen Kombinationen aus `status` und `status_details`. | Status | Statusdetails-Code | Beilegung der Statusdetails | Beschreibung | | ------------ | ----------------------------------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `pending` | `activating` | | Die Funktion wird derzeit von Stripe aktiviert. | | `pending` | `requirements_pending_verification` | | Die Anforderungen für die zugehörige Funktion für das verbundene Konto wurden übermittelt, aber noch nicht verifiziert. | | `restricted` | `requirements_past_due` | `provide_information` | Für das verbundene Konto müssen bestimmte Anforderungen erfüllt sein, bevor diese Funktion aktiviert werden können. | | `restricted` | `rejected_unsupported_business` | `contact_stripe` | Das Konto wurde abgelehnt, da diese Art von Unternehmen derzeit nicht unterstützt wird. Wenn Sie weitere Informationen wünschen, senden Sie eine E-Mail an [treasury-support@stripe.com](mailto:treasury-support@stripe.com). | | `restricted` | `rejected_other` | `contact_stripe` | Dieses Konto wurde aus anderen Gründen eingeschränkt. Wenn Sie weitere Informationen wünschen, senden Sie eine E-Mail an [treasury-support@stripe.com](mailto:treasury-support@stripe.com). | | `restricted` | `restricted_by_platform` | `remove_restriction` | Die Plattform hat diese Funktion mit dem Hash [platform_restrictions](https://docs.stripe.com/api/treasury/financial_accounts/object.md#financial_account_object-platform_restrictions) eingeschränkt. | | `restricted` | `financial_account_closed` | | Diese Funktion ist nicht verfügbar, da das Finanzkonto geschlossen ist. | | `restricted` | `restricted_other` | `contact_stripe` | Diese Funktion ist aus anderen Gründen eingeschränkt. Wenn Sie weitere Informationen wünschen, senden Sie eine E-Mail an [treasury-support@stripe.com](mailto:treasury-support@stripe.com). | ## Eingeschränkte Funktionen Sie können Geldübertragungen auf Finanzkonten auf Ihrer Plattform einschränken, um eingehende Geldübertragungen (`inbound_flows`), ausgehende Geldübertragungen (`outbound_flows`) oder beide Arten von Geldübertragungen unter Verwendung des [platform_restrictions](https://docs.stripe.com/api/treasury/financial_accounts/object.md#financial_account_object-platform_restrictions)-Hashs zu unterbinden. Wird ein Ablauf eingeschränkt, wirkt sich dies auf die Funktionen des Finanzkontos aus, die ganz oder teilweise auf diesen Ablauf angewiesen sind. Um beispielsweise zu verhindern, dass Geld von einem Finanzkonto abgebucht wird, rufen Sie `POST /v1/treasury/financial_accounts/{{FINANCIALACCOUNT_ID}}` auf. ```curl curl https://api.stripe.com/v1/treasury/financial_accounts/{{TREASURYFINANCIALACCOUNT_ID}} \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "platform_restrictions[outbound_flows]=restricted" ``` Bei Erfolg gibt die Antwort das Finanzkonto-Objekt mit dem entsprechenden Ablauf als `restricted` zurück. ```json { "object": "treasury.financial_account", "id": "{{FINANCIAL_ACCOUNT_ID}}", "status": "open", ... "platform_restrictions": { "inbound_flows": "unrestricted","outbound_flows": "restricted" }, "active_features": ["card_issuing", "deposit_insurance", "inbound_transfers.ach"], "pending_features": [], "restricted_features": ["financial_addresses.aba", "intra_stripe_flows", "outbound_payments.ach", "outbound_payments.us_domestic_wire", "outbound_transfers.ach", "outbound_transfers.us_domestic_wire"] } ``` Wie die vorherige Antwort zeigt, werden beim Einschränken von `outbound_flows` für das FinancialAccount `financial_addresses.aba`, `intra_stripe_flows` und `inbound_transfers.ach` zum Array `restricted_features` hinzugefügt. Funktionen im Array `restricted_features` sind möglicherweise vollständig oder nur teilweise eingeschränkt. `financial_addresses.aba` ist beispielsweise Teil des Arrays `restricted_features` in der vorherigen Antwort, da die Einschränkung von `outbound_flows` Abbuchungen an der Finanzadresse verhindert. Diese Finanzadresse kann jedoch weiterhin ACH oder Banküberweisungen empfangen, da `inbound_flows` nicht eingeschränkt sind. Ebenso ist die Funktion `intra_stripe_flows` eingeschränkt, da die Einschränkung `outbound_flows` die Verwendung dieses Finanzkontos als Quelle einer ausgehenden Zahlung an ein anderes Finanzkonto verhindert. Das Finanzkonto kann jedoch weiterhin das Ziel einer ausgehenden Zahlung sein, sodass die Funktion nicht vollständig eingeschränkt ist. Die folgende Anfrage ruft Funktionsdetails für ein Finanzkonto mit eingeschränkten Abläufen ab. ```curl curl https://api.stripe.com/v1/treasury/financial_accounts/{{TREASURYFINANCIALACCOUNT_ID}}/features \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" ``` Die Antwort stellt das `Feature`-Objekt bereit, welches `status_details` mit dem Code `restricted_by_platform` enthält. Die Eigenschaft `restriction` enthält einen Verweis auf die angewendete `platform_restriction`. ```json { "object": "treasury.financial_account_features", "financial_addresses": { "aba": { "requested": true, "status": "restricted", "status_details": [ { "code": "restricted_by_platform", "resolution": "remove_restriction", "restriction": "inbound_flows" } ] } }, ... } ``` In der folgenden Tabelle wird beschrieben, wie sich `platform_restrictions` auf Funktionen auswirken. > Durch die Einschränkungen eingehender Zahlungsabläufe für die Funktion `financial_addresses.aba` werden eingehende Überweisungen nicht blockiert. ### Auswirkungen von Plattformeinschränkungen auf Funktionen Die folgende Tabelle zeigt die Auswirkungen der Plattformeinschränkungen von `inbound_flows` und `outbound_flows` auf einzelne Funktionen: | Funktion | inbound_flows | outbound_flows | | ------------------------------------- | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | | `card_issuing` | k.A. | k.A. | | `deposit_insurance` | k.A. | k.A. | | `financial_addresses.aba` | Verhindert, dass die ABA-Finanzadresse Gutschriften über ACH erhält. | Verhindert Lastschriften von der ABA-Finanzadresse. | | `inbound_transfers.ach` | Deaktiviert die Funktion. | k.A. | | `intra_stripe_flows` | Verhindert, dass das Finanzkonto ausgehende Zahlungen von anderen Finanzkonten erhält. | Von diesem Finanzkonto können keine ausgehenden Zahlungen an andere Finanzkonten vorgenommen werden. | | `outbound_payments.ach` | k.A. | Deaktiviert die Funktion. | | `outbound_payments.us_domestic_wire` | k.A. | Deaktiviert die Funktion. | | `outbound_transfers.ach` | k.A. | Deaktiviert die Funktion. | | `outbound_transfers.us_domestic_wire` | k.A. | Deaktiviert die Funktion. | Wenn die Funktion `financial_address.aba` während der Finanzkonto-Erstellung eingeschränkt ist, wird keine Finanzadresse erstellt, bis die Einschränkung aufgehoben wird. Weitere Informationen finden Sie unter[Verfügbare Funktionen](https://docs.stripe.com/treasury/connect/account-management/financial-account-features.md#available-features). ### Eingeschränkte Funktionen von Stripe Manchmal werden Funktionen von Stripe eingeschränkt, wenn wir ein höheres Betrugsrisiko feststellen. Die Antwort, wenn Sie eine dieser Funktionen abrufen, könnte so aussehen: ```json { "object": "treasury.financial_account_features", "financial_addresses": { "aba": { "requested": true, "status": "restricted", "status_details": [ { "code": "restricted_other", "resolution": "contact_stripe" } ] } }, ... } ``` Um die Interventionen von Stripe in diesen Fällen selbst zu überschreiben, können Sie zum Connect-Dashboard gehen und die folgenden Schritte ausführen: 1. Gehen Sie zur Kontodetailsseite des betroffenen verbundenen Kontos. 1. Navigieren Sie zum eingeschränkten Finanzkonto. 1. Suchen Sie die Funktion, die Sie wieder freischalten möchten und klicken Sie auf **Aktivieren**. Dies hebt die Einschränkung der Funktion für alle Finanzkontos des Kontos auf. ## Webhooks Um eine Aktion mit [Webhooks](https://docs.stripe.com/webhooks.md) durchzuführen, wenn eine oder mehrere Funktionen einen bestimmten Status erreicht haben, vergleichen Sie Ihren lokalen Status mit dem neuesten Status der Funktion. Während die Eigenschaft `previous_attributes` des Webhooks `treasury.financial_account.features_status_updated` auch angibt, welche Funktionen sich von einem Status zu einem anderen geändert haben, handelt es sich bei Ereignissen möglicherweise um Duplikate oder sie gehen in der falschen Reihenfolge ein. Weitere Informationen finden Sie in den [Best Practices für Webhooks](https://docs.stripe.com/webhooks.md#best-practices). - `account.updated` - Bei der Anforderung neuer Funktionen erhält die Plattform möglicherweise einen Webhook `account.updated`, der Sie darüber informiert, dass sich der `requirements`-Hash geändert hat und jetzt Felder zu `pending_verification` hinzugefügt wurden. - `treasury.financial_account.features_status_updated` - Weist darauf hin, dass eine oder mehr Funktionen ihren Status geändert haben. Dies wird in den Änderungen an den Arrays `active_features`, `pending_features` oder `restricted_features` widergespiegelt.