Accepter un paiement par prélèvement automatique ACH

Une session Checkout doit remplir toutes les conditions suivantes pour prendre en charge les paiements par prélèvement automatique ACH :

• Les tarifs de tous les postes doivent être exprimés en dollars américains (code de devise usd).

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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d email={{CUSTOMER_EMAIL}}

Ce guide vous montre comment activer le prélèvement automatique ACH comme moyen de paiement et vous explique les différences entre l’acceptation d’un paiement par carte et l’utilisation de ce moyen de paiement.

Activer les prélèvements automatiques ACH comme moyen de paiement

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

1. Ajouter us_bank_account à la liste des payment_method_types.
2. Veiller à ce que tous vos postes de facture line_items utilisent la devise usd.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d mode=payment \
  -d customer={{CUSTOMER_ID}} \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=us_bank_account \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][quantity]"=1 \
  --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.

Si le client opte pour la vérification par microversements au lieu de la vérification par Financial Connections, Stripe envoie automatiquement deux versements de faible montant au compte bancaire indiqué. Ces versements apparaissent sur le relevé bancaire en ligne du client sous deux jours ouvrables. Le client reçoit alors un lien par e-mail afin confirmer ces montants et vérifier son compte bancaire auprès de Stripe. Une fois la vérification terminée, le traitement du paiement commence.

Lorsque vous créez une session en mode paiement pour un prélèvement automatique ACH, nous vous recommandons d’inclure le paramètre payment_intent_data.setup_future_usage et de le définir sur off_session. Vous pourrez ainsi enregistrer les informations du moyen de paiement.

Traiter vos commandes

Après avoir accepté un paiement, découvrez comment réaliser les commandes.

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

Envoyer des e-mails de transaction en mode test

Après avoir collecté les coordonnées bancaires et obtenu l’acceptation du mandat, envoyez les e-mails de confirmation du mandat et de vérification du microversement en mode test. Pour cela, saisissez une adresse e-mail dans le champ payment_method_data.billing_details[email] au format {any-prefix}+test_email@{any_domain} au moment de collecter les informations du moyen de paiement.

Test account numbers

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.