Weiter zum Inhalt
Konto erstellen
 oder
anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellen
Anmelden
Übersicht
Produkte
Treasury

Finanzkontofunktionen

Erfahren Sie mehr über die für Finanzkonten verfügbaren Funktionen.

Sie fügen Finanzkonten Funktionen hinzu, mittels derer sie Geld zwischen Konten verschieben, Zahlungskarten anhängen können 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 und 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.

Notiz

Sie müssen die folgenden Funktionen anfordern oder aktiviert haben, bevor Sie die treasury-Funktion für verbundene Konten anfordern können:

  • transfers
  • card_payments
FunktionBeschreibungErforderliche Funktionen
card_issuingErlaubt die Erstellung eines Card-Objekts, das mit diesem Finanzkonto verknüpft ist.card_issuing
deposit_insuranceFordert FDIC-Versicherungsanspruch für das Finanzkonto an.treasury
financial_addresses.abaLö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.achErmöglicht die Erstellung von InboundTransfer-Objekten zur Finanzierung des Finanzkontos durch Belastung eines externen US-Bankkontos.treasury, us_bank_account_ach_payments
intra_stripe_flowsErmö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.achErmö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_wireErmöglicht es diesem Finanzkonto, US-Inlandsüberweisungen mit den OutboundPayment-Objekten der Stripe API zu senden.treasury
outbound_transfers.achErmö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_wireErmöglicht es diesem Finanzkonto, US-Inlandsüberweisungen mit den OutboundTransfer-Objekten der Stripe API zu senden.treasury

ACH-Abwicklung am selben Tag

Beta

Die ACH-Abwicklung am selben Tag befindet sich derzeit in der Beta 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.

Wenn Sie keinen Zugriff haben, geben API-Aufrufe, die ACH-Funktionen oder -Parameter vom selben Tag enthalten, einen Fehler zurück.

Mit den folgenden Funktionen können Finanzkonten die Funktionalität für die ACH-Abwicklung am selben Tag nutzen. Sie müssen die entsprechende *.ach-Funktion für ein Finanzkonto anfordern, um die Funktionalität nutzen zu können. Beispielsweise müssen Sie outbound_payments.ach and outbound_payments.ach.same_day für ein Finanzkonto anfordern, damit dieses OutboundPayment am selben Tag senden kann.

FunktionBeschreibungErforderliche Funktionen
outbound_payments.ach.same_daySo 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_daySo kann dieses Finanzkonto ACH Überweisungen mit OutboundTransfer-Objekten senden, die am selben Werktag im Zielkonto eintreffen.treasury, us_bank_account_ach_payments
inbound_payments.ach.same_dayErmöglicht die Erstellung von InboundTransfer-Objekten, um das Finanzkonto noch am selben Werktag aufzuladen.treasury, us_bank_account_ach_payments

Funktionen anfordern

Normalerweise fordern Sie Funktionen für Ihr Treasury-Finanzkonto an, wenn Sie das Finanzkonto erstellen. Die folgende Anforderung erstellt ein Finanzkonto und fordert im selben Aufruf Funktionen an.

Command Line
curl https://api.stripe.com/v1/treasury/financial_accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_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.

Command Line
curl https://api.stripe.com/v1/treasury/financial_accounts/
{{FINANCIAL_ACCOUNT_ID}}
/features \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_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. Der folgende API-Aufruf erstellt ein Finanzkonto und fordert die Funktionen ‘financial_addresses.aba’ und ‘card_issuing’ an.

Command Line
curl https://api.stripe.com/v1/treasury/financial_accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_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.

{
  "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.

Command Line
curl https://api.stripe.com/v1/treasury/financial_accounts/
{{FINANCIAL_ACCOUNT_ID}}
/features \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
"

Die Antwort zeigt financial_addresses.aba mit einem status von pending und status_details mit einem code von activating.

{
  "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 treasury.financial_account.features_status_updated aus.

Die folgende Anfrage ruft die FinancialAccount-Details mit erweiterten financial_addresses.aba-Details ab.

Command Line
curl https://api.stripe.com/v1/treasury/financial_accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_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.

{
  "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.

Command Line
curl https://api.stripe.com/v1/treasury/financial_accounts/
{{FINANCIAL_ACCOUNT_ID}}
/features \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "card_issuing[requested]"=false

Wenn dieser Aufruf erfolgreich ist, erhalten Sie das Features-Objekt 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.

Command Line
curl https://api.stripe.com/v1/treasury/financial_accounts/
{{FINANCIAL_ACCOUNT_ID}}
/features \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_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.
{
  "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.

StatusStatusdetails-CodeBeilegung der StatusdetailsBeschreibung
pendingactivatingDie Funktion wird derzeit von Stripe aktiviert.
pendingrequirements_pending_verificationDie Anforderungen für die zugehörige Funktion für das verbundene Konto wurden übermittelt, aber noch nicht verifiziert.
restrictedrequirements_past_dueprovide_informationFür das verbundene Konto müssen bestimmte Anforderungen erfüllt sein, bevor diese Funktion aktiviert werden können.
restrictedrejected_unsupported_businesscontact_stripeDas 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.
restrictedrejected_othercontact_stripeDieses Konto wurde aus anderen Gründen eingeschränkt. Wenn Sie weitere Informationen wünschen, senden Sie eine E-Mail an treasury-support@stripe.com.
restrictedrestricted_by_platformremove_restrictionDie Plattform hat diese Funktion mit dem Hash platform_restrictions eingeschränkt.
restrictedfinancial_account_closedDiese Funktion ist nicht verfügbar, da das Finanzkonto geschlossen ist.
restrictedrestricted_othercontact_stripeDiese Funktion ist aus anderen Gründen eingeschränkt. Wenn Sie weitere Informationen wünschen, senden Sie eine E-Mail an 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-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.

Command Line
curl https://api.stripe.com/v1/treasury/financial_accounts/
{{FINANCIAL_ACCOUNT_ID}}
 \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "platform_restrictions[outbound_flows]"=restricted

Bei Erfolg gibt die Antwort das Finanzkonto-Objekt mit dem entsprechenden Ablauf als restricted zurück.

{
  "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.

Command Line
curl https://api.stripe.com/v1/treasury/financial_accounts/
{{FINANCIAL_ACCOUNT_ID}}
/features \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_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.

{
  "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.

Notiz

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:

Funktioninbound_flowsoutbound_flows
card_issuingk.A.k.A.
deposit_insurancek.A.k.A.
financial_addresses.abaVerhindert, dass die ABA-Finanzadresse Gutschriften über ACH erhält.Verhindert Lastschriften von der ABA-Finanzadresse.
inbound_transfers.achDeaktiviert die Funktion.k.A.
intra_stripe_flowsVerhindert, 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.achk.A.Deaktiviert die Funktion.
outbound_payments.us_domestic_wirek.A.Deaktiviert die Funktion.
outbound_transfers.achk.A.Deaktiviert die Funktion.
outbound_transfers.us_domestic_wirek.A.Deaktiviert die Funktion.

Webhooks

Um eine Aktion mit Webhooks 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.

  • 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.
War diese Seite hilfreich?
JaNein
Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
Schauen Sie sich unseren Produkt-Changelog an.
Fragen? Sales-Team kontaktieren.
Unterstützt von Markdoc
Auf dieser Seite
Verfügbare Funktionen
ACH-Abwicklung am selben Tag
Funktionen anfordern
Aktivierung von Funktionen
Funktionen werden entfernt
Funktionen abrufen
Eingeschränkte Funktionen
Auswirkungen von Plattformeinschränkungen auf Funktionen
Webhooks
Verwendete Produkte
Treasury
Connect