Cartões de crédito e débito

Aceite todas as principais bandeiras de cartões de crédito e débito globalmente com Dodo Payments. Saiba mais sobre 3D Secure, cartões salvos, tokenização e suporte regional a cartões.

Os pagamentos com cartão são a base dos pagamentos online, aceitos globalmente e confiáveis para clientes em todo o mundo. Dodo Payments oferece suporte a todas as principais bandeiras de cartões, com proteção contra fraude integrada e conformidade com PCI.

​

Bandeiras de cartões compatíveis

​

Bandeiras globais

Bandeira	Cobertura
Visa	Líder global, mais de 4 bilhões de cartões no mundo
Mastercard	Alcance global, fortes recursos de segurança
American Express	Titulares de cartões premium, maior poder de compra
Discover	Foco nos EUA, expansão global crescente
JCB	Líder no Japão, expandindo-se pela Ásia
UnionPay	Dominante na China, mais de 8 bilhões de cartões
Diners Club	Viajantes internacionais premium

​

Bandeiras regionais

Bandeira	Região
Interac	Rede de débito do Canadá
Cartes Bancaires	Rede nacional da França
Korean Local Cards	Redes domésticas da Coreia
Rupay	Rede nacional da Índia

​

Configuração

Use estes valores em allowed_payment_method_types:

Tipo	Descrição
credit	Todos os cartões de crédito
debit	Todos os cartões de débito

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['credit', 'debit'],
  return_url: 'https://example.com/success'
});

Inclua credit e debit, a menos que tenha um motivo específico para excluir um deles. Muitos clientes preferem cartões de débito, que geralmente também têm taxas menores.

​

Autenticação 3D Secure

O 3D Secure (3DS) adiciona uma camada de autenticação que reduz fraudes e chargebacks ao verificar a identidade do titular do cartão.

​

Quando o 3DS é acionado

O 3DS é acionado automaticamente quando:

• Exigido pela bandeira do cartão
• Exigido por regulamentações regionais (por exemplo, PSD2 na Europa)
• A transação é sinalizada como de alto risco

​

Forçar o 3DS

Você pode exigir o 3DS em todas as transações:

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  force_3ds: true,
  return_url: 'https://example.com/success'
});

Ativar o 3DS para todas as transações reduz fraudes, mas pode diminuir ligeiramente a conversão, pois alguns clientes abandonam o processo 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 falhar:

Status	Significado	O que fazer
requires_customer_action	O cliente precisa concluir um desafio 3DS	Peça ao cliente para concluir a autenticação durante o checkout
requires_payment_method	O cliente nunca forneceu um método de pagamento (não inseriu os dados ou abandonou a solicitação) — geralmente uma desistência, não uma recusa	Entre em contato novamente com o cliente para concluir o checkout; consulte Recuperação de carrinho abandonado

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 é obrigatória, mas não foi realizada.
• AUTHENTICATION_TIMEOUT — o cliente não respondeu a tempo.

Consulte a referência de Falhas de transação para saber a ação recomendada para cada caso.

​

No checkout vs. na renovação

• No checkout (cliente presente): O cliente está presente, então o desafio 3DS é exibido durante o checkout. Se falhar, peça que tente novamente ou use outro cartão.
• Na renovação da assinatura (cliente ausente): O cliente não está presente, portanto não é possível exibir um desafio 3DS em tempo real. Se uma renovação exigir autenticação, a assinatura passará para on_hold. Recupere-a solicitando que o cliente retorne e atualize o método de pagamento — consulte Como lidar com falhas de pagamento e Cobrança de assinaturas inadimplentes.

​

Métodos de pagamento salvos

Os clientes podem salvar seus cartões para agilizar futuros checkouts.

Tokenized

Os números originais dos cartões nunca são armazenados.

PCI Compliant

Dodo cuida de toda a conformidade.

Customer-Scoped

Cartões vinculados a clientes específicos.

​

Ativar cartões salvos

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  show_saved_payment_methods: true,
  customer: { customer_id: 'cus_existing_123' },
  return_url: 'https://example.com/success'
});

​

Compras com um clique

// Get customer's saved payment methods
const methods = await client.customers.retrievePaymentMethods('cus_123');

// Use saved card for instant checkout
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  customer: { customer_id: 'cus_123' },
  payment_method_id: methods.items[0].payment_method_id,
  confirm: true,
  return_url: 'https://example.com/success'
});

​

Testes

Successful Payments

Região	Bandeira	Número do cartão	Validade	CVV
US	Visa	4242424242424242	06/32	123
US	Mastercard	5555555555554444	06/32	123
Índia	Visa	4576238912771450	06/32	123
Índia	Mastercard	5409162669381034	06/32	123

Declined Payments

Região	Bandeira	Número do cartão	Cenário
US	Visa	4000000000000002	Recusa genérica
US	Mastercard	4000000000009995	Saldo insuficiente
Índia	Visa	4706131211212123	Recusa genérica
Índia	Mastercard	5105105105105100	Recusa genérica

Os cartões de teste funcionam apenas no modo de teste. Nunca os use em transações de produção.

​

Segurança e conformidade

Recurso	Descrição
PCI DSS Level 1	Mais alto nível de certificação
Tokenization	Números de cartão tokenizados imediatamente
Fraud Scoring	Avaliação de risco em tempo real
AVS	Serviço de verificação de endereço
CVV Validation	Verificação do código de segurança
3D Secure	Autenticação do titular do cartão

​

Práticas recomendadas

Accept all major networks

Não restrinja tipos de cartão, a menos que seja necessário. Os clientes esperam que seu cartão preferido funcione.

Display card logos

Exiba os logotipos Visa, Mastercard e Amex no checkout para aumentar a confiança.

Handle declines gracefully

Exiba mensagens de erro claras. Não mostre códigos de erro brutos aos clientes.

Enable saved cards for returning customers

Os métodos de pagamento salvos aumentam significativamente a conversão em compras recorrentes.

​

Solução de problemas

Card declined

Causas: Saldo insuficiente, cartão expirado, CVV incorreto, proteção contra fraude do banco.

Solução: Peça ao cliente para verificar os dados ou tentar outro cartão. Consulte o código de recusa específico Error Code e a ação recomendada na referência de Falhas de transação, e veja Como lidar com falhas de pagamento para o tratamento programático.

3DS authentication failed

Causas: Cliente abandonou o processo, sistema bancário indisponível, tempo limite excedido.

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 códigos de recusa envolvidos.

Card not supported

Causas: Cartão regional não compatível, restrições para cartões pré-pagos.

Solução: O cliente deve tentar outro cartão de uma das principais bandeiras.

​

Páginas relacionadas

Payment Methods Overview

Todos os métodos de pagamento compatíveis.

Upsells & Downsells

Compras com um clique usando cartões salvos.

Testing Process

Guia completo de testes.

Subscriptions

Cobrança recorrente com cartões.