Réaliser une intégration avec Fifth Third BankBêta

Stripe collabore avec de nombreux partenaires bancaires pour soutenir son réseau mondial de paiement et de trésorerie. Nous avons ajouté Fifth Third Bank comme nouveau partenaire bancaire pour le produit Treasury de Stripe.

If you’re already using Stripe Treasury, this guide describes how Treasury works with Fifth Third Bank.

Si vous utilisez Treasury pour la première fois, consultez le guide Démarrer une nouvelle intégration Treasury avec Fifth Third Bank.

Structure des comptes Stripe Treasury

La structure générale des comptes Treasury reste inchangée. Vous pouvez continuer à utiliser Connect pour maintenir votre compte de plateforme existant, ainsi qu’un compte connecté pour chacun de vos utilisateurs. Étant donné que chaque compte connecté représente un utilisateur, il est associé aux informations KYC et de conformité de cet utilisateur. Lorsque vous activez des produits Stripe supplémentaires (tels que Payments avec des moyens de paiement supplémentaires, Treasury ou Issuing), vous pouvez réutiliser les informations partagées de cet utilisateur sans avoir à les recueillir à nouveau.

Each connected account can create and maintain one or more Treasury financial accounts, each of which represents an FDIC insurance-eligible account. Treasury financial accounts are each created with one bank partner (now including Fifth Third Bank). Each connected account can have up to three total financial accounts across bank partners, unless your platform has been approved for a higher limit. If you have a business reason for a higher limit, contact your sales representative or email us.

Each financial account can receive funds from the Connect payments balance, and can transfer funds to and from other financial accounts and external bank accounts.

Vous pouvez utiliser les mêmes API avec votre compte financier Fifth Third que celles que vous utilisez avec vos comptes financiers Evolve. Les API se comportent de la même manière, à quelques différences près :

1. Les heures limites pour les OutboundTransfers envoyés à partir d’un compte financier Fifth Third par virement bancaire ou prélèvement ACH sont plus tardives que pour les virements effectués avec Evolve.
2. Les virements Stripe envoyés à partir du solde des paiements arrivent plus rapidement sur les comptes financiers Fifth Third que les virements effectués vers des comptes bancaires externes ou des comptes financiers Evolve.
3. Vous pouvez utiliser une nouvelle fonctionnalité, treasury_fifth_third, pour gérer la conformité de vos comptes connectés.

Il pourrait y avoir d’autres différences à court terme pendant que nous développons Fifth Third Bank afin d’atteindre la parité avec Evolve, telles qu’une limite provisoire sur les montants de débits reçus.

Disponibilité des fonctionnalités sur Fifth Third Bank

Stripe Treasury supports feature parity across both bank partners.

We’ll release the following features for Fifth Third Bank next:

• [December] Remote deposit capture for check deposit
• [December] Close financial accounts with Fifth Third using the API
• Compte financier de la plateforme chez Fifth Third Bank
• Créer un CreditReversal

Si vous demandez une fonctionnalité pour un compte financier qui n’a pas encore été publiée pour Fifth Third Bank, Stripe renvoie l’erreur suivante : « Vous ne pouvez pas demander la fonctionnalité {_feature_} sur un compte financier avec la banque fifth_third. »

Accéder aux fonctionnalités Fifth Third Bank

Pour demander l’accès, contactez votre représentant commercial ou saisissez votre adresse e-mail ci-dessous.

Migrating to Fifth Third Bank

Stripe will partner with you to migrate your financial accounts from Evolve Bank & Trust to Fifth Third. If Stripe manages your migration, you don’t necessarily need to update your Treasury API calls, but you still need to review this guide. It contains information about how Treasury works with Fifth Third, such as changes to transfer timing and connected account compliance.

You also have the option to customize your migration, but you must notify Stripe by December 3.

Demande d’accès à la Fifth Third Bank concernant des comptes connectés nouveaux ou existants

Utilisez POST /v1/accounts pour créer un nouveau compte connecté. Pour permettre au compte d’utiliser Stripe Treasury, demandez les fonctionnalités suivantes requises pour le compte :

• transfers (requis pour tous les comptes connectés)
• treasury (nécessaire pour votre intégration Treasury)
• treasury_fifth_third (nouveau et requis pour l’accès à Fifth Third Bank)
• Continuez à demander les mêmes fonctionnalités que celles que vous demandez actuellement.

Lorsque vous demandez des fonctionnalités, le requirements.currently_due hash de l’objet Account de votre compte connecté affiche les exigences qui doivent être remplies pour activer les fonctionnalités. Si le compte connecté fournit déjà des champs, Stripe les réutilise sans exiger de nouvelle soumission. Vous pouvez continuer à utiliser l’inscription des utilisateurs hébergée ou l’API Stripe pour collecter les champs.

Si vous avez déjà un compte connecté avec la fonctionnalité Treasury activée, utilisez POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}pour mettre à jour le compte avec l’identifiant associé avec une demande pour la fonctionnalité treasury_fifth_third

La demande de la fonctionnalité treasury_fifth_third ne nécessite pas de nouveaux champs par rapport à la fonctionnalité treasury. Cependant, l’accès à la Fifth Third Bank nécessite une URL ou une description de produit d’au moins 10 caractères, et un représentant de compte situé aux États-Unis. Cela diffère de la fonctionnalité treasury, qui n’a pas d’exigences minimales en matière de caractères pour la description du produit. Par conséquent, si le compte connecté n’a pas fourni d’URL et que la description du produit est inférieure à 10 caractères, vous devez fournir une URL ou mettre à jour la description du produit pour qu’elle soit conforme au minimum de 10 caractères. Prévisualisez la fonctionnalité treasury_fifth_third sur chaque compte connecté en direct pour vous assurer qu’il n’y a pas d’exigences supplémentaires concernant le compte.

Les deux champs suivants vous aident à confirmer que chaque compte connecté est pris en charge par Stripe :

1. URL : fournissez une URL pour garantir les plus grandes chances que votre compte connecté soit approuvé pour la prise en charge. Stripe examine l’URL de chaque compte connecté pour s’assurer qu’il remplit les conditions requises pour être considéré comme une activité prise en charge. Nous reconnaissons les cas légitimes où un compte connecté n’a pas d’URL (par exemple, il ne s’agit pas d’une entreprise en ligne ou l’entité n’a pas encore lancé de site Web), de sorte qu’une URL n’est pas strictement requise par le hachage des exigences relatives aux comptes, et nous ne bloquerons pas l’accès à la fonctionnalité treasury_fifth_third si le compte connecté ne peut pas fournir d’URL. Cependant, nous vous demandons de fournir une URL si elle est disponible, et nous effectuerons des contrôles de conformité manuels pour nous assurer que vous collectez les URL. Une URL est déjà requise pour les fonctionnalités card_payments et us_bank_account_ach_payments, en d’autres termes, vous aurez probablement déjà collecté une URL si vous demandez l’une ou l’autre de ces fonctionnalités.

2. Description du produit : si vous n’indiquez pas d’URL, nous évaluons le champ de la description du produit pour déterminer si nous pouvons prendre en charge votre compte connecté, la description devant comporter au moins 10 caractères. Si un compte connecté existant n’a pas d’URL et la description de produit contient moins de 10 caractères, vous devez fournir une description plus longue pour avoir accès à Fifth Third. Nous recommandons de guider les comptes connectés pour qu’ils soumettent une description de produit qui reflète l’objectif de l’ouverture d’un compte financier Treasury et son utilisation prévue. Nous nous appuyons sur cette description pour la vérification continue des comptes, donc une description minimise la probabilité de restrictions ou d’autres problèmes liés au compte financier. La bonne pratique consiste à s’assurer que les descriptions respectent un minimum de 30 caractères.

Vous pouvez soumettre des descriptions de produits ou toute autre exigence à l’avance, ou attendre que l’utilisateur transfère ses opérations à Fifth Third. Demander la fonctionnalité treasury_fifth_third avant cela n’affectera pas les paiements en production de vos utilisateurs ni les opérations commerciales Treasury.

Une fois que vous avez rempli toutes les exigences pour les fonctionnalités treasury_fifth_third et treasury, vous pouvez utiliser votre compte connecté pour créer des comptes financiers chez Evolve et Fifth Third Bank.

1. Représentant du compte : lorsque vous demandez la fonctionnalité treasury_fifth_third, nous vérifions que le représentant de votre compte est situé aux États-Unis. Si nous déterminons que ce n’est pas le cas, il est possible que nous n’accordions pas cette fonctionnalité à votre compte connecté. Pour en savoir plus, consultez les exigences de Treasury.

Vérifier l’état de l’accès d’un compte connecté à Fifth Third

Au fur et à mesure que vos comptes connectés adoptent Fifth Third, Stripe examinera chaque compte connecté pour s’assurer qu’il s’agit d’un cas d’usage qui peut être pris en charge. Vos utilisateurs pourraient avoir besoin de fournir des informations supplémentaires, telles que des preuves de licences pour leur secteur. En fonction des informations fournies, il est possible que Stripe ne prenne pas en charge le compte. Une fois que vous avez rempli les conditions pour la fonctionnalité treasury_fifth_third, l’état de l’API pour la fonctionnalité change et nous fournissons l’événement capability.updated. S’il a un état actif, le compte connecté peut immédiatement commencer à créer des comptes financiers Fifth Third Bank.

Si l’état de la fonctionnalité est en attente ou inactif, Stripe charge un fichier dans la section Documents de votre Dashboard énumérant chaque compte connecté, son état et les prochaines étapes. Il s’agit d’un processus provisoire jusqu’à ce que Stripe active les actions de suivi directement à partir du Dashboard Stripe et de l’API.

Le fichier téléchargé comprend un enregistrement pour chaque compte connecté. Le fichier comprend à la fois un « état du compte » et une « description de l’état ». Il comprend également une explication et les étapes à suivre. Vous trouverez ci-dessous des exemples d’explications et d’étapes à suivre :

• En cours d’examen : Stripe examine actuellement ce compte, qui n’est pas encore prêt pour la migration.
• Il manque des informations sur le compte : ce compte ne peut pas encore être accepté, car il manque une description de produit ou parce qu’il ne dispose pas d’une URL fonctionnelle.
• Le compte n’est pas admissible à la migration : le compte est une entreprise dont l’activité est interdite et la fonctionnalité Fifth Third Bank Treasury ne peut pas la prendre en charge.

Si nous avons identifié le compte comme « Non admissible à la migration », nous incluons également la catégorie et la sous-catégorie d’entreprise attribuées par Stripe. Cela vous aide à comprendre pour quelles raisons Stripe a bloqué la migration car le compte relève soit de la liste des activités interdites et autorisées sous condition de Stripe Treasury, soit de la liste des activités interdites et autorisées sous condition de Stripe. Contactez-nous si vous avez des questions.

Dépannage des codes d’erreur du plan de conformité

Lorsque vous demandez la fonctionnalité treasury_fifth_third pour les comptes connectés de votre plateforme, vous devez fournir une URL ou une description de produit pour établir la prise en charge de votre compte connecté utilisant Fifth Third Bank. Si vous soumettez une URL, vous pourriez rencontrer des codes d’erreur.

• invalid_url_format : le format de l’URL que vous avez soumis est incorrect ou est une chaîne. Mettez à jour l’URL avec un format valide (par exemple, .com ou.org).
• invalid_url_denylisted : l’URL soumise se trouve sur une « liste d’exclusion » de Stripe. Contactez-nous pour obtenir de l’aide.
• invalid_url_website_inaccessible : l’URL que vous avez soumise est peut-être protégée par un mot de passe. Le site Web de votre compte connecté doit être accessible pour permettre les évaluations de prise en charge.
• invalid_url_website_incomplete : l’URL que vous avez soumise renvoie un code d’erreur d’état 404.
• Invalid_url_website_other : si Stripe renvoie cette erreur, contactez-nous pour obtenir de l’aide.

Si le champ URL continue de renvoyer des erreurs ou si vous ne pouvez pas y remédier avec votre compte connecté, soumettez à la place une description du produit.

Créer des comptes financiers chez Fifth Third Bank

Créer un FinancialAccount

Pour créer un nouveau FinancialAccount auprès de Fifth Third Bank pour un compte connecté avec les fonctionnalités requises actives, utilisez POST /v1/treasury/financial_accounts et ajoutez l’identifiant du compte connecté comme valeur de l’en-tête Stripe-Account header de l’appel.

Précisez features[financial_addresses][aba][bank]="fifth_third" lors de la création du compte financier pour vous assurer qu’il n’est pas créé chez Evolve. Une fois le compte financier créé, vous ne pouvez plus modifier son partenaire bancaire.

Request an externally addressable account number and routing number (financial_addresses.aba) by specifying features[financial_addresses][aba][requested]="true".

Pour créer un compte financier Fifth Third pour un compte connecté, assurez-vous que le compte connecté n’a pas de compte financier avec un solde négatif. Pour éviter une erreur 404, tous les comptes financiers doivent contenir un solde de 0 USD ou plus.

Vous pouvez demander les mêmes fonctionnalités sur le compte financier Fifth Third que celles que vous avez demandées sur vos comptes financiers Evolve, y compris outbound_transfers, outbound_payments et d’autres fonctionnalités. Si vous demandez une fonctionnalité de compte financier qui n’a pas encore été publiée pour Fifth Third, Stripe renvoie l’erreur suivante : « Vous ne pouvez pas demander {_feature_} sur un compte financier avec la banque fifth_third ».

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

Modifier, récupérer et clôturer un FinancialAccount

Aucune modification n’a été apportée aux API utilisées pour mettre à jour un compte financier et récupérer des champs. Pour plus d’informations, consultez la page Fonctionnement des comptes financiers. Vous pouvez clôturer un compte financier Evolve en utilisant l’API. Jusqu’à ce que nous puissions prendre en charge la clôture d’un compte financier Fifth Third, vous pouvez restreindre les fonctionnalités de votre compte financier Treasury pour en limiter l’accès.

Webhooks du FinancialAccount

Nous prenons en charge tous les webhooks de comptes financiers, y compris :

• account.updated
• treasury.financial_account.created
  • Déclenché lors de la création d’un FinancialAccount.
• treasury.financial_account.closed
• treasury.financial_account.features_status_updated
  • Indique qu’une ou plusieurs fonctionnalités ont changé d’état. Les tableaux active_features, pending_features ou restricted_features reflètent ce changement.

Transfert de fonds avec les comptes financiers Fifth Third

Vue d’ensemble des transferts de fonds

Stripe Treasury propose de nombreux types de transferts de fonds vers et depuis des comptes financiers. Vous pouvez classer chaque type de transaction en quatre catégories :

• Crédit ou débit : un crédit est une instruction pour envoyer de l’argent hors d’un compte et diminuer les actifs, tandis qu’un débit est une instruction pour recevoir de l’argent sur un compte et augmenter les actifs.
• Reçu ou créé : ceci indique si le crédit ou le débit est appliqué au compte financier (reçu) ou au compte de l’autre partie (créé). Par exemple, un crédit créé transfère des fonds hors du compte financier, ce qui réduit le solde, tandis qu’un crédit reçu transfère des fonds sur le compte financier, ce qui augmente le solde.
• Voie de paiement : chaque type de transfert de fonds est pris en charge par une ou plusieurs voies de paiement, telles que prélèvement ACH, virement bancaire, réseau Stripe, chèque et transactions Issuing.
• (Facultatif) Entrée ou sortie de fonds : il s’agit d’un moyen facultatif de préciser la direction des mouvements de fonds dans un compte financier.

API Stripe Treasury de transfert de fonds

Le tableau suivant décrit les API Stripe Treasury disponibles pour les transferts de fonds.

Créer des transactions pour le compte financier

Créer un crédit avec un OutboundTransfer ou un OutboundPayment

Pour transférer des fonds d’un compte financier Fifth Third, vous pouvez créer un OutboundTransfer pour envoyer des fonds entre deux comptes ayant le même propriétaire, ou un OutboundPayment pour envoyer des fonds entre différents titulaires de compte.

Vous pouvez transférer des fonds vers un autre compte financier appartenant à votre plateforme à l’aide du réseau Stripe. Les fonds arrivent dans l’heure qui suit. Pour effectuer un transfert sur le réseau Stripe, vous devez saisir un identifiant de compte financier dans le champ destination_payment_method_data au lieu d’un numéro de compte et d’un numéro de routage.

Vous pouvez également demander à Stripe d’envoyer la transaction par virement bancaire ou ACH. Si vous soumettez votre demande avant les délais de soumission publiés, vous recevrez les informations de suivi avant la fin de la journée concernant le virement effectué ce jour. En fonction de la banque de destination et de l’heure d’envoi des fonds, notre partenaire bancaire peut envoyer des virements bancaires nationaux via le réseau FedWire ou CHIPS. Si vous émettez un virement à partir d’un compte financier Evolve, il est envoyé par FedWire. Si vous émettez un virement à partir d’un compte financier Fifth Third Bank, il est envoyé par CHIPS à condition que la banque destinataire accepte CHIPS et que le virement soit envoyé pendant les heures d’ouverture de CHIPS. Sinon, il est envoyé par FedWire.

Dans le cas des virements envoyés par FedWire, localisez les champs IMAD et OMAD dans les champs tracking_details[us_domestic_wire][imad] et tracking_details[us_domestic_wire][omad].

Pour les virements envoyés à l’aide de CHIPS, localisez le numéro de séquence système du transfert dans le champ tracking_details[us_domestic_wire][chips]. Vous pouvez partager ces identifiants avec la banque destinataire pour suivre l’état du virement bancaire.

Si vous soumettez des transactions ACH avant les délais de soumission ACH publiés, vous recevrez généralement des informations de suivi de la part de votre banque avant la fin de la journée.

L’heure limite des virements bancaires et des prélèvements ACH avec Fifth Third Bank est prolongée au-delà du délai d’ Evolve :

Si vous soumettez des virements peu après l’heure limite, ceux-ci peuvent encore être traités le soir même, mais ce n’est pas garanti.

Pour plus d’informations sur ces API, voir OutboundTransfers et OutboundPayments.

Créer un débit avec un InboundTransfer

Vous pouvez créer des débits à l’aide des InboundTransfers. Les InboundTransfers sont toujours émis par ACH et sont soumis aux délais de soumission des transactions.

Virements depuis Stripe Payments

Si vous ou vos comptes connectés utilisez Stripe Payments, vous pouvez configurer les virements pour envoyer les fonds acquis dans votre compte financier Fifth Third à l’aide des API Payouts standards. Vous pouvez continuer à utiliser votre configuration de virement actuelle, et passer au paiement dans les comptes financiers Fifth Third en suivant les instructions ci-dessous.

Lorsque vous créez des virements sans accélérer l’accès aux fonds en attente, les virements bancaires vers les comptes financiers Fifth Third sont plus rapides que ceux vers les comptes financiers Evolve ou les comptes bancaires externes.

Décidez si vous voulez mettre en place une fréquence des virements automatique ou seulement créer des virements manuels, et si vous souhaitez accélérer l’accès aux fonds en attente :

• Automatique ou manuel : vous pouvez établir une fréquence des virements automatique pour un compte connecté afin de transférer des fonds chaque jour ou selon une autre cadence. Avec la fréquence automatique, vous pouvez également créer des virements manuels à tout moment. Les paiements automatiques renseignent toujours l’attribut reconciliation_status de l’objet Payouts et déclenchent l’événement correspondant payout.reconciliation_completed, ce qui n’est pas le cas des virements manuels.
• Accès standard ou accéléré : vous pouvez accélérer l’accès aux fonds en attente des cartes bancaires pour effectuer un virement manuel ou automatique. Lorsque vous acquérez un volume de paiements par carte bancaire, les fonds deviennent généralement disponibles dans le solde deux jours ouvrables après la réception des fonds. Vous pouvez accélérer l’accès, soit en créant un paiement manuel instantané (method=instant), soit en définissant pour un compte connecté une fréquence de virements instantané (delay_days=1) moyennant le paiement des frais respectifs associés. L’accélération de l’accès aux fonds en attente s’applique uniquement aux cartes bancaires ; elle ne concerne pas ACH ou d’autres moyens de paiement.

Pour accélérer l’accès aux fonds, vous devez obtenir une autorisation ponctuelle du risque de crédit de la plateforme si vous n’avez pas déjà activé les virements accélérés ou instantanés sur Stripe. L’activation des virements accélérés peut augmenter le risque de votre plateforme en permettant aux comptes connectés de retirer des fonds plus rapidement. Pour accéder à cette fonctionnalité pour les cartes bancaires ou ACH, contactez votre représentant commercial.

Amélioration des délais de virement

Les virements que vous créez sur les comptes financiers Fifth Third arrivent plus rapidement que ceux envoyés sur des comptes bancaires externes ou sur les comptes financiers Evolve.

Options de virement manuel

Vous disposez de deux options pour les virements manuels : standard et instant.

• Virements manuels standard : ceux-ci comprennent uniquement les fonds de paiements réglés, pas les fonds de paiements en attente. Les fonds réglés sont censés arriver dans les heures qui suivent, ce qui signifie que les nouveaux paiements par carte bancaire arrivent dans un délai d’environ 1 à 2 jours après la capture du paiement. Ce délai est une amélioration par rapport aux virements sur les comptes financiers Evolve ou les comptes bancaires externes, dans lesquels les fonds réglés arrivent environ 1 jour après la demande de virement, ou 2 à 3 jours après la capture du paiement. Stripe ne garantit pas un délai de virement précis.

• Virements instantanés : ces virements proviennent des fonds en attente et des fonds réglés. Lorsque vous acquérez un volume de paiements par carte bancaire, les fonds deviennent généralement disponibles dans le solde deux jours ouvrables après la réception des fonds. D’autres types de paiements, tels que les paiements ACH, prennent plus de temps. Les fonds sont en attente jusqu’à ce qu’ils soient disponibles. Lorsque vous créez un virement manuel instantané, vous pouvez inclure tous les fonds dans le solde instant_available. Les virements instantanés manuels sont censés arriver en quelques heures, un comportement similaire pour les comptes financiers Fifth Third comme pour les comptes financiers Evolve ou les comptes bancaires externes.

If your platform isn’t enabled for faster payouts and you’re interested in adding this ability, contact your sales representative or email us as treasury-support@stripe.com.

Options de virement automatique

Vous pouvez éventuellement configurer une fréquence des virements automatique pour chaque compte connecté. Stripe crée des virements à une fréquence que vous précisez (par exemple chaque jour) pour tous les fonds mis à disposition, et envoie les fonds sur le compte bancaire externe indiqué (par exemple le compte financier).

Vous pouvez contrôler la rapidité de vos virements automatiques en définissant deux paramètres dans settings.payouts.schedule :

• interval : vous pouvez définir la fréquence de virement des fonds. Cette fréquence peut être daily, weekly ou monthly. Vous pouvez aussi la définir sur manual, ce qui désactive les virements automatiques au profit d’appels manuels à l’API.
• delay_days : si votre entreprise est basée aux États-Unis, vous pouvez définir le nombre de jours ouvrables pendant lesquels les paiements sont en attente avant d’être mis à disposition pour les virements standards. La valeur par défaut est de 2 jours. Vous pouvez définir un nombre plus élevé pour réduire le risque ou un nombre plus faible pour accélérer l’accès aux fonds en attente.

Vous pouvez définir l’intervalle sur quotidien et le délai sur delay_days=2, auquel cas les fonds arrivent environ 1 à 2 jours après la capture du paiement. Ce délai constitue une amélioration par rapport au processus actuel avec Evolve, où les fonds arrivent généralement 2 à 3 jours après la capture du paiement.

Vous pouvez accélérer l’accès en définissant l’intervalle sur quotidien et le délai sur delay_days=1, auquel cas les fonds arrivent environ 1 jour ouvrable après la capture du paiement. Si vous souhaitez que les fonds arrivent en dehors des jours ouvrables, contactez votre représentant commercial.

Utilisez POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} pour mettre à jour la fréquence des virements.

Modifier des virements pour utiliser un compte financier Fifth Third

Configurer un compte financier pour les virements

Vous devez définir votre compte financier en tant que compte externe (l’objet BankAccount) connecté au compte Stripe approprié avant de pouvoir envoyer des virements vers un compte financier Treasury, ou en recevoir des recharges. Vous avez maintenant la possibilité de configurer un compte externe en précisant le champ id du compte financier. Vous devez également demander la fonctionnalité intra_stripe_flows sur votre compte financier.

• Comptes de plateforme : utilisez le Dashboard Stripe pour créer un objet BankAccount que vous pouvez utiliser pour les virements provenant de votre compte de plateforme ou pour les recharges qui lui sont destinées.
• Comptes connectés : utilisez POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}/external_accounts pour préciser le nouvel identifiant id du compte financier dans le paramètre financial_account afin de créer un objet BankAccount que vous pouvez utiliser pour les virements à partir d’un compte connecté.

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 renvoie les informations suivantes :

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

Créer un virement manuel

Après avoir configuré votre nouveau compte financier Fifth Third pour qu’il ait un identifiant id de compte bancaire, appelez POST /v1/payouts pour indiquer la valeur du paramètre de destination comme étant le nouvel identifiant id de compte bancaire.

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

Modifier la configuration d’un virement automatique

Si vous avez connecté des comptes sur votre plateforme avec une fréquence de virement automatique, vous pouvez envoyer des virements à leur nouveau compte financier Fifth Third. Réglez le paramètre default_for_currency sur true pour le compte externe que vous avez créé pour le compte financier Fifth Third.

Annulation de virements

Vous pouvez créer des annulations pour les virements effectués sur des comptes financiers dont la fonctionnalité ABA est active.

Recevoir des transactions sur le compte financier

Recevoir un crédit d’un FinancialAccount existant

Pour transférer des fonds d’un compte financier existant vers un compte financier Fifth Third, créez un OutboundTransfer ou OutboundPayment à partir du compte financier existant. Si vous saisissez l’identifiant d’un compte financier Fifth Third dans le champ destination_payment_method_data pour un OutboundPayment, la transaction est envoyée sur le réseau Stripe.

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"

Recevoir un crédit ou un débit d’une source externe

Fifth Third financial accounts receives externally addressable account and routing numbers (VBAN) after you request and enable the financial_addresses.aba feature. Your connected accounts can share the account and routing numbers for their Fifth Third financial account to received credits (wire and ACH) and received debits (ACH) from external parties. They can also use microdeposits to authenticate with the account.

Jusqu’à fin décembre 2024, vous ne pouvez recevoir que des débits d’un montant maximum de 500 000 USD par transaction. Si une partie externe émet un débit d’un montant supérieur à 500 000 USD, Stripe émettra un retour avec le code de retour ACH R29. Vous ne verrez aucun impact sur votre solde et le débit reçu n’apparaîtra pas dans votre liste de transactions. Lorsque nous supprimerons cette limite, nous en informerons toutes les plateformes en mode production avec Fifth Third.

Vous pouvez initier des annulations de débits en créant un DebitReversal. Vous devez créer un DebitReversal dans les 24 heures ; cependant, nous prolongerons ce délai dans les mois à venir. Jusqu’à ce que nous prenions en charge les CreditReversals, envoyez un e-mail au support Stripe pour annuler un crédit. Nous ne prenons pas en charge les annulations tardives à l’heure actuelle.

Émettre des cartes sur un compte financier Fifth Third

Votre intégration Issuing restera inchangée et vous n’aurez pas besoin de réémettre des cartes à vos utilisateurs. Vous aurez la possibilité de rediriger les cartes existantes des comptes financiers actuels vers les nouveaux comptes financiers Fifth Third sans affecter les utilisateurs. Il s’agit d’une nouvelle fonctionnalité qui n’est actuellement pas possible.

Vous pouvez modifier votre carte existante pour passer d’un compte financier existant à un nouveau compte financier Fifth Third :

Vous pouvez migrer une carte en la modifiant avec un nouvel identifiant de compte financier :

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

Stripe renvoie la réponse suivante :

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

Authorizations remain associated with the same financial account, even if the card is redirected to a different financial account. Any future card events impact the original financial account’s balance. For example, incremental authorization requests can occur up to 30 days later, depending on the spend category. To avoid unintended declines while you migrate to Fifth Third, we recommend partnering with Stripe on your migration.

Vous pouvez également émettre de nouvelles cartes qui prélèvent sur un compte financier Fifth Third en précisant l’identifiant du nouveau compte financier lors de la création d’une carte.

Vous pouvez créer un compte financier Fifth Third et demander la fonctionnalité card_issuing :

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 renvoie la réponse suivante :

{
  id: fa_123,
  ...
}

Ensuite, créez une nouvelle carte indiquant l’ID du compte financier :

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

Suivi des réclamations

Your complaints tracking process has one update. After your connected accounts start using Fifth Third Bank, the complaint_channel field for each complaint includes the following new channels:

• Employé
• Réglementaire
• Déclarant Pour le compte de
• Incident Bancorp
• Agence d’évaluation du crédit
• Fed
• CFPB
• BBB
• Conseil d’administration

No action is required until you receive an updated complaints tracker from Stripe.

Compte financier de la plateforme

Your platform’s financial account remains open at Evolve. For now, we won’t open a second platform financial account at Fifth Third Bank. However, we plan to introduce this option within a few months. Until then, instantly transfer funds from your platform financial account at Evolve to your connected accounts’ financial accounts at Fifth Third Bank using Stripe network transfers.