Skip to main content
Os cartões estão disponíveis em todos os checkouts do Dodo Payments, em todos os países e moedas compatíveis. O Dodo Payments aceita as principais redes de cartões, substitui os números dos cartões por tokens e executa as verificações necessárias para pagamentos com cartão, para que você não precise lidar com dados brutos de cartões.

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 em allowed_payment_method_types: Esta sessão oferece apenas pagamentos com cartão:
Inclua credit e debit, a menos que tenha um motivo específico para excluir um deles. Muitos clientes preferem pagar com cartão de débito.

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, passe force_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.
A referência de Falhas de transação lista a ação recomendada para cada código.

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_hold ou primeiro para past_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, passe show_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 o payment_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.
Os cartões de teste funcionam apenas no modo de teste. No modo de produção, um pagamento feito com um cartão de teste falha.

Segurança e conformidade

Dodo Payments aplica estas proteções aos pagamentos com cartão:

Práticas recomendadas

Não restrinja tipos de cartão, a menos que seja necessário. Os clientes esperam que o cartão preferido deles funcione.
Mostre os logotipos da Visa, Mastercard e Amex no seu site para gerar confiança.
Mostre mensagens de erro claras. Não mostre códigos de erro brutos aos clientes.
As formas de pagamento salvas tornam as compras repetidas mais rápidas para clientes recorrentes.

Solução de problemas

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.
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.
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.
Última modificação em 28 de setembro de 2026