Pular para o conteúdo principal

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

CarteiraDisponibilidadeMoedasAssinaturasConfiguração Necessária
Apple PayGlobal (excl. Índia)TodasSimVerificação de domínio
Google PayGlobal (excl. Índia)TodasSimNenhuma
Amazon PayGlobal (excl. Índia)USDNãoNenhuma
Cash App PayApenas EUAUSDNãoNenhuma
RevolutPayGlobalGBPNãoNenhuma
Suporte ao PayPal Pausado: O PayPal está temporariamente indisponível para novas transações.

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

​
Requisitos

  • Dispositivos: iOS 17+, iPadOS 17+, Safari 17+ no macOS
  • Protocolo: HTTPS exigido
  • Domínio: Deve ser verificado com a Apple

​
Verificação de Domínio

1

Download the domain association file

Faça o download do arquivo de associação de domínio do Apple Pay.
2

Host the file on your domain

Envie para o seu servidor em:
https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association
O arquivo deve ser acessível sem redirecionamentos e servido com Content-Type: application/octet-stream ou text/plain.
3

Request activation

Envie um e-mail para 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 em 1 a 2 dias úteis.
4

Test the integration

Após a confirmação:
  1. Abra o checkout em um dispositivo Apple
  2. Verifique se o botão do Apple Pay aparece
  3. Conclua uma transação de teste
O Apple Pay não aparecerá no checkout até que a verificação de domínio seja concluída. Planeje isso ao lançar.

​
Configuração

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 na conta Google, com proteção integrada contra fraude.

​
Requisitos

  • Navegadores: Chrome (desktop/mobile), Safari, Firefox
  • Dispositivos: dispositivos Android com o app Google Pay
  • Configurações: “Permitir que sites verifiquem se você possui métodos de pagamento” ativado no Chrome

​
Configuração

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'
});
Nenhuma verificação de domínio é necessária para o Google Pay — ele funciona automaticamente assim que sua conta estiver ativa.

​
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 de checkout familiar.

​
Limitações

  • Moeda: apenas USD
  • Assinaturas: não compatível
  • Região: indisponível na Índia

​
Configuração

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

O Cash App Pay permite pagamentos pelo Cash App, popular entre consumidores dos EUA para transferências entre pessoas.

​
Limitações

  • Região: apenas EUA
  • Moeda: apenas USD
  • Assinaturas: não compatível

​
Configuração

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 atritos para usuários Revolut globalmente, aproveitando o saldo existente na conta Revolut ou cartões vinculados.

​
Limitações

  • Moeda: apenas GBP
  • Assinaturas: não compatível

​
Configuração

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

1

Use test mode

Ative o modo de teste no painel da Dodo Payments.
2

Add a card to Apple Wallet

Adicione um cartão real ao Apple Wallet. No modo de teste, o cartão não será cobrado.
3

Complete test purchase

Abra o checkout em um dispositivo Apple e conclua o fluxo do Apple Pay.
O Apple Pay exige HTTPS. Ele não aparecerá em localhost sem a configuração adequada de SSL.

​
Teste do Google Pay

1

Join the test card group

Entre no grupo de cartões de teste do Google Pay para ter cartões de teste adicionados automaticamente à sua carteira.
2

Enable test mode

Use suas chaves de API de teste da Dodo Payments.
3

Complete test purchase

Selecione um dos cartões de teste no Google Pay para concluir a transação.

​
Amazon Pay e 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:
  • Overlay Checkout
  • Inline Checkout
  • Integração direta com API

​
SDKs móveis

Limitação do React Native: Apple Pay, Google Pay, Cash App Pay e UPI não são atualmente suportados no SDK React Native. Use a sobreposição de checkout baseada na web para apps móveis que precisam desses métodos.
Para suporte móvel nativo, considere:
  • Abrir o checkout em um WebView
  • Usar o Overlay Checkout em um contexto web
  • Implementar separadamente os SDKs nativos de Apple Pay / Google Pay

​
Melhores Práticas

Usuários móveis esperam Apple Pay e Google Pay. Mostre essas opções com destaque nos checkouts móveis.
O Apple Pay exige verificação de domínio. Não espere até o dia do lançamento — inicie o processo durante o desenvolvimento.
Nem todos os clientes têm carteiras digitais. Sempre inclua credit e debit em seus métodos permitidos.
Simuladores não replicam completamente o comportamento das carteiras. Teste em dispositivos iOS e Android reais antes do lançamento.
Se uma carteira não estiver disponível (dispositivo incompatível, sem cartões salvos), garanta que outras opções de pagamento estejam visíveis.

​
Solução de Problemas

Verifique:
  1. Domínio verificado com a Dodo Payments?
  2. Está usando HTTPS?
  3. Dispositivo é iOS 17+ / Safari 17+ / iPadOS 17+?
  4. Cliente tem cartões no 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.
Verifique:
  1. Está 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” ativada?
  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.
Causas comuns:
  • Cartão na carteira expirado ou inválido
  • Banco recusou a transação
  • Problema de conectividade de rede
Solução: O cliente deve verificar o cartão na carteira ou tentar outro método de pagamento.
Carteiras digitais aparecem apenas em dispositivos compatíveis:
  • Apple Pay: apenas dispositivos Apple
  • Google Pay: navegador Chrome ou dispositivos Android
Solução: Esse é o comportamento esperado. Garanta que opções alternativas de cartão estejam disponíveis.

​
Páginas Relacionadas

Payment Methods Overview

Veja todos os métodos de pagamento suportados.

Overlay Checkout

Implemente o checkout com suporte a carteiras digitais.

Testing Process

Guia completo de testes para todos os métodos de pagamento.

React Native Integration

Documentação do SDK móvel e limitações.
Last modified on February 27, 2026