Integration mit Fifth Third BankBeta

Stripe arbeitet mit mehreren Partnerbanken zusammen, um sein Globales Zahlungs- und Finanznetzwerk (GPTN) zu unterstützen. Wir haben Fifth Third Bank als neuen Bankpartner für das Stripe-Produkt Treasury hinzugefügt.

Wenn Sie Stripe Treasury bereits verwenden, wird in diesem Leitfaden beschrieben, wie Sie mit Fifth Third Bank in Ihrer bestehenden Integration beginnen. Sie können verbundene Konten erstellen und pflegen, die sowohl bei Evolve als auch bei Fifth Third Bank über Finanzkonten verfügen. Bis Ende Oktober 2024 wird Stripe Treasury die Treasury-Funktion für beide Partnerbanken auf gleichem Niveau unterstützen. Sie können mithilfe dieses Leitfadens selbst festlegen, ob und wie Sie die Fifth Third Bank-Funktionen für Ihre Nutzer/innen einführen.

Wenn Sie Treasury zum ersten Mal nutzen, lesen Sie Erste Schritte bei einer neuen Treasury-Integration mit Fifth Third Bank.

Kontenstruktur in Stripe Treasury

Die Grundstruktur für Treasury-Konten bleibt unverändert. Sie können Connect weiterhin verwenden, um Ihr bestehendes Plattformkonto zusammen mit einem verbundenen Konto für jede Ihrer Nutzer/innen zu verwalten. Da jedes verbundene Konto eine/n Nutzer/in darstellt, ist es mit den KYC- und Compliance-Informationen dieser Nutzerin/dieses Nutzers verknüpft. Wenn Sie zusätzliche Stripe-Produkte für jedes Ihrer verbundenen Konten aktivieren (z. B. Zahlungen mit zusätzlichen Zahlungsmethoden, Treasury oder Issuing), können Sie die Informationen dieses Nutzers/dieser Nutzerin wiederverwenden, ohne sie erneut erfassen zu müssen.

Jedes verbundene Konto kann ein oder mehrere Treasury-Finanzkonten erstellen und pflegen, von denen jedes ein Konto darstellt, das bei der FDIC versichert werden kann. Treasury-Finanzkonten werden jeweils mit einer Partnerbank erstellt (in der Vergangenheit mit Evolve und jetzt auch mit der Möglichkeit zur Nutzung von Fifth Third Bank). Jedes verbundene Konto kann bei unseren Bankpartnern bis zu drei Finanzkonten haben. Wenn für Sie individuell ein höheres Limit genehmigt wurde, können dies auch mehr Konten sein. Wenn Sie aufgrund Ihrer Unternehmensstruktur mehr Konten benötigen, wenden Sie sich an Ihre/n Vertriebsmitarbeiter/in oder senden Sie uns eine E-Mail.

Jedes Finanzkonto bei Evolve und Fifth Third Bank kann Gelder aus dem Connect-Zahlungssaldo erhalten und Gelder von und zu anderen Finanzkonten und externen Bankkonten überweisen.

Sie können die gleichen APIs mit Ihrem Finanzkonto bei Fifth Third verwenden wie die, die Sie mit Ihren Evolve-Finanzkonten nutzen. Die APIs verhalten sich bis auf einige wesentliche Unterschiede gleich:

1. Für OutboundTransfers, die per Banküberweisung oder ACH-Überweisung von einem Finanzkonto bei Fifth Third gesendet werden, gilt eine spätere Annahmefrist als bei Übertragungen, die mit Evolve gesendet werden.
2. Stripe Payouts, die aus dem Zahlungsguthaben gesendet werden, gehen schneller bei einem Finanzkonto bei Fifth Third ein als Auszahlungen auf ein externes Bankkonto oder ein Evolve-Finanzkonto.
3. Sie können eine neue Funktion, treasury_fifth_third, verwenden, um die Compliance für Ihre verbundenen Konten zu verwalten.

Es könnte weitere kurzfristige Unterschiede geben, während wir Fifth Third Bank auf das Niveau von Evolve bringen, wie zum Beispiel ein vorläufiges Limit für Beträge empfangener Abbuchungen.

Bevor Sie mit der Integration beginnen

Planen Sie, wie Sie Funktionen von Fifth Third Bank einführen

Überlegen Sie sich im Hinblick auf Ihr Geschäftsmodell und Ihre Nutzeranforderungen, wie Sie die Finanzkonten bei Fifth Third einführen können, und planen Sie, wie Sie die Umstellung von Vorgängen auf Fifth Third Bank abwickeln können.

Verfügbarkeit von Funktionen für Fifth Third Bank

In der folgenden Tabelle finden Sie die derzeit verfügbaren Stripe Treasury-Funktionen für Fifth Third Bank.

Nach der Veröffentlichung dieser Funktionen für Fifth Third Bank werden wir zusätzliche Funktionen für Fifth Third Bank entwickeln, wie z. B.:

• Erfassung der Ferneinreichung für eine Scheckeinzahlung
• ACH-Abwicklung am selben Tag für Outbound Transfers, Outbound Payments und Inbound Transfers
• Plattform-Finanzkonto bei Fifth Third Bank
• Finanzkonten mit Fifth Third über die API schließen
• CreditReversal erstellen

Wenn Sie eine Finanzkonto-Funktion anfordern, die für Fifth Third Bank noch nicht freigegeben wurde, gibt Stripe den folgenden Fehler zurück: „Sie können {_feature_} auf einem Finanzkonto bei der fifth_third Bank nicht anfordern.“

Erhalten Sie Zugriff auf die Funktionen von Fifth Third Bank

Um Zugriff anzufordern, wenden Sie sich an Ihre/n Vertriebsmitarbeiter/in oder geben Sie unten Ihre E-Mail-Adresse ein.

Erhalten Sie Zugriff auf Fifth Third Bank, indem Sie die Rechtshinweise aktualisieren

Wenden Sie sich an Ihre/n Stripe-Vertriebsmitarbeiter/in, um im Test-Modus auf Fifth Third zuzugreifen. Um im Live-Modus auf Fifth Third Bank zugreifen zu können, müssen Sie dem Compliance-Team von Stripe Folgendes zur Genehmigung vorlegen. Dies muss Folgendes beinhalten:

• Jede geplante oder Live-UX oder jedes Marketing, bei dem ein Bankpartner benannt wird
• Die Formulierung, in der Sie auf den Anspruch auf die FDIC-Pass-Through-Versicherung verweisen
• UX einschließlich Nutzersalden mit Angaben, Kontoauszügen und Transaktionshistorie

Sie müssen eine Vorschau Ihrer geplanten Aktualisierungen über das Compliance-Aufnahmeformular senden. Nachdem das Compliance-Team von Stripe die Prüfung abgeschlossen hat, gewähren wir Ihnen Zugriff auf Fifth Third im Live-Modus. Anschließend können Sie Ihre genehmigten Angaben veröffentlichen.

Rechtshinweise zu Partnerbanken

Sie müssen alle Bereiche Ihrer aktuellen Integration aktualisieren (einschließlich Marketingmaterialien, Zielseiten, andere Websites, Dashboards usw.), die einen Rechtshinweis für bestehende Partnerbanken anzeigen, damit auch Informationen über Fifth Third Bank enthalten sind.

Wenn Sie beabsichtigen, Nutzergelder sowohl bei Evolve als auch bei Fifth Third Bank zu verwahren, muss Ihr rechtlicher Hinweis folgenden Wortlaut haben: „[Name des Unternehmens] arbeitet mit Stripe Payments Company für Geldüberweisungs- und Kontodienste zusammen, mit Geldern die bei Fifth Third Bank und Evolve Bank & Trust, FDIC-Mitglied, verwahrt werden.“ Wenn Sie Nutzergelder nur bei einem Bankpartner verwahren, können Sie die obige Formulierung entsprechend für den jeweiligen Bankpartner anpassen.

Rechtshinweise zum FDIC-Pass-Through-Versicherungsanspruch

Wenn Sie bei Ihrer bestehenden Integration irgendwo auf den FDIC-Pass-Through-Versicherungsanspruch verweisen oder wenn Sie beabsichtigen, neue Verweise einzuführen, müssen Sie diesem Text die folgenden genehmigten Rechtshinweise beifügen. Diese Formulierung unterscheidet sich von unserem vorherigen Beispiel. Aktualisieren Sie sie entsprechend.

Stripe Treasury-Konten haben Anspruch auf eine FDIC-Pass-Through-Einlagensicherung, wenn sie bestimmte Anforderungen erfüllen. Die Konten sind nur insoweit versicherungsfähig, als eine Pass-Through-Versicherung nach den Regeln und Vorschriften der FDIC zulässig ist. Die Voraussetzungen für eine Pass-Through-Versicherung müssen erfüllt sein. Die FDIC-Versicherung gilt bis zu 250.000 USD pro Einleger, pro Finanzinstitut, für Einlagen, die derselben/demselben Inhaber gehören.

Weitere Informationen zu FDIC-Rechtshinweisen.

Aktualisieren Sie die Nutzeroberfläche Ihres Produkts, um mehrere Partner anzuzeigen

Salden

Geben Sie in der Nutzeroberfläche Ihres Produkts jeden Saldo separat an, wenn ein/e Nutzer/in Salden bei zwei Bankpartnern hat (zum Beispiel dem alten Partner und Fifth Third Bank). Stellen Sie sicher, dass die Nutzer/innen klar sehen können, welche Bank mit den einzelnen Salden verknüpft ist. Wenn Sie sicher sind, dass ein Saldo immer 0 USD sein wird, wenden Sie sich an Ihren internen Rechtsbeistand und die Compliance-Abteilung, um zu entscheiden, ob oder wie dieser Saldo angezeigt werden soll. Sorgen Sie dafür, dass Ihre Nutzer/innen klar erkennen können, wie viele Finanzkonten sie eröffnet haben, welche Institute diese Konten führen und ob sie ein Guthaben von über 0 USD haben.

Sie müssen zu jedem einzelnen Guthaben einen spezifischen Rechtshinweis bereitstellen, aus dem hervorgeht, welche Bank das Guthaben verwahrt. Dadurch wird sichergestellt, dass das verbundene Konto über seine potenziellen Versicherungslimits bei den jeweiligen Banken informiert ist.

Transaktionsverlauf

Sie können eine einzelne Transaktionshistorie pro verbundenem Konto verwalten, müssen jedoch Informationen für beide Finanzkonten anzeigen (zum Beispiel Transaktionsaktivität, Eröffnungs- und Abschlusssalden, Gebühren, Rendite usw.). Wenn Sie eine einzige inklusive Transaktionshistorie anbieten, stellen Sie sicher, dass für den/die Nutzer/in klar ersichtlich ist, welches Finanzkonto mit jeder Transaktion verknüpft ist.

Wenn Sie die Weiterleitung aktivieren, müssen Sie dem verbundenen Konto erlauben, alle drei Transaktionsbelege anzuzeigen, die an den jeweiligen weitergeleiteten Transaktionen beteiligt sind, und nicht nur einen Transaktionsbeleg. Sie können diese Belege mit den gehosteten Regulierungsbelegen von Stripe erstellen. Dadurch können Sie jede weitergeleitete Transaktion einmal und nicht einzeln als drei Transaktionen darstellen.

Erfahren Sie mehr über die Reihenfolge bei der Umstellung auf Fifth Third und die gleichzeitige Pflege von zwei Bankpartnern.

Abrechnungen

Sie müssen entweder eine einzige Abrechnung vorlegen, die alle Guthaben der Finanzkonten und alle Transaktionen enthält, oder mehrere mehrere Abrechnungen vorlegen, d. h. eine pro Finanzkonto. Dies gilt, solange beide Finanzkonten offen sind und mindestens eine Transaktion für den jeweiligen Monat vorliegt.

Test-Modus

Sie müssen die gleichen Live-Modus-APIs für Fifth Third Bank verwenden wie für Evolve. Infolgedessen unterscheidet sich die Fifth Third Bank im Test-Modus nur in drei Bereichen von Evolve:

• Wenn Sie im Test-Modus ein Finanzkonto bei Fifth Third Bank anlegen, können Sie features[financial_addresses][aba][bank]="fifth_third" angeben. Alle Finanzkonten im Test-Modus erhalten Adressen bei der Stripe Test Bank anstelle eines bestimmten echten Bankpartners wie Fifth Third Bank. Die Geldbewegungen verhalten sich für alle Konten im Test-Modus gleich.
• Sie können die neue Funktion treasury_fifth_third im Test-Modus anfordern.
• Sie können die ABA-Weiterleitung im Test-Modus testen.

Finanzkonto für Plattformen

Das Finanzkonto Ihrer Plattform bleibt bei Evolve offen. Vorerst werden wir kein zweites Plattform-Finanzkonto bei Fifth Third Bank eröffnen. Wir planen jedoch, dies innerhalb weniger Monate einzuführen. Bis dahin können Sie mit Stripe-Netzwerküberweisungen sofort Gelder von Ihrem Plattform-Finanzkonto bei Evolve auf die Finanzkonten Ihrer verbundenen Konten bei Fifth Third Bank überweisen.

Fordern Sie Zugang zur Fifth Third Bank für neue oder bestehende verbundene Konten an

Verwenden Sie POST /v1/accounts, um ein neues verbundenes Konto zu erstellen. Damit das Konto Stripe Treasury nutzen kann, fordern Sie die folgenden erforderlichen Funktionen für das Konto an:

• transfers (erforderlich für alle verbundenen Konten)
• treasury (erforderlich für Ihre Treasury-Integration)
• treasury_fifth_third (neu und erforderlich für den Zugriff auf Fifth Third Bank)
• Fordern Sie weiterhin die gleichen Funktionen an, die Sie derzeit anfordern.

Wenn Sie Funktionen anfordern, enthält der requirements.currently_due hash für das Account-Objekt Ihres verbundenen Kontos die Anforderungen, die erfüllt sein müssen, damit die Funktionen aktiviert werden können. Wenn das verbundene Konto bereits Felder bereitstellt, nutzt Stripe diese erneut, ohne eine erneute Übermittlung anzufordern. Zum Erfassen von Feldern können Sie weiterhin das gehostete Onboarding oder die Stripe-API verwenden.

Wenn Sie ein verbundenes Konto haben, für das Treasury aktiviert ist, verwenden Sie POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}, um das Konto mit der zugehörigen ID zu aktualisieren und eine Anfrage für die Funktion treasury_fifth_third zu stellen.

Für die Anforderung der treasury_fifth_third-Funktion sind im Vergleich zur treasury-Funktion keine neuen Felder erforderlich. Für den Zugriff auf die Fifth Third Bank ist jedoch entweder eine URL oder eine Produktbeschreibung mit mindestens 10 Zeichen erforderlich. Dies unterscheidet sich von der treasury-Funktion, für die keine Mindestzeichenanzahl für die Produktbeschreibung erforderlich ist. Wenn das verbundene Konto keine URL bereitgestellt hat und eine Produktbeschreibung mit weniger als 10 Zeichen enthält, müssen Sie daher eine URL bereitstellen oder die Produktbeschreibung aktualisieren, um die Mindestzeichenanzahl von 10 zu erreichen. Vorschau die Funktion treasury_fifth_third für jedes verbundene Live-Konto, um sicherzustellen, dass für dieses Konto keine zusätzlichen Anforderungen bestehen.

Mithilfe der folgenden beiden Felder können Sie bestätigen, dass jedes verbundene Konto für Stripe unterstützt werden kann:

1. URL: Geben Sie eine URL an, um sicherzustellen, dass Ihr verbundenes Konto mit größter Wahrscheinlichkeit als unterstützungswürdig eingestuft wird. Stripe überprüft die URL jedes verbundenen Kontos, um sicherzustellen, dass es als unterstützungsberechtigtes Unternehmen gilt. Wir erkennen legitime Fälle an, in denen ein verbundenes Konto keine URL hat (zum Beispiel wenn es kein Online-Geschäft ist oder noch keine Website eingerichtet hat). Daher ist eine URL für den Hash „Accounts requirements“ nicht unbedingt erforderlich, und wir werden den Zugriff auf die Funktion treasury_fifth_third nicht sperren, wenn das verbundene Konto keine URL angeben kann. Wir erwarten jedoch, dass Sie eine URL angeben, wenn eine solche vorhanden ist, und wir führen manuelle Compliance-Prüfungen durch, um sicherzustellen, dass Sie URLs erfassen. Eine URL ist bereits eine Voraussetzung für die Funktionen card_payments und us_bank_account_ach_payments, was bedeutet, dass Sie möglicherweise bereits eine URL erfassen, wenn Sie eine dieser Funktionen anfordern.

2. Produktbeschreibung: Wenn Sie keine URL übermitteln, prüfen wir das Feld mit der Produktbeschreibung, um zu ermitteln, ob wir Ihr verbundenes Konto unterstützen können. Die Beschreibung muss mindestens 10 Zeichen lang sein. Wenn ein bestehendes verbundenes Konto keine URL und eine Produktbeschreibung mit weniger als 10 Zeichen hat, müssen Sie eine längere Beschreibung angeben, um Zugriff auf Fifth Third zu erhalten. Wir empfehlen, verbundenen Konten eine Produktbeschreibung zu geben, die den Zweck der Eröffnung eines Treasury-Finanzkontos und dessen beabsichtigte Verwendung widerspiegelt. Bei laufenden Kontoprüfungen legen wir diese Beschreibung zugrunde, so dass eine Beschreibung die Wahrscheinlichkeit von Einschränkungen oder anderen Problemen mit dem Finanzkonto minimiert. Als Best Practice sollten Sie sicherstellen, dass die Beschreibungen mindestens 30 Zeichen lang sind.

Sie können Produktbeschreibungen oder andere Anforderungen im Voraus einreichen oder warten, bis der/die Nutzer/in den Betrieb auf Fifth Third umstellt. Wenn Sie die Funktion treasury_fifth_third vor diesem Zeitpunkt anfordern, hat dies keinen Einfluss auf die Live-Zahlungen oder Treasury-Geschäftsvorgänge Ihrer Nutzer/innen.

Nachdem Sie alle Anforderungen für die Funktionen treasury_fifth_third und treasury erfüllt haben, können Sie mit Ihrem verbundenen Konto Finanzkonten bei Evolve und Fifth Third Bank erstellen.

Status für den Zugriff eines verbundenen Kontos auf Fifth Third überprüfen

Beim Onboarding Ihrer verbundenen Konten bei Fifth Third Stripe überprüft Stripe jedes verbundene Konto, um sicherzustellen, dass es sich um einen unterstützungswürdigen Use case handelt. Ihre Nutzer/innen müssen möglicherweise zusätzliche Informationen bereitstellen, zum Beispiel den Nachweis von Lizenzen für ihre Branche. Basierend auf den Informationen, die sie zur Verfügung stellen, unterstützt Stripe das Konto möglicherweise nicht. Nachdem Sie die Anforderungen für die Funktion treasury_fifth_third erfüllt haben, ändert sich der Status der Funktion und wir stellen das Ereignis capability.updated bereit. Wenn es sich in einem aktiven Status befindet, kann das verbundene Konto sofort mit der Erstellung von Fifth Third Bank-Finanzkonten beginnen.

Wenn die Funktion den Status „Ausstehend“ oder „Inaktiv“ hat, lädt Stripe eine Datei mit jedem verbundenen Konto, seinem Status und den nächsten Schritten in den Abschnitt Dokumente in Ihrem Dashboard hoch. Hierbei handelt es sich nur um eine zwischenzeitliche Lösung, bis Stripe Folgeaktionen direkt über das Stripe-Dashboard und die API auslösen kann.

Die hochgeladene Datei enthält einen Datensatz für jedes verbundene Konto. Die Datei enthält sowohl einen „Kontostatus“ als auch eine „Statusbeschreibung“ sowie eine Erklärung und die nächsten Schritte. Nachfolgend finden Sie mögliche Erklärungen und die nächsten Schritte, die Sie möglicherweise sehen:

• Wird überprüft: Dieses Konto wird noch von Stripe geprüft und ist noch nicht bereit für die Migration.
• Dem Konto fehlen Informationen: Dieses Konto kann noch nicht gelöscht werden, da eine Produktbeschreibung fehlt oder keine funktionierende URL vorhanden ist.
• Das Konto ist nicht für die Migration geeignet: Bei dem Konto handelt es sich um ein nicht zugelassenes Unternehmen und die Treasury-Funktionalität für Fifth Third Bank kann nicht unterstützt werden.

Wenn wir das Konto als „Nicht für die Migration geeignet“ eingestuft haben, erfassen wir auch die von Stripe zugewiesene Geschäftskategorie und Unterkategorie. Dadurch verstehen Sie die Hintergründe dazu, warum Stripe die Migration blockiert hat, da das Konto entweder in die Liste der nicht zugelassenen und eingeschränkten Unternehmen von Stripe Treasury oder in die Liste der nicht zugelassenen und eingeschränkten Unternehmen von Stripe fällt. Kontaktieren Sie uns, wenn Sie Fragen haben.

Fehlerbehebung für Compliance-Plan-Fehlercodes

Wenn Sie die Funktion treasury_fifth_third für die verbundenen Konten Ihrer Plattform anfordern, müssen Sie eine URL oder eine Produktbeschreibung angeben, um die Unterstützbarkeit Ihres verbundenen Kontos mit Fifth Third Bank zu ermitteln. Wenn Sie eine URL übermitteln, werden möglicherweise Fehlercodes angezeigt.

• invalid_url_format: Das Format der URL, die Sie übermittelt haben, ist entweder falsch oder eine Zeichenfolge. Aktualisieren Sie die URL auf ein gültiges Format (zum Beispiel .com oder .org).
• invalid_url_denylisted: Gibt an, dass sich die übermittelte URL auf einer „Sperrliste“ von Stripe befindet. Wenden Sie sich an uns, wenn Sie Unterstützung benötigen.
• invalid_url_website_inaccessible: Die von Ihnen übermittelte URL ist möglicherweise durch ein Passwort geschützt. Die Website Ihres verbundenen Kontos muss zugänglich sein, um Bewertungen der Unterstützbarkeit zu ermöglichen.
• invalid_url_website_incomplete: Die von Ihnen übermittelte URL gibt einen 404-Statusfehlercode zurück.
• Invalid_url_website_other: Wenn Stripe diesen Fehler zurückgibt, wenden Sie sich bitte an uns, um Unterstützung zu erhalten.

Wenn das URL-Feld weiterhin Fehler zurückgibt oder Sie es nicht mit Ihrem verbundenen Konto anpassen können, senden Sie stattdessen eine Produktbeschreibung.

Finanzkonten bei Fifth Third Bank erstellen

FinancialAccount erstellen

Um ein neues FinancialAccount bei Fifth Third Bank für ein verbundenes Konto mit den erforderlichen aktiven Funktionen zu erstellen, verwenden Sie POST /v1/treasury/financial_accounts und geben Sie die ID des verbundenen Kontos als Wert des Stripe-Account header des Aufrufs an.

Geben Sie beim Erstellen des Finanzkontos features[financial_addresses][aba][bank]="fifth_third" an, um sicherzustellen, das es nicht bei Evolve erstellt wird. Nachdem Sie das Finanzkonto erstellt haben, können Sie seinen Bankpartner nicht mehr ändern.

Bis im Oktober extern adressierbare Konten bei Fifth Third Bank verfügbar sind, müssen Sie auch features[financial_addresses][aba][requested]="false" für Ihre Finanzkonten angeben. Sobald diese verfügbar sind, fordern Sie eine extern adressierbare Kontonummer und Routingnummer (financial_addresses.aba) an, indem Sie features[financial_addresses][aba][requested]="true" angeben.

Um ein Fifth Third-Finanzkonto für ein verbundenes Konto zu erstellen, stellen Sie sicher, dass das verbundene Konto kein Finanzkonto mit einem negativen Saldo hat. Um einen 404-Fehler zu vermeiden, müssen alle Finanzkonten einen Saldo von 0 USD oder mehr enthalten.

Sie können die gleichen Funktionen für das Finanzkonto bei Fifth Third anfordern, die Sie für Ihre Evolve-Finanzkonten angefordert haben, einschließlich outbound_transfers, outbound_payments und weiterer Funktionen. Wenn Sie eine Finanzkonto-Funktion anfordern, die für Fifth Third Bank noch nicht freigegeben wurde, gibt Stripe den folgenden Fehler zurück: „Sie können {_feature_} auf einem Finanzkonto bei der fifth_third Bank nicht anfordern.“

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[deposit_insurance][requested]"=true \
  -d "features[financial_addresses][aba][requested]"=false \
  -d "features[financial_addresses][aba][bank]"=fifth_third \
  -d "features[inbound_transfers][ach][requested]"=true \
  -d "features[intra_stripe_flows][requested]"=true \
  -d "features[outbound_payments][ach][requested]"=true \
  -d "features[outbound_payments][us_domestic_wire][requested]"=true \
  -d "features[outbound_transfers][ach][requested]"=true \
  -d "features[outbound_transfers][us_domestic_wire][requested]"=true

FinancialAccount aktualisieren, abrufen und schließen

Es gibt keine Änderungen an den APIs zur Aktualisierung eines Finanzkontos und zum Abrufen von Feldern. Weitere Informationen finden Sie unter Mit Finanzkonten arbeiten. Sie können ein Evolve-Finanzkonto mithilfe der API schließen. Bis wir die Möglichkeit unterstützen, ein Fifth-Third-Finanzkonto über die API zu schließen, können Sie uns kontaktieren, um Ihr Finanzkonto zu schließen.

FinancialAccount-Webhooks

Wir unterstützen alle Webhooks für Finanzkonten, einschließlich:

• account.updated
• treasury.financial_account.created
  • Wird immer ausgelöst, wenn ein neues FinancialAccount erstellt wird.
• treasury.financial_account.closed
• 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.

Gelder mit Finanzkonten bei Fifth Third übertragen

Übersicht über Geldübertragungen

Mit Stripe Treasury gibt es viele Möglichkeiten, wie Sie Gelder auf Finanzkonten einzahlen und von diesen auszahlen können. Die Transaktionstypen lassen sich in vier Kategorien einteilen:

• Gutschrift oder Lastschrift: Bei einer Gutschrift handelt es sich um eine Anweisung, Geld von einem Konto zu senden, wodurch die Vermögenswerte sinken. Bei einer Lastschrift handelt es sich hingegen um eine Anweisung, Geld auf ein Konto zu übertragen, wodurch die Vermögenswerte steigen.
• Empfangen oder veranlasst: Dies gibt an, ob die Gutschrift oder die Belastung auf das Finanzkonto (empfangen) oder auf das Konto der anderen Partei (veranlasst) erfolgt. Bei einer veranlassten Gutschrift wird beispielsweise Geld vom Finanzkonto gesendet, wodurch sich der Saldo verringert. Bei einer empfangenen Gutschrift hingegen geht Geld auf dem Finanzkonto ein, wodurch sich der Saldo erhöht.
• Netzwerk: Jede Art von Geldübertragung wird von einem oder mehreren der folgenden Netzwerke unterstützt: ACH-Überweisung, Banküberweisung, Stripe-Netzwerk, Scheck und Issuing-Transaktionen.
• (Optional) Einzahlung oder Auszahlung: Dies ist eine optionale Möglichkeit anzugeben, ob Geld von einem Finanzkonto abgeht oder auf einem Finanzkonto eingeht.

APIs für Geldübertragungen von Stripe Treasury

In der folgenden Tabelle werden die verfügbaren Stripe Treasury-APIs für Geldbewegungen beschrieben.

Transaktionen für das Finanzkonto veranlassen

Eine Gutschrift mit einem OutboundTransfer oder einer OutboundPayment veranlassen

Um Gelder von einem Finanzkonto bei Fifth Third zu transferieren, können Sie eine OutboundTransfer zum Senden von Geldern zwischen zwei Konten mit demselben/derselben Besitzer/in oder eine OutboundPayment zum Senden von Geldern zwischen verschiedenen Kontoinhabern/Kontoinhaberinnen erstellen.

Sie können Geld über das Stripe-Netzwerk auf ein anderes Finanzkonto Ihrer Plattform überweisen. Das Geld kommt innerhalb einer Stunde an. Um über das Stripe-Netzwerk zu senden, müssen Sie anstelle eines Kontos und einer Routingnummer eine Finanzkonto-ID in das Feld destination_payment_method_data eingeben.

Alternativ können Sie Stripe anweisen, die Transaktion per Überweisung oder ACH zu senden. Wenn Sie vor dem veröffentlichten Stichtag einreichen, erhalten Sie bis zum Ende des Tages, an dem Sie eine Überweisung veranlassen, Informationen zur Sendungsverfolgung. Abhängig von der Zielbank und dem Zeitpunkt der Einreichung kann unser Bankpartner inländische Überweisungen entweder über FedWire oder über das CHIPS-Netzwerk senden. Wenn Sie eine Überweisung von einem Finanzkonto bei Evolve veranlassen, wird sie über FedWire gesendet. Wenn Sie eine Überweisung von einem Finanzkonto bei Fifth Third Bank veranlassen, wird sie mit CHIPS gesendet, vorausgesetzt, die empfangende Bank akzeptiert CHIPS und die Überweisung wird während der Betriebszeiten von CHIPS gesendet. Andernfalls wird sie mit FedWire gesendet.

Bei Banküberweisungen, die über FedWire gesendet werden, suchen Sie die Felder IMAD und OMAD in den Feldern tracking_details[us_domestic_wire][imad] und tracking_details[us_domestic_wire][omad].

Bei Banküberweisungen, die mit CHIPS gesendet werden, suchen Sie die Systemsequenznummer der Übertragung in tracking_details[us_domestic_wire][chips]. Sie können der empfangenden Bank diese IDs mitteilen, um den Status der Überweisung zu verfolgen.

Wenn Sie ACH-Transaktionen vor Ablauf des veröffentlichten ACH-Einreichungsfensters einreichen, erhalten Sie in der Regel bis zum Ende des Tages Informationen zur Sendungsverfolgung von Ihrer Bank.

Der Annahmeschluss für veranlasste Banküberweisungen und ACH-Überweisungen bei Fifth Third Bank soll zu einem späteren Zeitpunkt als bei Evolve möglich sein.

Wenn Sie Überweisungen kurz nach dem Stichtag einreichen, werden sie möglicherweise noch an diesem Abend bearbeitet, aber das ist nicht garantiert.

Bis Ende Oktober 2024 erhalten Finanzkonten eine extern adressierbare Kontonummer und Routingnummer. Bis zu diesem Datum werden Empfängerinnen und Empfängern veranlasste Übertragungen von einem zentralen Stripe-eigenen Ursprungskonto angezeigt (mit der Routingnummer 042000314). Diese Übertragungen werden wie erwartet funktionieren und verfügen über eine nutzerdefinierte Zahlungsbeschreibung, damit Angaben zum Ausstellenden gemacht werden können. Nachdem Finanzkonten eine eigene Kontonummer und Routingnummer zugewiesen wird, zeigen Übertragungen diese Details an.

Weitere Informationen zu diesen APIs finden Sie unter OutboundTransfers und OutboundPayments.

Eine Lastschrift mit einer InboundTransfer veranlassen

Sie können Lastschriften mit InboundTransfers veranlassen. InboundTransfers werden immer mit ACH erstellt und unterliegen Einreichungsfristen für veranlasste Transaktionen.

Auszahlungen aus Stripe Payments

Wenn Sie oder Ihre verbundenen Konten Stripe Payments verwenden, können Sie mithilfe der Standard-Payouts-APIs Auszahlungen so einrichten, dass die erworbenen Gelder auf Ihr Finanzkonto bei Fifth Third übertragen werden. Sie können Ihre aktuelle Auszahlungseinrichtung weiterhin verwenden und zur Auszahlung auf Fifth Third-Finanzkonten wechseln, indem Sie die nachstehenden Anweisungen befolgen.

Wenn Sie Auszahlungen erstellen, ohne den Zugriff auf ausstehende Gelder zu beschleunigen, führt die Überweisung von Geldern auf Fifth Third-Finanzkonten zu schnelleren Auszahlungsgeschwindigkeiten im Vergleich zu Evolve-Finanzkonten oder externen Bankkonten.

Entscheiden Sie, ob Sie einen automatischen Auszahlungsplan einrichten oder nur manuelle Auszahlungen erstellen möchten und ob Sie den Zugriff auf ausstehende Beträge beschleunigen möchten:

• Automatisch oder manuell: Sie können einen automatischen Auszahlungsplan für ein verbundenes Konto einrichten, um täglich oder in einem anderen Rhythmus Auszahlungen vorzunehmen. Sie können auch jederzeit manuelle Auszahlungen mit einem automatischen Auszahlungsplan erstellen. Bei automatischen Auszahlungen wird immer der reconciliation_status im Auszahlungsobjekt ausgefüllt und das entsprechende payout.reconciliation_completed-Ereignis wird ausgelöst. Bei manuellen Auszahlungen ist dies nicht der Fall.
• Standard-Zugriff oder beschleunigter Zugriff: Sie können den Zugriff auf ausstehende Kartenbeträge beschleunigen, um eine manuelle oder eine automatische Auszahlung vorzunehmen. Wenn Sie ein Kartenzahlungsvolumen erwerben, werden die Gelder in der Regel zwei Tage nach Eingang der Gelder im Saldo verfügbar. Sie können bezahlen, um den Zugriff zu beschleunigen, indem Sie entweder eine sofortige manuelle Auszahlung (method=instant) erstellen, oder ein verbundenes Konto auf einen beschleunigten automatischen Auszahlungsplan (delay_days=1) setzen, der mit entsprechenden Gebühren verbunden ist. Dadurch wird der Zugriff auf ausstehende Beträge über ACH oder andere Zahlungsmethoden nicht beschleunigt, sondern nur auf Karten.

Um den Zugriff auf Gelder zu beschleunigen, müssen Sie eine einmalige Genehmigung des Plattform-Kreditrisikos einholen, wenn Sie nicht bereits beschleunigte oder sofortige Auszahlungen bei Stripe aktiviert haben. Die Aktivierung von beschleunigten Auszahlungen kann das Risiko Ihrer Plattform erhöhen, da verbundene Konten schneller Geld abheben können. Um auf diese Funktion für Karten oder ACH zuzugreifen, wenden Sie sich an Ihre/n Vertriebsmitarbeiter/in.

Verbesserungen des Auszahlungsintervalls

Auszahlungen, die Sie auf den Finanzkonten von Fifth Third erstellen, gehen schneller ein als Auszahlungen, die an externe Bankkonten oder an Evolve-Finanzkonten gesendet werden.

Manuelle Auszahlungsoptionen

Es gibt zwei Möglichkeiten für manuelle Auszahlungen: standard und instant.

• Standardmäßige manuelle Auszahlungen: Dazu gehören nur abgerechnete Zahlungsbeträge, keine ausstehenden Zahlungsbeträge. Die abgewickelten Gelder werden voraussichtlich innerhalb weniger Stunden eintreffen, was bedeutet, dass neue Kartenzahlungen in etwa 1–2 Tagen nach der Einzahlungserfassung eintreffen. Dieser Zeitpunkt ist eine Verbesserung im Vergleich zu Auszahlungen auf Evolve-Finanzkonten oder externe Bankkonten, bei denen die abgerechneten Gelder etwa 1 Tag nach der Auszahlungsanforderung oder 2–3 Tage nach der Einzahlungserfassung eingehen. Stripe garantiert keinen genauen Auszahlungszeitpunkt.

• Sofortige manuelle Auszahlungen: Diese beziehen sich sowohl auf ausstehende als auch auf abgerechnete Gelder. Wenn Sie ein Kartenzahlungsvolumen erwerben, werden die Gelder in der Regel zwei Werktage nach Eingang der Gelder im Saldo verfügbar. Andere Zahlungsarten, wie zum Beispiel ACH-Zahlungen, dauern länger. Gelder sind ausstehend, bis sie verfügbar sind. Wenn Sie eine sofortige manuelle Auszahlung erstellen, können Sie alle Gelder in den instant_available-Saldo aufnehmen. Es wird erwartet, dass sofortige manuelle Auszahlungen innerhalb weniger Stunden eintreffen. Dieses Verhalten ist für Fifth Third-Finanzkonten wie für Evolve-Finanzkonten oder externe Bankkonten gleich.

Wenn die schnelleren Auszahlungen nicht für Ihre Plattform aktiviert sind, Sie aber Interesse daran haben, diese Funktion hinzuzufügen, wenden Sie sich an Ihre/n Vertriebsmitarbeiter/in oder senden Sie uns eine E-Mail.

Automatische Auszahlungsoptionen

Sie können optional einen automatischen Auszahlungsplan für jedes verbundene Konto einrichten. Stripe erstellt Auszahlungen in einem bestimmten Rhythmus (zum Beispiel täglich) für alle bereitgestellten Gelder und sendet die Gelder an Ihr angegebenes externes Bankkonto (zum Beispiel das Finanzkonto).

Sie können die automatische Auszahlungsgeschwindigkeit steuern, indem Sie zwei Parameter unter settings.payouts.schedule festlegen:

• interval: Sie können festlegen, wie oft Gelder ausgezahlt werden. Sie können dies auf daily, weekly oder monthly festlegen. Alternativ können Sie die Einstellung auf manual setzen, wodurch automatische Auszahlungen zugunsten von nur manuellen Auszahlungen deaktiviert werden.
• delay_days: Wenn Ihr Unternehmen in den USA ansässig ist, können Sie die Anzahl der Werktage festlegen, an denen Zahlungen ausstehen, bevor sie für Standardauszahlungen verfügbar gemacht werden. Die Standardeinstellung ist 2 Tage. Sie können eine höhere Zahl festlegen, um das Risiko zu senken, oder eine niedrigere, um den Zugriff auf die ausstehenden Gelder zu beschleunigen.

Sie können Intervalle auf „täglich“ und delay_days=2 setzen. In diesem Fall gehen die Gelder etwa 1–2 Werktage nach der Einzahlungserfassung ein. Dieser Zeitpunkt ist eine Verbesserung gegenüber dem aktuellen Prozess mit Evolve, bei dem die Gelder 2–3 Tage nach der Einzahlungserfassung eintreffen würden.

Sie können den Zugriff beschleunigen, indem Sie das Intervall auf „täglich“ und delay_days=1 setzen. In diesem Fall kommen die Gelder ungefähr einen Werktag nach der Einzahlungserfassung an. Wenn Sie möchten, dass Gelder außerhalb von Werktagen eintreffen, wenden Sie sich an Ihre/n Vertriebsmitarbeiter/in.

Verwenden Sie POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} to update the payout schedule.

Aktualisieren Sie Auszahlungen, um ein Finanzkonto bei Fifth Third zu verwenden

Ein Finanzkonto für Auszahlungen einrichten

Bevor Sie Auszahlungen an ein Treasury-Finanzkonto senden oder Aufstockungen von einem Treasury-Finanzkonto erhalten können, müssen Sie das Finanzkonto als externes Konto (BankAccount-Objekt) festlegen, das mit dem entsprechenden Stripe-Konto verbunden ist. Anschließend haben Sie die Möglichkeit, ein externes Konto einzurichten, indem Sie die Finanzkonto-id angeben. Sie müssen außerdem die Funktion intra_stripe_flows für Ihr Finanzkonto anfordern.

• Plattformkonten: Verwenden Sie das Stripe-Dashboard, um ein BankAccount-Objekt zu erstellen, das Sie für Auszahlungen von oder Aufstockungen auf Ihr Plattformkonto verwenden können.
• Verbundene Konten: Verwenden Sie POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}/external_accounts, um die id des neuen Finanzkontos im financial_account-Parameter anzugeben. So erstellen Sie ein BankAccount-Objekt, das Sie für Auszahlungen von einem verbundenen Konto verwenden können.

curl https://api.stripe.com/v1/accounts/acct_xxx/external_accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "external_account[country]"=us \
  -d "external_account[currency]"=usd \
  -d "external_account[financial_account]"=fa_xxx \
  -d "external_account[object]"=bank_account

Stripe gibt Folgendes zurück:

{
 "id": "ba_xxx",
  ...
}

Eine manuelle Auszahlung erstellen

Nachdem Sie Ihr neues Finanzkonto bei Fifth Third mit einer Bankkonto-id eingerichtet haben, rufen Sie POST /v1/payouts auf, um den Zielparameterwert als neue Bankkonto-id anzugeben.

curl https://api.stripe.com/v1/payouts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1000 \
  -d currency=usd \
  -d destination=ba_xxx \
  -d method=instant

Aktualisieren Sie Ihre automatische Auszahlungskonfiguration

Wenn Sie auf Ihrer Plattform über verbundene Konten mit einem automatischen Auszahlungsplan verfügen, können Sie Auszahlungen an deren neues Finanzkonto von Fifth Third senden. Legen Sie den Parameter default_for_currency für das externe Konto, das Sie für das Finanzkonto bei Fifth Third erstellt haben, auf true fest.

Rückbuchungen von Auszahlungen

Sie können Rückbuchungen von Auszahlungen für Auszahlungen auf Finanzkonten mit einer aktiven ABA-Funktion erstellen.

Transaktionen auf dem Finanzkonto empfangen

Eine Gutschrift von einem bestehenden FinancialAccount erhalten

Um Gelder von einem bestehenden Finanzkonto auf ein Finanzkonto bei Fifth Third zu übertragen, erstellen Sie einen OutboundTransfer oder eine OutboundPayment mit dem bestehenden Finanzkonto. Wenn Sie die ID eines Finanzkontos bei Fifth Third unter destination_payment_method_data für eine OutboundPayment eingeben, wird die Transaktion über das Stripe-Netzwerk gesendet.

curl https://api.stripe.com/v1/treasury/outbound_transfers \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d financial_account=treasuryFinancialAccount \
  -d amount=1000 \
  -d currency=usd \
  -d "destination_payment_method_data[type]"=financial_account \
  -d "destination_payment_method_data[financial_account]"=destinationFifthThirdFinancialAccount \
  -d "destination_payment_method_data[statement_descriptor]"="Test xfer" \
  -d "destination_payment_method_data[description]"="OutboundTransfer to my Fifth Third financial account"

Eine Gutschrift oder Lastschrift von einer externen Quelle erhalten

Im Oktober erhalten Fifth Third-Finanzkonten extern adressierbare Konto- und Routingnummern (VBAN), nachdem Sie die Funktion financial_addresses.aba angefordert und aktiviert haben. Ihre verbundenen Konten können das Konto und die Bankleitzahl für ihr Fifth Third-Finanzkonto an empfangene Gutschriften (Wire- und ACH-Überweisungen) und empfangene Lastschriften (ACH) von externen Parteien weitergeben. Sie können auch Testeinzahlungen verwenden, um sich beim Konto zu authentifizieren.

Sie können Rückbuchungen für Lastschriften veranlassen, indem Sie eine DebitReversal erstellen. Sie müssen eine DebitReversal innerhalb von 24 Stunden erstellen. Dieses Zeitfenster werden wir jedoch in den kommenden Monaten verlängern. Bis wir CreditReversals unterstützen, senden Sie eine E-Mail an den Stripe-Support, um eine Gutschrift zurückzubuchen.

Karten für ein Finanzkonto bei Fifth Third ausstellen

Ihre Issuing-Integration ist hiervon nicht betroffen. Sie müssen Ihren Nutzerinnen und Nutzern auch keine neuen Karten ausstellen. Sie haben die Möglichkeit, bestehende Karten von laufenden Finanzkonten auf die neuen Finanzkonten bei Fifth Third umzustellen, ohne dass sich dies auf die Nutzer/innen auswirkt. Dabei handelt es sich jedoch um eine neue Funktionalität, die derzeit noch nicht nutzbar ist.

Sie können Ihre bestehende Karte auch so aktualisieren, dass sie von einem bestehenden Finanzkonto auf ein neues Finanzkonto bei Fifth Third umgestellt wird:

Sie können eine Karte migrieren, indem Sie sie mit einer neuen Finanzkonto-ID aktualisieren:

curl https://api.stripe.com/v1/issuing/cards/ic_xxx \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d financial_account=fa_xxx

Stripe gibt die folgende Antwort zurück:

{
  "id": <card Id>,
  "object": "issuing.card",
  "financial_account": <new Financial Account Id>,
  ...
}

Autorisierungen bleiben auch dann mit demselben Finanzkonto verknüpft, wenn eine Karte an ein anderes Finanzkonto umgeleitet wird. Wenn es weitere Kartenereignisse gibt, werden diese auf den Saldo des ursprünglichen Finanzkontos gebucht bzw. von diesem abgezogen. So kann es beispielsweise je nach Ausgabenkategorie bis zu 30 Tage später zu inkrementellen Autorisierungsanfragen kommen. Um unbeabsichtigte Kartenablehnungen zu vermeiden, empfehlen wir Ihnen die ABA-Weiterleitung zu verwenden. Hier erfahren Sie mehr über die Einrichtung der ABA-Weiterleitung während Ihrer Migration.

Sie können auch neue Karten ausstellen, die von einem Finanzkonto bei Fifth Third stammen, indem Sie beim Erstellen einer Karte die neue Finanzkonto-ID angeben.

Sie können ein Fifth Third-Finanzkonto erstellen und die Funktion card_issuing anfordern:

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[deposit_insurance][requested]"=true \
  -d "features[financial_addresses][aba][requested]"=false \
  -d "features[financial_addresses][aba][bank]"=fifth_third \
  -d "features[inbound_transfers][ach][requested]"=true \
  -d "features[intra_stripe_flows][requested]"=true \
  -d "features[outbound_payments][ach][requested]"=true \
  -d "features[outbound_payments][us_domestic_wire][requested]"=true \
  -d "features[outbound_transfers][ach][requested]"=true \
  -d "features[outbound_transfers][us_domestic_wire][requested]"=true

Stripe gibt die folgende Antwort zurück:

{
  id: fa_123,
  ...
}

Erstellen Sie als Nächstes eine neue Karte mit der Finanzkonto-ID:

curl https://api.stripe.com/v1/issuing/cards \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d financial_account=fa_xxx \
  -d currency=usd \
  -d type=virtual

Verfolgung von Beschwerden

Es gibt eine Aktualisierung für Ihren Nachverfolgungsprozess für Beschwerden. Nachdem Fifth Third Bank hinzugefügt wurde, enthält das Feld complaint_channel für jede Beschwerde die folgenden neuen Kanäle:

• Mitarbeitende
• Führungskraft
• Im Auftrag von
• Der Bancorp-Vorfall
• Auskunfteien für Verbraucher
• Fed
• CFPB
• BBB
• Vorstand