# Collecter les informations d'un compte bancaire pour utiliser les paiements par prélèvement automatique ACH avec les données du compte Utilisez les données relatives aux comptes, telles que les soldes, avec votre intégration des paiements. Vous ne savez pas quelle intégration Financial Connections utiliser ? Consultez notre [présentation des options d’intégration](https://docs.stripe.com/financial-connections/use-cases.md). Stripe propose plusieurs options pour accepter les paiements par transfert ACH de vos utilisateurs. Toutes ces méthodes nécessitent de [vérifier](https://docs.stripe.com/payments/ach-direct-debit.md#verification) le compte de l’utilisateur avant de pouvoir prélever son compte. Vous pouvez utiliser Financial Connections pour effectuer une vérification instantanée des comptes bancaires, ainsi que des fonctionnalités telles que la vérification du solde ou de la propriété. Lorsque vous utilisez Financial Connections pour vos flux ACH, vous pouvez : - Réduire votre taux d’échecs de paiement liés aux comptes clôturés ou inactifs - Améliorer le taux de conversion des paiements en maintenant la session de vos utilisateurs, au lieu de les obliger à quitter votre tunnel de paiement pour localiser leurs numéros de compte et de routage - Gagner du temps sur la phase de développement en éliminant la nécessité de créer un formulaire d’encaissement par compte bancaire personnalisé - Activer la collecte de données supplémentaires sur les comptes bancaires, notamment le solde et les informations sur le propriétaire ## Before you begin Financial Connections est la méthode de vérification par défaut pour tous les tunnels de paiement ACH hébergés, comme Checkout ou le Payment Element. Si vous utilisez un flux hébergé, passez directement à l’étape [Demander un accès aux données supplémentaires du compte](https://docs.stripe.com/financial-connections/ach-direct-debit-payments.md#access). Si vous ne l’avez pas encore fait, configurez votre intégration de manière à [encaisser les paiements ACH](https://docs.stripe.com/payments/ach-direct-debit/accept-a-payment.md?platform=web&ui=stripe-hosted). ## Activer Financial Connections Le paramètre `verification_method` de diverses ressources API contrôle si Financial Connections est activé pour la vérification du compte bancaire. Par défaut, la vérification s’effectue via Financial Connections, avec les microversements comme solution de secours. > Les comptes bancaires que vos clients associent par saisie manuelle ou par le biais de microversements ne fourniront pas d’accès à certaines données supplémentaires comme le solde, le propriétaire et les transactions. | Méthode de vérification | Description | | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------- | | `automatic` (par défaut) | Financial Connections avec la possibilité de saisir manuellement les coordonnées bancaires et d’utiliser des microversements | | `instant` | Financial Connections uniquement, sans saisie manuelle ni microversement | | `microdeposits` | Saisie manuelle et microversements uniquement | Cette option est disponible avec les API suivantes : Des étapes supplémentaires, telles que la collecte du mandat Nacha, sont requises pour les entreprises qui n’utilisent pas une intégration hébergée par Stripe comme Payment Element, Checkout ou Hosted Invoicing. Consultez [cette section du guide ACH](https://docs.stripe.com/payments/ach-direct-debit/accept-a-payment.md?platform=web&ui=direct-api#web-collect-details). - [PaymentIntent](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-payment_method_options-us_bank_account-verification_method) - [SetupIntent](https://docs.stripe.com/api/setup_intents/create.md#create_setup_intent-payment_method_options-us_bank_account-verification_method) - [CheckoutSession](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_method_options-us_bank_account-verification_method) - [Facture](https://docs.stripe.com/api/invoices/create.md#create_invoice-payment_settings-payment_method_options-us_bank_account-verification_method) - [Abonnement](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-payment_settings-payment_method_options-us_bank_account-verification_method) - [Payment Element](https://docs.stripe.com/js/elements_object/create_without_intent#stripe_elements_no_intent-options-paymentMethodOptions-us_bank_account-verification_method) ## Créer un client [Recommended] Nous vous recommandons de créer un objet *Customer* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments) contenant une adresse e-mail, qui représentera votre utilisateur et que vous pourrez ensuite associer à votre paiement. L’association d’un objet `Customer` vous permettra par la suite de [répertorier les comptes précédemment associés](https://docs.stripe.com/api/financial_connections/accounts/list.md). En renseignant une adresse e-mail et un numéro de téléphone dans l’objet `Customer`, vous permettez à Financial Connections d’améliorer le flux d’authentification en simplifiant l’inscription ou la connexion de votre utilisateur, selon qu’il s’agit d’un nouvel utilisateur de [Link](https://support.stripe.com/questions/link-for-financial-connections-support-for-businesses). ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ -d email={{CUSTOMER_EMAIL}} \ -d phone={{CUSTOMER_PHONE}} ``` ## Demander un accès aux données supplémentaires du compte Pour accéder à des données de comptes supplémentaires sur Financial Connections Accounts, vous devez d’abord soumettre votre formulaire d’inscription Financial Connections en vérifiant les paramètres [Financial Connections dans le Dashboard](https://dashboard.stripe.com/settings/financial-connections). Vous pouvez afficher cette page après avoir activé Financial Connections. Votre intégration détermine la manière dont vous configurez l’accès aux différents types de données de compte. #### Moyens de paiement dynamiques Si vous utilisez les [moyens de paiement dynamiques](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md) de Stripe afin de collecter des paiements ACH pour des cas d’usage hors Connect, vous pouvez configurer les données Financial Connections requises directement depuis la [page des paramètres ACH du Dashboard](https://dashboard.stripe.com/test/settings/payment_methods). Les numéros de compte et de routage sont toujours obligatoires pour les prélèvements ACH. Les autres types de données sont facultatifs. > Nous vous recommandons de configurer les autorisations dans le Dashboard car cela vous permet de modifier les données que vous collectez sans aucune modification du code. Pour remplacer la configuration du Dashboard, spécifiez les autorisations Financial Connections directement dans l’API. Procédez comme suit pour effectuer cette opération pour les PaymentIntents : ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=2000 \ -d currency=usd \ -d "customer={{CUSTOMER_ID}}" \ -d "automatic_payment_methods[enabled]=true" \ -d "payment_method_options[us_bank_account][financial_connections][permissions][]=payment_method" \ -d "payment_method_options[us_bank_account][financial_connections][permissions][]=balances" \ -d "payment_method_options[us_bank_account][financial_connections][permissions][]=ownership" \ -d "payment_method_options[us_bank_account][financial_connections][permissions][]=transactions" ``` #### Types de moyens de paiement Si vous transmettez `payment_method_types` dans l’API, vous devez spécifier explicitement les autorisations d’accès aux données Financial Connections que vous souhaitez pour chaque Appel à l’API. Pour effectuer cette opération pour [CheckoutSession](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_method_options-us_bank_account-financial_connections-permissions) : ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ --data-urlencode "success_url=https://example.com/success" \ -d "line_items[0][price]={PRICE_ID}" \ -d "line_items[0][quantity]=1" \ -d "payment_method_options[us_bank_account][financial_connections][permissions][0]=payment_method" \ -d "payment_method_options[us_bank_account][financial_connections][permissions][1]=balances" \ -d "payment_method_options[us_bank_account][financial_connections][permissions][2]=ownership" \ -d "payment_method_options[us_bank_account][financial_connections][permissions][3]=transactions" ``` ## Utiliser des données avec votre intégration ACH Après que l’accès aux données bancaires supplémentaires sur les soldes ou la propriété d’un compte bancaire a été approuvé, vous pouvez utiliser ces données pour améliorer les performances des paiements ACH. Vous pouvez, par exemple, utiliser les données du solde pour réduire le risque d’échec des paiements liés à des fonds insuffisants. Consultez les guides de données associés pour voir quelques exemples : - [Soldes](https://docs.stripe.com/financial-connections/balances.md) : consultez le solde du compte avant d’initier le paiement pour réduire le nombre de cas de *fonds insuffisants* (A shorthand way of referring to the Non-sufficient Funds ACH return code R01). - [Propriété](https://docs.stripe.com/financial-connections/ownership.md) : consultez les propriétaires de comptes et comparez-les à vos modèles de données internes pour détecter les tentatives de fraude. - [Transactions](https://docs.stripe.com/financial-connections/transactions.md) : consultez l’historique des transactions d’un compte pour vérifier quand les recettes du client sont susceptibles d’arriver. > L’API Risk Intelligence est une fonctionnalité en version bêta qui fournit des données agrégées supplémentaires pour faciliter la gestion des risques, telles que le solde moyen du compte sur les 30/60/90 derniers jours, le nombre total de transactions de crédit sur les 30/60/90 derniers jours, et plus encore. Si vous souhaitez utiliser cette fonctionnalité en version bêta, [envoyez-nous un e-mail](mailto:financial-connections-beta+risk-intelligence@stripe.com) pour obtenir l’accès. ### Trouver l’ID d’un compte Financial Connections Pour initier l’actualisation des données et récupérer les données d’un compte Financial Connections, vous devez d’abord obtenir l’ID du compte à partir du moyen de paiement associé en développant la propriété `payment_method` du PaymentIntent : ```curl curl -G https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT}} \ -u "<>:" \ -d "expand[]=payment_method" ``` L’ID du compte Financial Connections se trouve dans le [hachage `us_bank_account`](https://docs.stripe.com/api/payment_methods/object.md#payment_method_object-us_bank_account) du moyen de paiement développé. Si vous autorisez la [saisie manuelle de secours](https://docs.stripe.com/financial-connections/ach-direct-debit-payments.md#enable) et que l’utilisateur a saisi manuellement ses informations de compte, ce champ est `null`. ```json { "id": "pi_3OK3g4FitzZY8Nvm11121Lhb", "object": "payment_intent", "payment_method": { "us_bank_account": {"financial_connections_account": "fca_1OK123bitUAA8SvmruWkck76" } // ... other fields on the Payment Method } // ... other fields on the Payment Intent } ```