Enregistrer les informations pour les futurs paiements par prélèvement automatique ACH

Créez un objet Customer lorsque votre client crée un compte auprès de votre entreprise, ou récupérez l’objet Customer existant associé à cet utilisateur. L’association de l’ID de l’objet Customer à votre propre représentation interne d’un client vous permet de récupérer et d’utiliser ultérieurement les informations de paiement enregistrées. Ajoutez une adresse e-mail à l’objet Customer pour activer l’optimisation des utilisateurs connus de Financial Connections.

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d email={{CUSTOMER_EMAIL}}

Lors de la création d’une nouvelle session Checkout, vous devez :

1. Ajoutez us_bank_account à la liste des payment_method_types.
2. Veillez à ce que tous vos postes line_items utilisent la devise usd.
3. Définissez le paramètre permissions de manière à inclure payment_method.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d mode=setup \
  -d customer={{CUSTOMER_ID}} \
  -d "payment_method_types[]"=card \
  -d "payment_method_types[]"=us_bank_account \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

Par défaut, lors de la collecte des coordonnées bancaires, Financial Connections est utilisé pour vérifier instantanément le compte de votre client. Une option de secours comprenant la saisie manuelle du numéro de compte et la vérification par microversement peut être utilisée. Consultez la documentation relative à Financial Connections pour savoir comment configurer Financial Connections et accéder à des données de compte supplémentaires de façon à optimiser votre intégration ACH. Par exemple, vous pouvez utiliser Financial Connections pour consulter le solde d’un compte avant d’initier le paiement ACH.

Pendant la session Checkout, une boîte de dialogue s’affiche et offre au client la possibilité d’utiliser la vérification instantanée ou de fournir ses coordonnées bancaires pour la vérification à l’aide de microversements.

Si le client choisit la vérification à l’aide de micro-versements, Stripe envoie automatiquement deux versements d’un faible montant au compte bancaire indiqué. Ces dépôts peuvent prendre 1 à 2 jours ouvrables avant d’apparaître sur le relevé bancaire en ligne du client. Lorsque les versements arrivent, le client reçoit un e-mail contenant un lien pour confirmer ces montants et vérifier le compte bancaire avec Stripe. Une fois la vérification terminée, le traitement du paiement commence.

Découvrez comment tester des scénarios avec des vérifications instantanées à l’aide de Financial Connections.

Envoyer des e-mails de transaction dans un environnement de test

Une fois que vous avez collecté les coordonnées bancaires et accepté un mandat, envoyez les courriels de confirmation du mandat et de vérification du microversement dans un environnement de bac à sable.

Si votre domaine est {domain} et que votre nom d’utilisateur est {username}, utilisez le format d’e-mail suivant pour envoyer des e-mails de transaction de test : {username}+test_email@{domain}.

Par exemple, si votre domaine est example.com et que votre nom d’utilisateur est info, utilisez le format info+test_email@example.com pour tester les paiements ACH Direct Debit. Ce format garantit que les e-mails sont acheminés correctement. Si vous n’incluez pas le suffixe +test_email, nous n’enverrons pas l’e-mail.

Numéros de comptes de test

Stripe fournit plusieurs numéros de compte de test et les tokens correspondants que vous pouvez utiliser pour vous assurer que votre intégration pour les comptes bancaires saisis manuellement est prête à passer en mode production.

Avant d’effectuer les transactions de test, vous devez vérifier tous les comptes de test pour lesquels le paiement aboutit ou échoue automatiquement. Pour ce faire, utilisez les codes de libellé ou les montants de microversements de test ci-dessous.

Tester des codes de libellé et des montants de microversements

Pour simuler différents scénarios, utilisez ces montants de microversements ou ces codes de libellé 0.01.

Comportement de règlement des tests

Les transactions de test sont réglées instantanément et ajoutées à votre solde de test disponible. Ce comportement diffère de celui du mode production, où les transactions peuvent prendre plusieurs jours pour être réglées dans votre solde disponible.

Une fois la session Checkout terminée, vous pouvez collecter l’ID de PaymentMethod. Vous pouvez utiliser ces ID de PaymentMethod pour initier des paiements futurs sans avoir à demander une deuxième fois au client son compte bancaire.

Lors de la création d’un PaymentIntent, fournissez les ID de payment_method et de client pour débiter votre client à l’aide de ses coordonnées bancaires enregistrées.