Réaliser une intégration avec Fifth Third BankBêta
Ajoutez Fifth Third Bank à votre intégration Stripe Treasury.
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.
Si vous utilisez déjà Stripe Treasury, ce guide décrit comment démarrer avec Fifth Third Bank dans votre intégration existante. Vous pouvez créer et gérer des comptes connectés possédant des comptes financiers à la fois chez Evolve et Fifth Third Bank. D’ici la fin du mois d’octobre 2024, Stripe Treasury prendra en charge la parité des fonctionnalités Treasury entre les deux partenaires bancaires. Vous pouvez utiliser ce guide pour déterminer s’il convient d’introduire les fonctionnalités Fifth Third Bank auprès de vos utilisateurs et de quelle manière.
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.
Chaque compte connecté peut créer et gérer un ou plusieurs comptes financiers Treasury, dont chacun représente un compte admissible à l’assurance FDIC. Chacun des comptes financiers Treasury est créé avec un partenaire bancaire (historiquement avec Evolve et désormais également avec l’option d’utiliser Fifth Third Bank). Chaque compte connecté peut avoir jusqu’à trois comptes financiers au total parmi les partenaires bancaires, à moins que votre plateforme n’ait obtenu l’autorisation d’augmenter cette limite. Si vous souhaitez augmenter cette limite pour des raisons professionnelles, veuillez contacter votre représentant commercial ou nous envoyer un e-mail.
Chaque compte financier d’Evolve et de la Fifth Third Bank peut recevoir des fonds du solde des paiements Connect, et peut transférer des fonds vers et depuis d’autres comptes financiers et comptes bancaires externes.
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 :
- 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.
- 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.
- Vous pouvez utiliser une nouvelle fonctionnalité,
treasury_
, pour gérer la conformité de vos comptes connectés.fifth_ third
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.
Avant de commencer l’intégration
Planifier la façon dont vous présentez les fonctionnalités Fifth Third Bank
Réfléchissez à la manière d’introduire les comptes financiers Fifth Third dans votre produit en fonction de votre modèle économique et des exigences de l’utilisateur. Planifiez également la séquence des opérations de transfert vers Fifth Third Bank.
Disponibilité des fonctionnalités sur Fifth Third Bank
Voir le tableau suivant pour les fonctionnalités de Stripe Treasury actuellement disponibles pour Fifth Third Bank.
Catégorie | Fonctionnalité |
---|---|
Inscrire et déposer des fonds auprès de Fifth Third Bank | Inscrire des comptes connectés en toute conformité |
Créer des comptes financiers après de Fifth Third Bank qui sont éligibles à l’assurance transfert de la FDIC | |
Les comptes financiers sont accompagnés d’un identifiant Stripe FinancialAccount | |
Les comptes financiers peuvent demander un numéro de compte et un numéro de routage pouvant être communiqués à l’extérieur financial_addresses.aba), ce qui leur permet de recevoir des crédits et des débits externes | |
Créer des transactions pour le compte financier | Les comptes connectés peuvent transférer des fonds (OutboundTransfer) du compte financier Fifth Third vers d’autres comptes financiers (Evolve ou Fifth Third Bank) à l’aide du réseau Stripe |
Les comptes connectés peuvent créer des crédits (OutboundTransfer ou OutboundPayment) à partir du compte financier à l’aide d’un prélèvement ACH ou par virement bancaire | |
Les comptes connectés peuvent créer des débits (InboundTransfer) à partir des comptes qu’ils possèdent vers le compte financier par prélèvement ACH (de soi à soi) | |
Virements depuis Stripe Payments | Vous ou vos comptes connectés pouvez acquérir des fonds en utilisant Stripe Payments, puis créer des virements vers le compte financier Fifth Third (des autres à soi) |
Vous ou vos comptes connectés pouvez créer des virements instantanés pour accéder aux fonds en attente | |
Recevoir des transactions sur le compte financier | Les comptes financiers peuvent recevoir des crédits (ReceivedCredit) par ACH ou par virement. |
Les comptes financiers peuvent recevoir des débits (ReceivedDebit) par prélèvement ACH et créer des annulations (DebitReversal) | |
Cartes Issuing | Les cartes Issuing peuvent être financées par le compte financier Fifth Third |
Une carte Issuing existante peut être mise à jour pour désigner un compte financier différent |
Après avoir lancé ces fonctionnalités pour Fifth Third Bank, nous développerons d’autres fonctionnalités, y compris les suivantes :
- Capture de dépôts à distance pour le dépôt de chèques
- Prélèvement ACH le jour même pour les transferts/paiements sortants et les transferts entrants
- Compte financier de la plateforme chez Fifth Third Bank
- Fermer les comptes financiers avec Fifth Third à l’aide de l’API
- 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é {_
sur un compte financier avec la banque fifth_
. »
Note
La feuille de route ci-dessus a pour but de présenter l’orientation générale de notre produit (et nos priorités actuelles) et n’est présentée qu’à titre d’information. Il ne s’agit pas d’un engagement de livraison de matériel, de code ou de fonctionnalité, et vous ne devez pas vous y fier pour vos décisions d’achat. Le développement, la publication et le calendrier de toute fonctionnalité décrite pour les produits Stripe restent à la seule discrétion de Stripe.
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.
Accéder à Fifth Third Bank en mettant à jour les déclarations
Pour accéder à Fifth Third en mode test, contactez votre représentant commercial Stripe. Pour accéder à Fifth Third Bank en mode production, vous devez soumettre les éléments suivants à l’équipe de conformité de Stripe pour approbation :
- Toute expérience utilisateur en mode production ou en projet, ou tout support de marketing qui mentionne un partenaire bancaire
- Mise à jour de tout document faisant référence à l’admissibilité à l’assurance transfert de la FDIC
- Expérience utilisateur comprenant les soldes des utilisateurs avec les déclarations, les relevés bancaires et l’historique des transactions
Vous devez envoyer des aperçus de vos mises à jour planifiées à l’aide du formulaire d’admission. Une fois que l’équipe de conformité de Stripe aura terminé l’examen, nous vous accorderons l’accès à Fifth Third en mode production. Vous pourrez ensuite publier vos déclarations approuvées.
Déclarations du partenaire bancaire
Vous devez mettre à jour toute partie de votre intégration actuelle (y compris les ressources marketing, les pages d’accueil, les autres sites Web, les tableaux de bord, etc.) qui affiche une déclaration pour les partenaires bancaires existants afin d’inclure également les informations concernant Fifth Third Bank.
Si vous avez l’intention de détenir les fonds des utilisateurs à la fois chez Evolve et Fifth Third Bank, votre déclaration doit être libellée comme suit : « [Nom de l’entreprise] s’associe à Stripe Payments Company pour les services de transmission de fonds et les services de compte avec les fonds détenus par Fifth Third Bank et Evolve Bank and Trust, membres de la FDIC ». Si vous ne détenez les fonds des utilisateurs que chez un seul partenaire bancaire, vous pouvez modifier le texte ci-dessus pour nommer le partenaire bancaire approprié.
Déclarations sur l’admissibilité à l’assurance transfert de la FDIC
Si vous faites référence à l’admissibilité à l’assurance transfert de la FDIC quelque part dans votre intégration existante, ou si vous prévoyez d’introduire de nouvelles références, vous devez accompagner ce texte de la déclaration approuvée suivante. Ce texte est différent de notre exemple précédent. Modifiez-le en conséquence.
Les comptes Stripe Treasury sont admissibles à la garantie des dépôts de l’assurance transfert de la FDIC s’ils satisfont à certaines exigences. Les comptes ne sont admissibles que dans la mesure où l’assurance transfert est autorisée par la réglementation de la FDIC, et si les exigences relatives à l’assurance transfert sont remplies. L’assurance de la FDIC s’applique jusqu’à 250 000 USD par déposant et par établissement financier, pour les dépôts détenus par un même titulaire.
En savoir plus sur les déclarations de la FDIC.
Mettre à jour l’interface utilisateur de votre produit afin d’afficher plusieurs partenaires bancaires
Soldes
Dans l’interface utilisateur de votre produit, affichez chaque solde séparément lorsqu’un utilisateur a des soldes auprès de deux partenaires bancaires (par exemple, l’ancien partenaire et Fifth Third Bank). Veillez à ce que les utilisateurs puissent voir clairement quelle banque est associée à chaque solde. Si vous êtes certain que l’un des soldes sera toujours de 0 USD, consultez votre conseiller juridique et service de conformité pour décider s’il convient ou non d’afficher ce solde et de quelle manière. Indiquez clairement aux utilisateurs le nombre de comptes financiers qu’ils ont ouverts, les établissements qui détiennent ces comptes et s’ils ont un solde supérieur à 0 USD.
Vous devez fournir une déclaration spécifique pour chaque solde individuel, en indiquant dans quelle banque le solde est détenu. Ainsi, le compte connecté a connaissance de ses limites d’assurance potentielles auprès de chaque banque.
Historique des transactions
Vous pouvez conserver un seul historique des transactions par compte connecté, mais vous devez afficher des informations concernant les deux comptes financiers (telles que l’activité des transactions, les soldes d’ouverture et de clôture, les frais, les intérêts, etc.) Si vous proposez un historique des transactions unique, veillez à ce que l’utilisateur sache clairement quel compte financier est associé à chaque transaction.
Si vous activez le transfert ABA, vous devez autoriser le compte connecté à visualiser les trois reçus de transaction associés à chaque transaction transférée, et non pas un seul reçu de transaction. Vous pouvez générer ces reçus en utilisant les reçus réglementaires hébergés de Stripe. De cette manière, vous pouvez représenter chaque transaction transmise une seule fois, et non pas individuellement comme trois transactions.
Découvrez comment planifier la séquence du transfert des opérations vers Fifth Third et maintenir simultanément deux partenaires bancaires.
Relevés
Vous devez soit présenter un seul relevé comprenant tous les soldes et toutes les opérations sur les comptes financiers, soit fournir plusieurs relevés, un pour chaque compte financier. Cette règle s’applique tant que les deux comptes financiers sont ouverts et qu’ils ont fait l’objet d’au moins une transaction au cours du mois.
Mode test
Vous devez utiliser les mêmes API en mode production pour Fifth Third Bank que pour Evolve. Par conséquent, Fifth Third Bank ne diffère d’Evolve que dans trois domaines en mode test :
- Lorsque vous créez un compte financier avec Fifth Third Bank en mode test, vous pouvez préciser
features[financial_
. Tous les comptes financiers en mode test reçoivent des adresses avecaddresses][aba][bank]="fifth_ third" Stripe Test Bank
au lieu d’un partenaire bancaire réel spécifique comme Fifth Third Bank. Les flux de transfert de fonds sont identiques pour tous les comptes en mode test. - Vous pouvez demander la nouvelle fonctionnalité
treasury_
en mode test.fifth_ third - Vous pouvez tester le transfert ABA en mode test.
Compte financier de la plateforme
Le compte financier de votre plateforme reste ouvert chez Evolve. Pour l’instant, nous n’ouvrirons pas de deuxième compte financier de plateforme auprès de Fifth Third Bank. Cependant, nous prévoyons de l’introduire d’ici quelques mois. D’ici là, transférez instantanément des fonds depuis le compte financier de votre plateforme chez Evolve vers les comptes financiers de vos comptes connectés chez Fifth Third Bank en utilisant les transferts du réseau Stripe.
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_
(nouveau et requis pour l’accès à Fifth Third Bank)fifth_ third - Continuez à demander les mêmes fonctionnalités que celles que vous demandez actuellement.
Lorsque vous demandez des fonctionnalités, le requirements.
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_
pour mettre à jour le compte avec l’identifiant associé avec une demande pour la fonctionnalité treasury_
La demande de la fonctionnalité treasury_
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. C’est différent 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_
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 :
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_
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ésfifth_ third card_
etpayments us_
, en d’autres termes, vous aurez probablement déjà collecté une URL si vous demandez l’une ou l’autre de ces fonctionnalités.bank_ account_ ach_ payments 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_
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_
et treasury
, vous pouvez utiliser votre compte connecté pour créer des comptes financiers chez Evolve et Fifth Third Bank.
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_
, 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.
Note
Si vous avez déjà reçu l’approbation de Stripe pour vos comptes connectés avec Fifth Third Bank et que vous mettez à jour l’URL ou la description du produit de votre compte connecté, Stripe réévaluera le compte pour la prise en charge. Le résultat peut changer ou déclencher un nouvel examen.
Dépannage des codes d’erreur du plan de conformité
Lorsque vous demandez la fonctionnalité treasury_
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_
: 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,url_ format .
oucom .
).org invalid_
: l’URL soumise se trouve sur une « liste d’exclusion » de Stripe. Contactez-nous pour obtenir de l’aide.url_ denylisted invalid_
: 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.url_ website_ inaccessible invalid_
: l’URL que vous avez soumise renvoie un code d’erreur d’étaturl_ website_ incomplete 404
.Invalid_
: si Stripe renvoie cette erreur, contactez-nous pour obtenir de l’aide.url_ website_ other
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_
et ajoutez l’identifiant du compte connecté comme valeur de l’en-tête Stripe-Account header
de l’appel.
Précisez features[financial_
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.
Jusqu’à ce que les comptes avec adresse externe soient disponibles chez Fifth Third Bank en octobre, vous devez également préciser features[financial_
pour vos comptes financiers. Une fois qu’ils seront disponibles, demandez un numéro de compte et un numéro de routage pouvant être communiqués à l’extérieur (financial_
) en indiquant features[financial_
.
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_
, outbound_
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 {_
sur un compte financier avec la banque fifth_
».
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 pager 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 à l’aide de l’API, vous pouvez nous contacter pour clôturer votre compte financier.
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_
oufeatures restricted_
reflètent ce changement.features
- Indique qu’une ou plusieurs fonctionnalités ont changé d’état. Les tableaux
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.
API Stripe | À partir du compte financier, vous recevez ou créez… | …un crédit ou un débit… | …entraînant l’entrée ou la sortie de fonds du compte financier… | …à l’aide de la voie de paiement ACH, d’un virement bancaire ou du réseau Stripe |
---|---|---|---|---|
OutboundTransfer et OutboundPayment | Créer | Crédit | Sortie | Prélèvement ACH, virement bancaire, réseau Stripe (vers un compte financier) |
InboundTransfer | Créer | Débit | Entrée | ACH |
ReceivedCredit | Recevoir | Crédit | Entrée | Prélèvement ACH, virement bancaire, réseau Stripe (à partir d’un compte financier) |
ReceivedDebit | Recevoir | Débit | Sortie | ACH |
Virements | S.O. | S.O. | Entrée | Réseau Stripe (à partir du solde Payments) |
Issuing | S.O. | S.O. | Sortie | Carte bancaire |
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_
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_
et tracking_
.
Pour les virements envoyés à l’aide de CHIPS, localisez le numéro de séquence système du transfert dans le champ tracking_
. 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 :
Evolve | Fifth Third Bank | |
---|---|---|
Virement télégraphique | 16 h 00 heure de l’Est | 17 h 00 heure de l’Est |
ACH | 19 h 00 heure de l’Est | 20 h 30 heure de l’Est |
ACH le jour même | 12 h 00 heure de l’Est | 13 h 00 heure de l’Est |
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.
D’ici fin octobre 2024, les comptes financiers recevront un numéro de compte et un numéro de routage qui peuvent être communiqués à l’extérieur. En attendant, les destinataires verront les virements effectués à partir d’un compte central appartenant à Stripe (avec le numéro de routage 042000314
). Ces transferts fonctionneront comme prévu, avec un libellé personnalisé pour fournir un contexte sur l’émetteur. Lorsque les comptes financiers recevront leur propre compte et leur propre numéro de routage, les transferts afficheront ces informations.
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_
) 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.days=1
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.
Virements externes et virements sur les comptes financiers Evolve | Virements sur les comptes financiers Fifth Third | |
---|---|---|
Virement manuel standard | Les fonds réglés arrivent dans un délai d’environ 1 jour. Les fonds acquis arrivent dans un délai d’environ 2 à 3 jours après la capture du paiement. Disponible uniquement pendant les heures d’ouverture. | Les fonds réglés arrivent dans un délai d’environ 1 jour. Les fonds acquis arrivent dans un délai d’environ 2 à 3 jours après la capture du paiement. Disponible uniquement pendant les heures d’ouverture. |
Virement manuel instantané | Dans l’heure qui suit | Dans l’heure qui suit |
Fréquence de virement automatique standard (delay_ ) | Les fonds réglés arrivent dans un délai d’environ 2 à 3 jours après la capture du paiement. Disponible uniquement les jours ouvrables. | Les fonds réglés arrivent dans un délai d’environ 1 à 2 jours après la capture du paiement. Disponible uniquement les jours ouvrables. |
Fréquence de virement automatique accélérée (delay_ ) | Environ 1 jour après la capture du paiement. Disponible uniquement les jours ouvrables. | Environ 1 jour après la capture du paiement. Disponible uniquement les jours ouvrables. |
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_
. 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.available
Si votre plateforme n’est pas activée pour des virements accélérés et que vous souhaitez ajouter cette fonctionnalité, contactez votre représentant commercial ou envoyez-nous un e-mail.
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 êtredaily
,weekly
oumonthly
. Vous pouvez aussi la définir surmanual
, ce qui désactive les virements automatiques au profit d’appels manuels à l’API.delay_
: 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.days
Vous pouvez définir l’intervalle sur quotidien et le délai sur delay_
, 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_
, 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_
pour préciser le nouvel identifiantACCOUNT_ ID}}/external_ accounts id
du compte financier dans le paramètrefinancial_
afin de créer un objetaccount BankAccount
que vous pouvez utiliser pour les virements à partir d’un compte connecté.
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.
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_
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_
pour un OutboundPayment, la transaction est envoyée sur le réseau Stripe.
Recevoir un crédit ou un débit d’une source externe
En octobre, les comptes financiers Fifth Third recevront des numéros de compte et de routage qui peuvent être communiqués à l’extérieur (VBAN) une fois la fonctionnalité financial_
demandée et activée. Vos comptes connectés pourront partager les numéros de compte et de routage de leur compte financier Fifth Third pour des crédits reçus (virement et ACH) et des débits reçus (ACH) de parties externes. Ils pourront également utiliser les microversements pour s’authentifier avec le compte.
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 service d’assistance Stripe pour annuler un crédit.
É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 :
Stripe renvoie la réponse suivante :
{ "id": <card Id>, "object": "issuing.card", "financial_account": <new Financial Account Id>, ... }
Les autorisations restent associées au même compte financier, même si la carte est redirigée vers un autre compte financier. Si d’autres événements liés à la carte se produisent, ils auront une incidence sur le solde du compte financier d’origine. Par exemple, les demandes d’autorisation supplémentaires peuvent survenir jusqu’à 30 jours plus tard, en fonction de la catégorie de dépenses. Pour éviter les refus involontaires, nous vous recommandons d’utiliser le transfert ABA. En savoir plus sur la configuration du transfert ABA lors de votre 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_
:
Stripe renvoie la réponse suivante :
{ id: fa_123, ... }
Ensuite, créez une nouvelle carte indiquant l’ID du compte financier :
Suivi des réclamations
Votre processus de suivi des réclamations a été mis à jour. Après l’ajout de Fifth Third Bank, le champ complaint_
pour chaque réclamation inclut les nouveaux canaux suivants :
- Employé
- Réglementaire
- Déclarant Pour le compte de
- Incident Bancorp
- Agence d’évaluation du crédit
- Fed
- CFPB
- BBB
- Conseil d’administration