Carteiras Digitais

As carteiras digitais permitem que os clientes paguem com um cartão ou uma conta já salvos no dispositivo, sem digitar os dados do cartão. A carteira envia um token em vez do número do cartão, e o cliente confirma o pagamento com um toque ou uma verificação biométrica.

Carteiras Suportadas

Dodo Payments mostra cada carteira somente quando o checkout corresponde ao país, à moeda e ao tipo de pagamento usados:

Carteira digital	Disponibilidade	Moedas	Assinaturas	Configuração necessária
Apple Pay	Global, incluindo a Índia	Todas, incluindo INR	Sim	Verificação de domínio para o checkout inline
Google Pay	Global (exceto Índia)	Todas	Sim	Nenhuma
Amazon Pay	Global (exceto Índia)	USD, EUR, GBP, AUD, CHF, DKK, HKD, JPY, NOK, NZD, SEK, ZAR	Não	Nenhuma
Cash App Pay	Somente EUA	USD	Sim	Nenhuma
RevolutPay	Global	GBP	Não	Nenhuma

O PayPal está temporariamente indisponível para novas transações.

Apple Pay

O Apple Pay permite que os clientes paguem com cartões salvos no Apple Wallet e confirmem com Face ID ou Touch ID.

O Apple Pay aparece para assinaturas mesmo quando a primeira cobrança é de $0, como em um teste gratuito, para que o mandato de pagamento seja configurado no cadastro. Para pagamentos únicos, o Apple Pay aparece somente quando o valor é maior que $0.

Requisitos

Dispositivos: iOS 17 ou posterior, iPadOS 17 ou posterior ou Safari 17 ou posterior no macOS. Na Índia, a Apple exige iPhone XR ou posterior com iOS 18 ou posterior.
Protocolo: a página deve ser carregada por HTTPS.
Domínio: para o checkout inline, o domínio deve ser verificado com a Apple.

Apple Pay na Índia

Clientes na Índia podem pagar com Apple Pay em checkouts cobrados em INR. O Apple Pay na Índia funciona sob estas condições:

Moeda: o checkout é cobrado em INR. Um pagamento cobrado em INR deve atender ao mínimo de INR.
Cartões: o cliente tem um cartão na Apple Wallet de um banco indiano compatível com o Apple Pay. A Apple controla quais bancos e cartões são elegíveis.
Desktop: em um navegador para desktop, os clientes podem escanear um código com o iPhone e confirmar o pagamento no telefone.
Assinaturas: as assinaturas do Apple Pay em INR usam mandatos do RBI. Cada cobrança de renovação é concluída aproximadamente 48 horas após a data de renovação, assim como ocorre com outros cartões emitidos na Índia.

Para cobrar um cliente na Índia em INR, siga os requisitos de Métodos de pagamento da Índia para o país de cobrança e o Adaptive Currency.

Verificação de domínio

A verificação de domínio é necessária somente para o checkout inline (incorporado). O checkout hospedado e os links de pagamento exibem o Apple Pay sem ela.

O Apple Pay não está disponível no checkout em sobreposição. Para oferecer o Apple Pay, use o checkout inline, o checkout hospedado ou um link de pagamento.

Para verificar um domínio para o checkout inline, siga estas etapas no dashboard:

Open Apple Pay Domains

Acesse Settings → Payment Methods. Na linha Apple Pay, clique em Manage domains.

Botão Manage domains na linha Apple Pay nas configurações de Payment Methods — Open Apple Pay domains from the Apple Pay row

Download the Domain Association File

No painel Apple Pay domains, clique em Download file.

Painel Apple Pay domains com o botão Download file — Download the Apple Pay domain association file

Clique em Register domain, informe o domínio em que você incorpora o checkout (por exemplo, shop.example.com) e clique em Continue.

Formulário para registrar um domínio com um domínio informado — Register the domain where you embed checkout

Host the File on Your Domain

Envie o arquivo para o seu servidor neste caminho:

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

Disponibilize o arquivo por HTTPS, sem redirecionamentos, com Content-Type: application/octet-stream ou text/plain.

Verify the Domain

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

Tela Verify your domain com o caminho do arquivo de associação hospedado e o botão Verify domain — Verify the hosted association file

Confirm It's Active

Quando o status mostrar Active, o Apple Pay estará ativo nesse domínio. Para ativar ou desativar o Apple Pay em um domínio, use o botão de alternância Enabled correspondente.

Lista de domínios do Apple Pay mostrando domínios com status Active e botões de alternância Enabled — Verified domains show an Active status

Test the Integration

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

Configuração

Para limitar uma sessão de checkout ao Apple Pay e aos cartões, passe allowed_payment_method_types:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_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 com cartões salvos na conta do Google.

Requisitos

Navegadores: Chrome no desktop e Android, e Firefox no desktop. O checkout não exibe o Google Pay no Safari nem em qualquer navegador no iOS. Nesses navegadores, os clientes podem pagar com Apple Pay ou cartão.
Dispositivos: dispositivos Android com o app Google Pay.
Configurações: no Chrome, Allow sites to check if you have payment methods saved deve estar ativado.

Configuração

Para limitar uma sessão de checkout ao Google Pay e aos cartões, passe allowed_payment_method_types:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['google_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

O Google Pay não exige verificação de domínio.

Amazon Pay

O Amazon Pay permite que os clientes finalizem a compra usando os métodos de pagamento salvos na conta da Amazon.

Disponibilidade

Região: global, exceto Índia.
Moedas: USD, EUR, GBP, AUD, CHF, DKK, HKD, JPY, NOK, NZD, SEK, ZAR. As moedas oferecidas por um checkout dependem do processador que o atende.
Assinaturas: não compatível.

Configuração

Para limitar uma sessão de checkout ao Amazon Pay e aos cartões, passe allowed_payment_method_types:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_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 que clientes dos EUA paguem usando a conta do Cash App.

Disponibilidade

Região: somente EUA. O país de cobrança deve ser os EUA.
Moeda: somente USD.
Assinaturas: compatível.

Configuração

Para limitar uma sessão de checkout ao Cash App Pay e aos cartões, passe allowed_payment_method_types:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['cashapp', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

RevolutPay

O RevolutPay permite que usuários da Revolut paguem usando o saldo da conta Revolut ou cartões vinculados.

Disponibilidade

Região: global.
Moeda: somente GBP.
Assinaturas: não compatível.

Configuração

Para limitar uma sessão de checkout ao RevolutPay e aos cartões, passe allowed_payment_method_types:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['revolut_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

Testes

No modo de teste, os pagamentos com carteiras digitais seguem o mesmo fluxo de checkout sem movimentar dinheiro real.

Testes do Apple Pay

Use Test Mode

Desative o seletor Live Mode na barra lateral do dashboard e use chaves de API criadas no modo de teste.

Add a Card to Apple Wallet

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

Complete a Test Purchase

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

O Apple Pay exige HTTPS. Ele não aparece em localhost a menos que a página seja disponibilizada por HTTPS.

Testes do Google Pay

Join the Test Card Group

Participe do grupo de cartões de teste do Google Pay para adicionar cartões de teste à sua carteira digital.

Enable Test Mode

Use chaves de API criadas no modo de teste.

Complete a 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 do modo de teste e siga o fluxo padrão de checkout. As transações de teste são simuladas e nenhuma cobrança real é feita.

Suporte dos SDKs

A disponibilidade das carteiras digitais depende de como você apresenta o checkout.

SDKs Web

As carteiras digitais funcionam em:

Checkout em sobreposição, exceto o Apple Pay.
Checkout inline. O Apple Pay exige verificação de domínio.
Integração direta com a API usando checkout hospedado.

SDKs móveis (Checkout)

Os SDKs de checkout para Android, iOS, React Native e Flutter abrem o checkout hospedado do Dodo Payments no navegador do sistema da plataforma (SFSafariViewController no iOS, Chrome Custom Tabs no Android), não em uma WebView. Apple Pay e Google Pay funcionam ali da mesma forma que na web. Consulte o Guia de integração móvel para configurar.

Práticas recomendadas

Prioritize wallets on mobile

Clientes móveis esperam Apple Pay e Google Pay. Exiba essas opções com destaque nos checkouts móveis.

Complete domain verification early

Se você usar o checkout inline, verifique seu domínio para o Apple Pay durante o desenvolvimento, não no dia do lançamento.

Always include card fallbacks

Nem todo cliente tem uma carteira digital. Inclua credit e debit em allowed_payment_method_types.

Test on real devices

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

Handle wallet unavailability

Uma carteira digital não aparece em um dispositivo incompatível ou quando o cliente não tem cartões salvos. Mantenha outros métodos de pagamento visíveis para esses clientes.

Solução de problemas

Apple Pay button not appearing

Verifique:

Para o checkout inline, o domínio está verificado em Manage domains?
A página é carregada por HTTPS?
O dispositivo usa iOS 17, iPadOS 17 ou Safari 17 ou posterior?
O cliente tem cartões na Apple Wallet?
apple_pay está incluído em allowed_payment_method_types?
O checkout é uma sobreposição? O Apple Pay não está disponível no checkout em sobreposição.

Solução: conclua a verificação de domínio e disponibilize a página por HTTPS. Teste em um dispositivo Apple real.

Apple Pay domain stuck on Pending

Depois que você clicar em Verify domain, o Dodo Payments busca o arquivo de associação no seu domínio e envia o domínio para a Apple. Um domínio que permanece como Pending geralmente tem um arquivo que o Dodo Payments não consegue buscar conforme o esperado.Verifique:

O arquivo está acessível em https://<your-domain>/.well-known/apple-developer-merchantid-domain-association.
Ele é disponibilizado por HTTPS com um certificado válido.
Ele é resolvido sem redirecionamentos. Um redirecionamento para www, para outro host ou para uma página de erro faz a verificação falhar.
Ele é disponibilizado como Content-Type: application/octet-stream ou text/plain, não como text/html.
É o arquivo baixado de Manage domains para esta empresa, não um arquivo reutilizado de outra conta ou provedor.

Para confirmar que o arquivo está acessível publicamente, solicite a URL de fora da sua própria rede, por exemplo, em uma janela de navegação privada. Senhas de staging, barreiras de autenticação e regras de firewall geralmente permitem que a solicitação seja bem-sucedida para você, mas falhe para o Dodo Payments.Solução: corrija o problema de hospedagem e clique novamente em Verify domain. Se o domínio não se tornar Active após uma verificação bem-sucedida, entre em contato com support@dodopayments.com informando o nome do domínio.

Google Pay button not appearing

Verifique:

O cliente está usando um navegador compatível? O Google Pay não aparece no Safari nem em qualquer navegador no iOS.
O cliente tem cartões no Google Pay?
A configuração do Chrome Allow sites to check if you have payment methods saved está ativada?
google_pay está incluído em allowed_payment_method_types?

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

Wallet payment failed

Causas comuns:

O cartão na carteira digital está expirado ou é inválido.
O banco recusou a transação.
Um problema de conexão de rede interrompeu o pagamento.

Solução: peça ao cliente para verificar o cartão na carteira digital ou usar outro método de pagamento.

Wrong device type

As carteiras digitais aparecem somente em dispositivos compatíveis:

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

Solução: isso é esperado. Mantenha os pagamentos com cartão disponíveis como alternativa.

Páginas relacionadas

Payment Methods Overview

Todos os métodos de pagamento compatíveis.

Overlay Checkout

Abra o checkout como uma sobreposição na sua página.

Testing Process

Dados de teste para todos os métodos de pagamento.

Mobile Integration Guide

Abra o checkout hospedado no navegador do sistema, onde Apple Pay e Google Pay funcionam como na web.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Carteiras Suportadas

Apple Pay

Requisitos

Apple Pay na Índia

Verificação de 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 e Cash App Pay

Suporte dos SDKs

SDKs 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

​Apple Pay na Índia

​Verificação de 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 e Cash App Pay

​Suporte dos SDKs

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

Apple Pay na Índia

Verificação de 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 e Cash App Pay

Suporte dos SDKs

SDKs Web

SDKs móveis (Checkout)

Práticas recomendadas

Solução de problemas

Páginas relacionadas