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

# Carteiras Digitais

> Aceite Apple Pay, Google Pay, Amazon Pay, Cash App Pay e RevolutPay para um checkout rápido, seguro e com um toque. Saiba sobre configuração, verificação de domínio e testes.

Carteiras digitais permitem que clientes paguem com um único toque usando métodos de pagamento salvos em seus dispositivos. Elas oferecem taxas de conversão maiores, segurança reforçada por tokenização e uma experiência de checkout simplificada.

## Carteiras Suportadas

| Carteira         | Disponibilidade      | Moedas | Assinaturas | Configuração Necessária |
| :--------------- | :------------------- | :----- | :---------: | :---------------------- |
| **Apple Pay**    | Global (excl. Índia) | Todas  |     Sim     | Verificação de domínio  |
| **Google Pay**   | Global (excl. Índia) | Todas  |     Sim     | Nenhuma                 |
| **Amazon Pay**   | Global (excl. Índia) | USD    |     Não     | Nenhuma                 |
| **Cash App Pay** | Apenas EUA           | USD    |     Não     | Nenhuma                 |
| **RevolutPay**   | Global               | GBP    |     Não     | Nenhuma                 |

<Warning>
  **Suporte ao PayPal Pausado:** O PayPal está temporariamente indisponível para novas transações.
</Warning>

## Apple Pay

O Apple Pay permite que os clientes paguem usando cartões salvos na Apple Wallet, com autenticação Face ID ou Touch ID.

<Info>
  Apple Pay é oferecido para assinaturas mesmo quando a primeira cobrança é \*\*$0** (por exemplo, testes gratuitos) para que o mandato de pagamento possa ser configurado na inscrição. Para pagamentos únicos, o Apple Pay só é exibido quando o valor é maior que $0.
</Info>

### Requisitos

* **Dispositivos:** iOS 17+, iPadOS 17+, Safari 17+ no macOS
* **Protocolo:** HTTPS necessário
* **Domínio:** Deve ser verificado com a Apple

### Verificação do Domínio

<Steps>
  <Step title="Download the domain association file">
    Baixe o [arquivo de associação de domínio do Apple Pay](https://checkout.dodopayments.com/.well-known/apple-developer-merchantid-domain-association).
  </Step>

  <Step title="Host the file on your domain">
    Carregue em seu servidor em:

    ```
    https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association
    ```

    O arquivo deve estar acessível sem redirecionamentos e servido com `Content-Type: application/octet-stream` ou `text/plain`.
  </Step>

  <Step title="Request activation">
    Envie um e-mail para **[support@dodopayments.com](mailto:support@dodopayments.com)** com:

    * Seu domínio de produção (por exemplo, `https://yourdomain.com`)
    * Confirmação de que o arquivo está hospedado

    Verificaremos e habilitaremos o Apple Pay dentro de 1-2 dias úteis.
  </Step>

  <Step title="Test the integration">
    Após a confirmação:

    1. Abra o checkout em um dispositivo Apple
    2. Verifique se o botão Apple Pay aparece
    3. Complete uma transação de teste
  </Step>
</Steps>

<Warning>
  O Apple Pay não aparecerá no checkout até que a verificação do domínio esteja completa. Planeje isso ao lançar.
</Warning>

### Configuração

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

## Google Pay

O Google Pay permite que os clientes paguem usando cartões salvos em sua conta do Google, com proteção contra fraude integrada.

### Requisitos

* **Navegadores:** Chrome (desktop/móvel), Safari, Firefox
* **Dispositivos:** Dispositivos Android com app Google Pay
* **Configurações:** "Permitir que sites verifiquem se você tem métodos de pagamento" habilitado no Chrome

### Configuração

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

<Info>
  Não é necessária verificação de domínio para o Google Pay — ele funciona automaticamente assim que sua conta está ativa.
</Info>

## Amazon Pay

O Amazon Pay permite que os clientes usem as credenciais da conta Amazon e métodos de pagamento salvos para uma experiência familiar de checkout.

### Limitações

* **Moeda:** apenas USD
* **Assinaturas:** Não suportado
* **Região:** Não disponível na Índia

### Configuração

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

## Cash App Pay

Cash App Pay permite pagamentos a partir do Cash App, popular entre os consumidores dos EUA para pagamentos entre pares.

### Limitações

* **Região:** apenas EUA
* **Moeda:** apenas USD
* **Assinaturas:** Não suportado

### Configuração

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

## RevolutPay

O RevolutPay permite pagamentos rápidos e sem complicações para usuários do Revolut globalmente, aproveitando o saldo existente na conta Revolut ou cartões vinculados.

### Limitações

* **Moeda:** apenas GBP
* **Assinaturas:** Não suportado

### Configuração

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

## Testes

### Teste do Apple Pay

<Steps>
  <Step title="Use test mode">
    Habilite o modo de teste no painel do Dodo Payments.
  </Step>

  <Step title="Add a card to Apple Wallet">
    Adicione um cartão real à sua Apple Wallet. No modo de teste, o cartão não será cobrado.
  </Step>

  <Step title="Complete test purchase">
    Abrir o checkout em um dispositivo Apple e completar o fluxo do Apple Pay.
  </Step>
</Steps>

<Warning>
  O Apple Pay requer HTTPS. Não aparecerá em `localhost` sem a configuração adequada de SSL.
</Warning>

### Teste do Google Pay

<Steps>
  <Step title="Join the test card group">
    [Junte-se ao grupo de cartões de teste do Google Pay](https://groups.google.com/g/googlepay-test-mode-stub-data) para obter cartões de teste adicionados automaticamente à sua carteira.
  </Step>

  <Step title="Enable test mode">
    Use suas chaves de API de teste do Dodo Payments.
  </Step>

  <Step title="Complete test purchase">
    Selecione um dos cartões de teste no Google Pay para completar a transação.
  </Step>
</Steps>

### Amazon Pay & Cash App Pay

Use suas chaves de API de teste e siga o fluxo padrão de checkout. Transações de teste serão simuladas sem cobranças reais.

## Suporte ao SDK

### SDKs Web

Todas as carteiras digitais são totalmente suportadas em:

* Checkout Overlay
* Checkout Inline
* Integração direta com API

### SDKs Móveis

<Warning>
  **Limitação do React Native:** Apple Pay, Google Pay, Cash App Pay e UPI **não são atualmente suportados** no SDK do React Native. Use a sobreposição de checkout baseada na web para aplicativos móveis que precisam desses métodos.
</Warning>

Para suporte móvel nativo, considere:

* Abrir o checkout em uma WebView
* Usar o [Checkout Overlay](/developer-resources/overlay-checkout) em um contexto web
* Implementar SDKs de Apple Pay / Google Pay nativos da plataforma separadamente

## Melhores Práticas

<AccordionGroup>
  <Accordion title="Prioritize wallets on mobile">
    Os usuários móveis esperam o Apple Pay e o Google Pay. Mostre essas opções de forma proeminente nos checkouts móveis.
  </Accordion>

  <Accordion title="Complete domain verification early">
    O Apple Pay requer verificação de domínio. Não espere até o dia do lançamento — inicie o processo durante o desenvolvimento.
  </Accordion>

  <Accordion title="Always include card fallbacks">
    Nem todos os clientes possuem carteiras digitais. Sempre inclua `credit` e `debit` em seus métodos permitidos.
  </Accordion>

  <Accordion title="Test on real devices">
    Simuladores não replicam totalmente o comportamento das carteiras. Teste em dispositivos iOS e Android reais antes do lançamento.
  </Accordion>

  <Accordion title="Handle wallet unavailability gracefully">
    Se uma carteira não estiver disponível (dispositivo errado, sem cartões salvos), garanta que outras opções de pagamento estejam visíveis.
  </Accordion>
</AccordionGroup>

## Solução de Problemas

<AccordionGroup>
  <Accordion title="Apple Pay button not appearing">
    **Verificar:**

    1. Domínio verificado com o Dodo Payments?
    2. Usando HTTPS?
    3. Dispositivo é iOS 17+ / Safari 17+ / iPadOS 17+?
    4. Cliente tem cartões na Apple Wallet?
    5. `apple_pay` incluído em `allowed_payment_method_types`?

    **Solução:** Complete a verificação de domínio e garanta HTTPS. Teste em um dispositivo Apple real.
  </Accordion>

  <Accordion title="Google Pay button not appearing">
    **Verificar:**

    1. Usando o Chrome ou navegador compatível?
    2. Cliente tem cartões no Google Pay?
    3. Configuração do Chrome "Permitir que sites verifiquem métodos de pagamento" habilitada?
    4. `google_pay` incluído em `allowed_payment_method_types`?

    **Solução:** Verifique a compatibilidade do navegador e a configuração do Google Pay do cliente.
  </Accordion>

  <Accordion title="Wallet payment failed">
    **Causas comuns:**

    * Cartão na carteira expirado ou inválido
    * Banco recusou a transação
    * Problema de conectividade de rede

    **Solução:** Cliente deve verificar o cartão em sua carteira ou tentar outro método de pagamento.
  </Accordion>

  <Accordion title="Wrong device type">
    Carteiras digitais só aparecem em dispositivos compatíveis:

    * Apple Pay: apenas dispositivos Apple
    * Google Pay: navegador Chrome ou dispositivos Android

    **Solução:** Este é o comportamento esperado. Garanta que alternativas de cartão estejam disponíveis.
  </Accordion>
</AccordionGroup>

## Páginas Relacionadas

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    Veja todos os métodos de pagamento suportados.
  </Card>

  <Card title="Overlay Checkout" icon="window-restore" href="/developer-resources/overlay-checkout">
    Implemente o checkout com suporte a carteira digital.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    Guia de testes completos para todos os métodos de pagamento.
  </Card>

  <Card title="React Native Integration" icon="mobile" href="/developer-resources/react-native-integration">
    Documentação e limitações do SDK móvel.
  </Card>
</CardGroup>