> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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  |

```javascript theme={null}
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'
});
```

<Tip>
  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.
</Tip>

## 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:

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

<Note>
  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.
</Note>

### 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](/features/recovery/abandoned-cart-recovery) |

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](/api-reference/transaction-failures) 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](/developer-resources/handle-payment-failures) e [Cobrança de assinaturas inadimplentes](/features/recovery/subscription-dunning).

## Métodos de pagamento salvos

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

<CardGroup cols={3}>
  <Card title="Tokenized" icon="lock">
    Os números originais dos cartões nunca são armazenados.
  </Card>

  <Card title="PCI Compliant" icon="shield-check">
    Dodo cuida de toda a conformidade.
  </Card>

  <Card title="Customer-Scoped" icon="user">
    Cartões vinculados a clientes específicos.
  </Card>
</CardGroup>

### Ativar cartões salvos

```javascript theme={null}
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

```javascript theme={null}
// 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

<Tabs>
  <Tab title="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 |
  </Tab>

  <Tab title="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    |
  </Tab>
</Tabs>

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

## 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

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="Display card logos">
    Exiba os logotipos Visa, Mastercard e Amex no checkout para aumentar a confiança.
  </Accordion>

  <Accordion title="Handle declines gracefully">
    Exiba mensagens de erro claras. Não mostre códigos de erro brutos aos clientes.
  </Accordion>

  <Accordion title="Enable saved cards for returning customers">
    Os métodos de pagamento salvos aumentam significativamente a conversão em compras recorrentes.
  </Accordion>
</AccordionGroup>

## Solução de problemas

<AccordionGroup>
  <Accordion title="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](/api-reference/transaction-failures), e veja [Como lidar com falhas de pagamento](/developer-resources/handle-payment-failures) para o tratamento programático.
  </Accordion>

  <Accordion title="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](#handling-authentication-failures) para conhecer os estados de pagamento e códigos de recusa envolvidos.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Páginas relacionadas

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="layer-group" href="/features/payment-methods">
    Todos os métodos de pagamento compatíveis.
  </Card>

  <Card title="Upsells & Downsells" icon="arrow-up-right-dots" href="/features/upsells-and-downsells">
    Compras com um clique usando cartões salvos.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    Guia completo de testes.
  </Card>

  <Card title="Subscriptions" icon="repeat" href="/features/subscription">
    Cobrança recorrente com cartões.
  </Card>
</CardGroup>