Carteiras Digitais

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 (exceto a Índia)	Todas	Sim	Verificação de domínio
Google Pay	Global (exceto a Índia)	Todas	Sim	Nenhuma
Amazon Pay	Global (exceto a Índia)	USD	Não	Nenhuma
Cash App Pay	Apenas EUA	USD	Sim	Nenhuma
RevolutPay	Global	GBP	Não	Nenhuma

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.

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

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

A verificação de domínio é necessária apenas para o checkout embutido (inline). Checkout em sobreposição, checkout hospedado e links de pagamento não precisam disso.

Open Wallet domains

No seu painel, vá para Configurações → Métodos de Pagamento e, na linha do Apple Pay, clique em Gerenciar domínios.

Botão Gerenciar domínios na linha do Apple Pay nas configurações de Métodos de Pagamento — Open Wallet domains from the Apple Pay row

Download the domain association file

No painel de domínios da Wallet, baixe o arquivo de associação.

Painel de domínios da Wallet com o botão Baixar arquivo — Download the Apple Pay domain association file

Clique em Registrar domínio e insira o domínio onde você embute o checkout (e.g., shop.example.com), então clique em Continuar.

Formulário de registro de domínio com um domínio inserido — Register the domain where you embed checkout

Host the file on your domain

Faça upload para o seu servidor em:

https://shop.example.com/.well-known/apple-developer-merchantid-domain-association

O arquivo deve ser servido via HTTPS, acessível sem redirecionamentos, e servido com Content-Type: application/octet-stream ou text/plain.

Verify the domain

Clique em Verificar domínio. O Dodo Payments verifica o arquivo hospedado e envia seu domínio para a Apple.

Tela Verificar seu domínio com o caminho do host do arquivo de associação e botão Verificar domínio — Verify the hosted association file

Confirm it's active

Quando o status mostrar Ativo, o Apple Pay estará ativo para esse domínio. Use o toggle Ativado para ligar ou desligar por domínio.

Lista de domínios da Wallet mostrando domínios com status do Apple Pay ativo e toggles ativados — Verified domains show an Active status

Test the integration

Abra o checkout em um dispositivo Apple
Verifique se o botão Apple Pay aparece
Conclua uma transação de teste

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 em suas contas Google, com proteção contra fraudes embutida.

Requisitos

Navegadores: Chrome (desktop/mobile), Safari, Firefox
Dispositivos: Dispositivos Android com aplicativo Google Pay
Configurações: “Permitir que sites verifiquem se você tem métodos de pagamento” habilitado 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 suas credenciais da conta Amazon e métodos de pagamento salvos para uma experiência de checkout familiar.

Disponibilidade

Região: Global, exceto a Índia
Moeda: Somente 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: ['amazon_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

Cash App Pay

O Cash App Pay permite pagamentos via Cash App, popular entre os consumidores dos EUA para pagamentos de pessoa para pessoa.

Disponibilidade

Região: Apenas EUA
Moeda: Somente USD
Assinaturas: 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 complicações para usuários do Revolut globalmente, aproveitando o saldo existente da conta Revolut ou cartões vinculados.

Disponibilidade

Região: Global
Moeda: Somente 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

Testes do Apple Pay

Use test mode

Ative o modo de teste no seu painel do Dodo Payments.

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.

Complete test purchase

Abra o checkout em um dispositivo Apple e conclua o fluxo do Apple Pay.

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

Testes do Google Pay

Join the test card group

Participe do grupo de cartões de teste do Google Pay para obter cartões de teste adicionados automaticamente à sua wallet.

Enable test mode

Use suas chaves de API de teste do Dodo Payments.

Complete test purchase

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

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

SDKs para Web

Todas as carteiras digitais são totalmente suportadas em:

Checkout em Sobreposição
Checkout Inline
Integração direta via API

SDKs móveis (Checkout)

Os SDKs de checkout para Android, iOS, React Native e Flutter abrem o checkout hospedado da Dodo na superfície de navegador real da plataforma (SFSafariViewController / Chrome Custom Tabs), não em uma WebView, para que o Apple Pay e o Google Pay funcionem da mesma forma que na web. Consulte o Guia de integração para dispositivos móveis para obter instruções de configuração.

Práticas recomendadas

Prioritize wallets on mobile

Os usuários móveis esperam encontrar Apple Pay e Google Pay. Exiba essas opções com destaque nos checkouts móveis.

Complete domain verification early

O Apple Pay exige a verificação do domínio. Não espere até o dia do lançamento — inicie o processo durante o desenvolvimento.

Always include card fallbacks

Nem todos os clientes têm carteiras digitais. Sempre inclua credit e debit nos seus métodos permitidos.

Test on real devices

Os simuladores não reproduzem totalmente o comportamento das carteiras. Teste em dispositivos iOS e Android reais antes do lançamento.

Handle wallet unavailability gracefully

Se uma carteira não estiver disponível (dispositivo incompatível ou nenhum cartão salvo), certifique-se de que as outras opções de pagamento estejam visíveis.

Solução de problemas

Apple Pay button not appearing

Verifique:

O domínio foi verificado com a Dodo Payments?
Você está usando HTTPS?
O dispositivo é compatível com iOS 17+ / Safari 17+ / iPadOS 17+?
O cliente tem cartões na Apple Wallet?
apple_pay está incluído em allowed_payment_method_types?

Solução: conclua a verificação do domínio e certifique-se de que o HTTPS esteja sendo usado. Teste em um dispositivo Apple real.

Google Pay button not appearing

Verifique:

Você está usando o Chrome ou um navegador compatível?
O cliente tem cartões no Google Pay?
A configuração do Chrome “Permitir que os sites verifiquem os métodos de pagamento” está ativada?
google_pay está incluído em allowed_payment_method_types?

Solução: verifique a compatibilidade do navegador e a configuração do Google Pay do cliente.

Wallet payment failed

Causas comuns:

O cartão na carteira expirou ou é inválido
O banco recusou a transação
Problema de conectividade de rede

Solução: o cliente deve verificar o cartão na carteira ou tentar um método de pagamento diferente.

Wrong device type

As carteiras digitais aparecem apenas em dispositivos compatíveis:

Apple Pay: somente dispositivos Apple
Google Pay: navegador Chrome ou dispositivos Android

Solução: esse é o comportamento esperado. Certifique-se de que as alternativas de cartão estejam disponíveis.

Páginas relacionadas

Payment Methods Overview

Consulte todos os métodos de pagamento compatíveis.

Overlay Checkout

Implemente o checkout com suporte a carteiras digitais.

Testing Process

Consulte o guia completo de testes para todos os métodos de pagamento.

Mobile Integration Guide

Abre o checkout hospedado em uma aba nativa do navegador — Apple Pay e Google Pay funcionam da mesma forma que na web.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Carteiras Suportadas

Apple Pay

Requisitos

Verificação do Domínio

Configuração

Google Pay

Requisitos

Configuração

Amazon Pay

Disponibilidade

Configuração

Cash App Pay

Disponibilidade

Configuração

RevolutPay

Disponibilidade

Configuração

Testes

Testes do Apple Pay

Testes do Google Pay

Amazon Pay & Cash App Pay

Suporte a SDK

SDKs para Web

SDKs móveis (Checkout)

Práticas recomendadas

Solução de problemas

Páginas relacionadas

Payment Methods Overview

Overlay Checkout

Testing Process

Mobile Integration Guide

​Carteiras Suportadas

​Apple Pay

​Requisitos

​Verificação do Domínio

​Configuração

​Google Pay

​Requisitos

​Configuração

​Amazon Pay

​Disponibilidade

​Configuração

​Cash App Pay

​Disponibilidade

​Configuração

​RevolutPay

​Disponibilidade

​Configuração

​Testes

​Testes do Apple Pay

​Testes do Google Pay

​Amazon Pay & Cash App Pay

​Suporte a SDK

​SDKs para Web

​SDKs móveis (Checkout)

​Práticas recomendadas

​Solução de problemas

​Páginas relacionadas

Payment Methods Overview

Overlay Checkout

Testing Process

Mobile Integration Guide

Carteiras Suportadas

Apple Pay

Requisitos

Verificação do Domínio

Configuração

Google Pay

Requisitos

Configuração

Amazon Pay

Disponibilidade

Configuração

Cash App Pay

Disponibilidade

Configuração

RevolutPay

Disponibilidade

Configuração

Testes

Testes do Apple Pay

Testes do Google Pay

Amazon Pay & Cash App Pay

Suporte a SDK

SDKs para Web

SDKs móveis (Checkout)

Práticas recomendadas

Solução de problemas

Páginas relacionadas