Bandeiras de cartões compatíveis
O Dodo Payments aceita redes globais e várias redes regionais.Redes globais
Redes regionais
Configuração
Os cartões usam dois valores emallowed_payment_method_types:
Esta sessão oferece apenas pagamentos com cartão:
Autenticação 3D Secure
O 3D Secure (3DS) solicita ao banco do titular do cartão que confirme a identidade dele, por exemplo, com um código de uso único, uma verificação biométrica ou uma aprovação no aplicativo do banco. Isso reduz fraudes e chargebacks.Quando o 3DS é acionado
Dodo Payments solicita o 3DS quando:- A rede do cartão exige isso.
- Uma regulamentação regional exige isso, como a PSD2 na Europa.
- A transação é sinalizada como de alto risco.
Forçar o 3DS
Para exigir o 3DS em todos os pagamentos com cartão da sua empresa, ative 3D Secure em Settings → Pricing. Para substituir essa configuração em uma sessão de checkout, passeforce_3ds:
Exigir o 3DS em todas as transações reduz fraudes, mas pode diminuir a conversão, pois alguns clientes abandonam o checkout durante a autenticação.
Como lidar com falhas de autenticação
Quando um pagamento precisa de autenticação 3DS, ele passa por estados intermediários antes de ser aprovado ou recusado:
Se a autenticação não for concluída, o pagamento falhará com um destes códigos de recusa:
AUTHENTICATION_FAILURE: o cliente não pôde ser autenticado.AUTHENTICATION_REQUIRED: a autenticação é necessária, mas não foi realizada.AUTHENTICATION_TIMEOUT: o cliente não respondeu a tempo.
No checkout vs. na renovação
- No checkout (cliente presente): o desafio 3DS aparece durante o checkout. Se falhar, peça ao cliente para tentar novamente ou usar outro cartão.
- Na renovação da assinatura (cliente ausente): não é possível exibir um desafio 3DS em tempo real. Se uma renovação exigir autenticação e falhar, a assinatura passará para
on_holdou primeiro parapast_due, caso você tenha definido um período de carência. Para recuperá-la, solicite que o cliente retorne e atualize a forma de pagamento. Consulte Como lidar com falhas de pagamento e Cobrança de assinaturas.
Formas de pagamento salvas
Clientes recorrentes podem pagar com um cartão salvo em um checkout anterior.Tokenized
Os números originais dos cartões nunca são armazenados.
PCI Compliant
Dodo Payments gerencia a conformidade com PCI.
Customer-Scoped
Cada cartão salvo pertence a um cliente.
Ativar cartões salvos
Para mostrar os cartões salvos de um cliente recorrente no checkout, passeshow_saved_payment_methods: true com o customer_id existente. O padrão é false.
Compras em um clique
Para cobrar um cartão salvo sem exibir o checkout, passe opayment_method_id dele com confirm: true e o customer_id existente. A sessão cobra o cartão diretamente e não retorna checkout_url, portanto use webhooks para saber o resultado do pagamento.
Testes
Use estes cartões no modo de teste. Para obter mais dados de teste, consulte Processo de testes.- Successful Payments
- Declined Payments
Segurança e conformidade
Dodo Payments aplica estas proteções aos pagamentos com cartão:Práticas recomendadas
Accept all major networks
Accept all major networks
Não restrinja tipos de cartão, a menos que seja necessário. Os clientes esperam que o cartão preferido deles funcione.
Display card logos
Display card logos
Mostre os logotipos da Visa, Mastercard e Amex no seu site para gerar confiança.
Handle declines gracefully
Handle declines gracefully
Mostre mensagens de erro claras. Não mostre códigos de erro brutos aos clientes.
Enable saved cards for returning customers
Enable saved cards for returning customers
As formas de pagamento salvas tornam as compras repetidas mais rápidas para clientes recorrentes.
Solução de problemas
Card declined
Card declined
Causas: fundos insuficientes, cartão expirado, CVV incorreto ou proteção contra fraudes do banco.Solução: peça ao cliente para verificar os dados ou tentar outro cartão. Consulte o código de erro da recusa e a ação recomendada para ele na referência de Falhas de transação. Consulte Como lidar com falhas de pagamento para tratar recusas no código.
3DS authentication failed
3DS authentication failed
Causas: o cliente abandonou o desafio, o sistema do banco estava indisponível ou o tempo do desafio expirou.Solução: tente novamente ou peça ao cliente para entrar em contato com o banco. Consulte Como lidar com falhas de autenticação para conhecer os estados de pagamento e os códigos de recusa envolvidos.
Card not supported
Card not supported
Causas: a rede regional não é compatível ou o cartão pré-pago é restrito.Solução: peça ao cliente para tentar um cartão de uma rede principal.
Páginas relacionadas
Payment Methods Overview
Todos os métodos de pagamento compatíveis.
Upsells & Downsells
Compras em um clique com cartões salvos.
Testing Process
Dados de teste para cada método de pagamento.
Subscriptions
Cobrança recorrente com cartões.