Prélèvement ACH

Le prélèvement ACH permet aux clients aux États-Unis de payer directement depuis leur compte bancaire au lieu d’utiliser une carte. Il fonctionne sur le réseau Automated Clearing House et est proposé lors des checkouts en USD pour les paiements ponctuels.

Pourquoi proposer le prélèvement ACH ?

Lower Processing Cost

Les débits bancaires coûtent généralement moins cher à traiter que les paiements par carte, en particulier pour les commandes de montant élevé.

No Card Required

Touchez les clients américains qui préfèrent payer depuis un compte bancaire ou qui ne souhaitent pas utiliser de carte pour les achats importants.

Higher Value Orders

L’avantage en termes de coût par rapport aux cartes augmente avec la valeur de la commande, ce qui rend l’ACH particulièrement adapté aux achats ponctuels importants.

Présentation

Détail	Valeur
Devise de facturation	USD
Pays pris en charge	États-Unis
Abonnements	Non
Montant minimal	$0.50
Règlement	4 jours ouvrés

Le prélèvement ACH n’est pas instantané. Un paiement prend 4 jours ouvrés pour être confirmé. Ne considérez donc pas l’autorisation comme un règlement : n’exécutez la commande qu’une fois le paiement passé à l’état succeeded.

Fonctionnement

Expérience client

Le client sélectionne le prélèvement ACH lors du checkout
Le client autorise le débit sur son compte bancaire américain
Le paiement est soumis au réseau ACH et passe à l’état processing
La compensation s’effectue au cours des jours ouvrés suivants
Le paiement passe à l’état succeeded ou échoue si la banque le retourne

La compensation étant asynchrone, utilisez les webhooks pour connaître le résultat final plutôt que la redirection du checkout. Une redirection réussie signifie uniquement que le client a autorisé le débit.Le paiement émet payment.processing une fois le débit soumis, puis payment.succeeded ou payment.failed lorsque la compensation est terminée. Seul payment.succeeded permet d’exécuter la commande en toute sécurité.

Disponibilité

Le prélèvement ACH apparaît lors du checkout lorsque toutes les conditions suivantes sont réunies :

La devise de facturation est USD
Le pays de facturation est US
La transaction est un paiement ponctuel

Le prélèvement ACH n’est pas disponible pour les abonnements. Son délai de compensation de plusieurs jours ne convient pas aux cycles de facturation récurrents. Pour les paiements récurrents, utilisez des cartes ou une autre méthode compatible avec les abonnements — consultez la présentation des méthodes de paiement.

Configuration

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['ach', 'credit', 'debit'],
  billing_currency: 'USD',
  billing_address: {
    country: 'US',
    zipcode: '94102'
  },
  return_url: 'https://example.com/success'
});

Le prélèvement ACH nécessite une devise de facturation USD et une adresse de facturation aux États-Unis. Si vous indiquez vos prix dans une autre devise, activez Adaptive Currency afin que les clients américains soient facturés en USD et que l’ACH soit disponible.

Type de méthode API

Type	Méthode	Pays
`ach`	Prélèvement ACH	États-Unis

Remboursements et litiges

Les remboursements et les litiges liés aux paiements ACH utilisent les mêmes APIs et les mêmes flux du dashboard que toutes les autres méthodes de paiement : aucune gestion spécifique à l’ACH n’est nécessaire.

Les paiements ACH pouvant être retournés par la banque du client après avoir semblé aboutir, évitez d’émettre des remboursements tant que le paiement d’origine n’est pas passé à l’état succeeded.

Tests

Enable test mode

Utilisez vos clés API de test Dodo Payments.

Set currency and billing address

Définissez la devise de facturation sur USD et le pays de l’adresse de facturation sur US.

Include `ach` in allowed methods

Transmettez ach dans allowed_payment_method_types, ou omettez entièrement le champ pour afficher toutes les méthodes éligibles.

Enter the test bank details

Saisissez l’une des paires de numéros d’acheminement et de compte de test ci-dessous, puis vérifiez que votre gestionnaire de webhook reçoit le statut final du paiement.

Comptes bancaires de test

Les clients saisissent directement leur numéro de compte et leur numéro d’acheminement lors du checkout. En mode test, utilisez le numéro d’acheminement 110000000 avec l’un des numéros de compte ci-dessous pour forcer un résultat spécifique.

Numéro de compte	Numéro d’acheminement	Comportement
`000123456789`	`110000000`	Le paiement réussit.
`000222222227`	`110000000`	Le paiement échoue pour insuffisance de fonds.
`000111111113`	`110000000`	Le paiement échoue car le compte est clôturé.
`000111111116`	`110000000`	Le paiement échoue car aucun compte n’est trouvé.
`000333333335`	`110000000`	Le paiement échoue car les débits ne sont pas autorisés sur le compte.
`000444444440`	`110000000`	Le paiement échoue en raison d’une devise invalide.
`000555555559`	`110000000`	Le paiement réussit, puis déclenche un litige.
`000000000009`	`110000000`	Le paiement reste indéfiniment à l’état processing, ce qui est utile pour tester une interface utilisateur d’état pending.

La plupart des paiements de test atteignent un statut final bien plus rapidement que le délai de compensation en production. Vous n’avez donc pas besoin d’attendre plusieurs jours pour vérifier votre intégration. L’exception est 000000000009, qui est conçu pour rester à l’état processing.

Bonnes pratiques

Don't fulfill on authorization

L’autorisation ACH n’est pas un paiement. Attendez que le paiement passe à l’état succeeded avant d’accorder l’accès ou d’expédier la commande : le débit peut encore être retourné par la banque du client.

Set customer expectations at checkout

Informez les clients que les paiements bancaires ne sont pas compensés instantanément. Cela réduit les tickets d’assistance demandant pourquoi une commande est toujours en attente.

Provide card fallbacks

Incluez toujours credit et debit avec ach afin que les clients ayant besoin d’un accès instantané à votre produit puissent choisir une méthode plus rapide.

Use ACH for high-value one-time purchases

L’avantage en termes de coût de l’ACH augmente avec la valeur de la commande. Il est donc particulièrement utile pour les achats ponctuels importants plutôt que pour les petits achats.

Résolution des problèmes

ACH not appearing at checkout

Vérifiez :

La devise de facturation est-elle définie sur USD ?
Le pays de facturation du client est-il US ?
ach est-il inclus dans allowed_payment_method_types ?
S’agit-il d’un paiement ponctuel ? L’ACH n’est pas proposé pour les abonnements.

Solution : Supprimez temporairement allowed_payment_method_types pour afficher toutes les méthodes éligibles, puis vérifiez la devise et le pays de l’adresse de facturation dans votre requête API.

ACH not appearing on a subscription checkout

Cause : Le prélèvement ACH est proposé uniquement pour les paiements ponctuels.Solution : Utilisez des cartes ou une autre méthode compatible avec les abonnements pour la facturation récurrente.

Payment stuck in processing

Cause : Ce comportement est attendu. Les paiements ACH restent à l’état processing pendant toute la durée de la compensation, bien plus longtemps que les paiements par carte.Solution : Attendez le webhook final. Ne relancez pas le paiement : une nouvelle tentative pourrait débiter le client deux fois.

Payment failed after initially succeeding at checkout

Cause : La banque du client a retourné le débit, le plus souvent pour insuffisance de fonds ou clôture du compte.Solution : Considérez le paiement comme échoué et demandez au client de réessayer avec une autre méthode de paiement. Conditionnez toujours l’exécution de la commande à l’état succeeded pour éviter ce problème.

Pages associées

Payment Methods Overview

Consultez toutes les méthodes de paiement prises en charge.

Adaptive Currency

Prise en charge des devises et conversion automatique.

Checkout Guide

Guide complet de mise en œuvre du checkout.

Webhooks

Gérez les confirmations de paiement différées de manière asynchrone.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Pourquoi proposer le prélèvement ACH ?

Lower Processing Cost

No Card Required

Higher Value Orders

Présentation

Fonctionnement

Expérience client

Disponibilité

Configuration

Type de méthode API

Remboursements et litiges

Tests

Comptes bancaires de test

Bonnes pratiques

Résolution des problèmes

Pages associées

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

​Pourquoi proposer le prélèvement ACH ?

Lower Processing Cost

No Card Required

Higher Value Orders

​Présentation

​Fonctionnement

​Expérience client

​Disponibilité

​Configuration

​Type de méthode API

​Remboursements et litiges

​Tests

​Comptes bancaires de test

​Bonnes pratiques

​Résolution des problèmes

​Pages associées

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

Pourquoi proposer le prélèvement ACH ?

Présentation

Fonctionnement

Expérience client

Disponibilité

Configuration

Type de méthode API

Remboursements et litiges

Tests

Comptes bancaires de test

Bonnes pratiques

Résolution des problèmes

Pages associées