Por que oferecer ACH Direct Debit?
Lower Processing Cost
Os débitos bancários normalmente custam menos para processar do que os pagamentos com cartão, especialmente em pedidos de alto valor.
No Card Required
Alcance clientes dos EUA que preferem pagar por meio de uma conta bancária ou que não querem usar um cartão em compras grandes.
Higher Value Orders
A vantagem de custo em relação aos cartões aumenta conforme o valor do pedido, tornando o ACH adequado para grandes compras únicas.
Visão geral
Como funciona
Experiência do cliente
- O cliente seleciona ACH Direct Debit no checkout
- O cliente autoriza o débito em sua conta bancária nos EUA
- O pagamento é enviado à rede ACH e entra em um estado de processamento
- A compensação é concluída nos dias úteis seguintes
- O pagamento passa para o estado succeeded ou falha se o banco o devolver
Como a compensação é assíncrona, use webhooks para conhecer o resultado final, em vez do redirecionamento do checkout. Um redirecionamento bem-sucedido significa apenas que o cliente autorizou o débito.O pagamento emite
payment.processing assim que o débito é enviado e, em seguida, payment.succeeded ou payment.failed quando a compensação é concluída. Somente payment.succeeded é seguro para realizar o atendimento.Disponibilidade
O ACH Direct Debit aparece no checkout quando todas as condições a seguir são atendidas:- Moeda de cobrança é
USD - País de cobrança é
US - A transação é um pagamento único
O ACH Direct Debit não está disponível para assinaturas. Sua janela de compensação de vários dias não é adequada para ciclos de cobrança recorrentes. Para pagamentos recorrentes, use cartões ou outro método compatível com assinaturas — consulte a visão geral dos métodos de pagamento.
Configuração
O ACH Direct Debit requer uma moeda de cobrança USD e um endereço de cobrança nos EUA. Se você informar seus preços em outra moeda, ative o Adaptive Currency para que os clientes dos EUA sejam cobrados em USD e o ACH fique disponível.
Tipo de método da API
Reembolsos e disputas
Reembolsos e disputas para pagamentos ACH usam as mesmas APIs e os mesmos fluxos do dashboard que todos os outros métodos de pagamento — não há nenhum tratamento específico de ACH a ser implementado.Testes
1
Enable test mode
Use suas chaves de teste da API do Dodo Payments.
2
Set currency and billing address
Defina a moeda de cobrança como
USD e o país do endereço de cobrança como US.3
Include `ach` in allowed methods
Informe
ach em allowed_payment_method_types ou omita o campo completamente para exibir todos os métodos elegíveis.4
Enter the test bank details
Insira um dos pares de números de roteamento e de conta de teste abaixo e confirme que seu handler de webhook recebe o status final do pagamento.
Contas bancárias de teste
Os clientes inserem o número da conta e o número de roteamento diretamente no checkout. No modo de teste, use o número de roteamento110000000 com qualquer um dos números de conta abaixo para forçar um resultado específico.
A maioria dos pagamentos de teste chega a um status final muito mais rápido do que durante a janela de compensação real, portanto você não precisa esperar dias para verificar sua integração. A exceção é
000000000009, que foi projetado para permanecer em processamento.Práticas recomendadas
Set customer expectations at checkout
Set customer expectations at checkout
Informe aos clientes que pagamentos bancários não são compensados instantaneamente. Isso reduz os chamados ao suporte perguntando por que um pedido ainda está pendente.
Provide card fallbacks
Provide card fallbacks
Sempre inclua
credit e debit junto com ach para que clientes que precisam de acesso instantâneo ao seu produto possam escolher um método mais rápido.Use ACH for high-value one-time purchases
Use ACH for high-value one-time purchases
A vantagem de custo do ACH aumenta conforme o valor do pedido, portanto ele é mais útil em grandes compras únicas do que em compras pequenas.
Solução de problemas
ACH not appearing at checkout
ACH not appearing at checkout
Verifique:
- A moeda de cobrança está definida como
USD? - O país de cobrança do cliente é
US? achestá incluído emallowed_payment_method_types?- Este é um pagamento único? O ACH não é oferecido para assinaturas.
allowed_payment_method_types para ver todos os métodos elegíveis e, em seguida, verifique a moeda de cobrança e o país do endereço na sua solicitação da API.ACH not appearing on a subscription checkout
ACH not appearing on a subscription checkout
Causa: o ACH Direct Debit é oferecido apenas para pagamentos únicos.Solução: use cartões ou outro método compatível com assinaturas para cobranças recorrentes.
Payment stuck in processing
Payment stuck in processing
Causa: isso é esperado. Os pagamentos ACH permanecem em estado de processamento durante toda a janela de compensação, por muito mais tempo que os pagamentos com cartão.Solução: aguarde o webhook final. Não tente novamente o pagamento — uma nova tentativa pode debitar o cliente duas vezes.
Payment failed after initially succeeding at checkout
Payment failed after initially succeeding at checkout
Causa: o banco do cliente devolveu o débito — geralmente por fundos insuficientes ou por uma conta encerrada.Solução: trate o pagamento como falho e peça ao cliente que tente novamente com outro método de pagamento. Sempre condicione o atendimento ao estado succeeded para evitar esse problema.
Páginas relacionadas
Payment Methods Overview
Veja todos os métodos de pagamento compatíveis.
Adaptive Currency
Suporte a moedas e conversão automática.
Checkout Guide
Guia completo de implementação do checkout.
Webhooks
Trate confirmações de pagamento atrasadas de forma assíncrona.