Métodos de Pagamento

O Dodo Payments suporta uma ampla gama de métodos de pagamento para ajudar você a atender clientes globalmente. Todos os métodos de pagamento listados ficam disponíveis automaticamente assim que sua conta de comerciante é verificada e o modo ao vivo é ativado.

Ativação Automática: Nenhuma configuração adicional é necessária da sua parte. Todos os métodos de pagamento são pré-configurados e gerenciados pelo Dodo Payments. Você pode opcionalmente restringir quais métodos aparecem no checkout usando a configuração da API descrita abaixo.

Métodos de Pagamento Suportados

A tabela a seguir fornece uma referência rápida para todos os métodos de pagamento disponíveis, sua disponibilidade regional e limitações principais:

Método de Pagamento	Países Suportados	Moedas Suportadas	Suporta Assinatura
Cartões de Crédito	Global	Todas as moedas	Sim
Cartões de Débito	Global	Todas as moedas	Sim
Apple Pay	Global (Exceto IN)	Todas as moedas	Sim
Google Pay	Global (Exceto IN)	Todas as moedas	Sim
Amazon Pay	Global (Exceto IN)	USD	Não
Cash App Pay	EUA	USD	Não
Afterpay (BNPL)	EUA, Reino Unido	USD, GBP	Não
Klarna (BNPL)	EUA, Europa*	USD, EUR, GBP, DKK, NOK, SEK, CZK, RON, PLN, CHF	Não
PayPal	Global	EUR, GBP	Não
UPI	Índia	INR	Sim*
Rupay (Crédito/Débito)	Índia	INR	Sim*
Bancontact	Bélgica	EUR	Não
EPS	Áustria	EUR	Não
iDEAL	Países Baixos	EUR	Não
Multibanco	Portugal	EUR	Não

Cada transação deve atender ao valor mínimo exigido para cada moeda. Para USD, o mínimo é 0,50 USD. Os mínimos para outras moedas variam por região. Veja Moedas Suportadas & Mínimos

Klarna e Afterpay exigem um valor mínimo de transação de 50,01 USD (ou equivalente em moedas suportadas) para elegibilidade no checkout. Transações abaixo desse limite não serão elegíveis para essas opções de pagamento BNPL.Para detalhes sobre os países suportados pela Klarna, consulte a seção BNPL abaixo.

Métodos de Pagamento Indianos: Assinaturas UPI e Rupay são suportadas com mandatos em conformidade com o RBI. Veja a seção Assinatura com Mandatos em Conformidade com o RBI para detalhes importantes sobre limites de mandatos e atrasos no processamento.

Detalhes do Método de Pagamento

Cartões de Crédito e Débito

O Dodo Payments aceita todas as principais redes de cartões de crédito e débito globalmente. Você pode aceitar:

Visa – Rede global confiável e amplamente aceita
Mastercard – Rede robusta e segura com alcance global
American Express – Benefícios premium e forte atendimento ao cliente
Discover – Recompensas competitivas, forte presença nos EUA
JCB – Principal rede de cartões asiática com alcance em expansão
UnionPay – Dominante na China e na Ásia, com aceitação global crescente
Interac – Rede de pagamento por débito segura do Canadá
Cartes Bancaires – Amplamente utilizada na França
Diners Club – Cartão internacional premium com benefícios exclusivos
Cartões Locais Coreanos – Suporte para redes de cartões domésticos coreanos

Carteiras Digitais

Ofereça aos clientes um checkout rápido e seguro usando carteiras digitais:

Apple Pay – Pague facilmente em iOS, macOS e watchOS
Google Pay – Pagamentos seguros em Android, web e em lojas
PayPal – Pagamentos globais em EUR e GBP (não disponível para assinaturas)
Cash App Pay – Pagamentos móveis para clientes dos EUA (não disponível para assinaturas)
Amazon Pay – Use credenciais da Amazon para um checkout simples (não disponível para assinaturas)

Compre Agora, Pague Depois (BNPL)

Aumente a conversão oferecendo opções de parcelamento flexíveis:

Klarna – Habilite pagamentos flexíveis com as opções da Klarna: pague em 4 parcelas, pague em 30 dias ou financie sua compra. A Klarna está disponível nos EUA e em 19 países europeus, incluindo Áustria, Bélgica, República Tcheca, Dinamarca, Finlândia, França, Alemanha, Grécia, Irlanda, Itália, Países Baixos, Noruega, Polônia, Portugal, Romênia, Espanha, Suécia, Suíça e Reino Unido. As moedas suportadas incluem USD, EUR, GBP, DKK, NOK, SEK, CZK, RON, PLN e CHF.
Afterpay – Permita que os clientes dividam compras em quatro pagamentos sem juros. A Afterpay está disponível nos EUA e no Reino Unido, suportando pagamentos em USD e GBP.

UPI e Rupay (Índia)

Aceite as principais opções de pagamento indianas:

UPI – Clientes escaneiam um código QR ou usam aplicativos (Google Pay, PhonePe, Paytm, CRED) para transferências bancárias instantâneas e sem contato
Cartões Rupay – Pagamentos seguros por crédito e débito via rede de cartões doméstica da Índia

Métodos de Pagamento Europeus

Ofereça opções europeias localizadas para aumentar as conversões:

iDEAL (Países Baixos) – Pagamentos online instantâneos em bancos holandeses
Bancontact (Bélgica) – Método de cartão de débito confiável da Bélgica
Multibanco (Portugal) – Método de pagamento português para transferências bancárias e pagamentos em caixas eletrônicos
EPS (Áustria) – Pagamentos diretos de internet banking na Áustria

Configurando Métodos de Pagamento

Embora todos os métodos de pagamento estejam automaticamente disponíveis com base na localização e moeda do cliente, você pode opcionalmente restringir quais opções de pagamento aparecem durante o checkout usando o parâmetro allowed_payment_method_types.

Quando Configurar Métodos de Pagamento

Você pode querer configurar os métodos de pagamento permitidos para:

Controlar quais opções de pagamento aparecem para os clientes com base em suas necessidades comerciais
Restringir métodos de pagamento para tipos de produtos específicos ou fluxos de transação
Manter consistência em diferentes experiências de pagamento
Otimizar a experiência de checkout para seu público-alvo

Implementação

Adicionar parâmetro à solicitação da API

Inclua o campo allowed_payment_method_types em sua solicitação de criação de pagamento ou assinatura:

{
  "allowed_payment_method_types": [
    "credit",
    "debit",
    "apple_pay"
  ]
}

Teste a configuração

Verifique se apenas os métodos de pagamento especificados aparecem no checkout.

Teste a disponibilidade dos métodos de pagamento com diferentes localizações e moedas de clientes para garantir que a configuração funcione como esperado.

Endpoints da API

Essa configuração é suportada pelos seguintes endpoints:

Criar Sessão de Checkout

Crie sessões de checkout com métodos de pagamento permitidos.

Criar Pagamento

Pagamentos únicos com métodos permitidos.

Criar Assinatura

Pagamentos de assinatura com métodos recorrentes.

Exemplos de Implementação

Pagamento Único
Assinatura
Foco Regional

{
  "amount": 1000,
  "currency": "usd",
  "allowed_payment_method_types": [
    "credit",
    "debit",
    "apple_pay",
    "google_pay"
  ]
}

{
  "product_id": "prod_123",
  "customer_id": "cust_456",
  "allowed_payment_method_types": [
    "credit",
    "debit"
  ]
}

{
  "amount": 5000,
  "currency": "eur",
  "allowed_payment_method_types": [
    "credit",
    "debit",
    "ideal",
    "bancontact",
    "sepa"
  ]
}

Melhores Práticas

Comportamento Padrão

Se allowed_payment_method_types não for especificado, todos os métodos de pagamento elegíveis estarão disponíveis com base na localização do cliente, moeda e tipo de transação. Use este parâmetro apenas quando precisar restringir métodos de pagamento.

Considerações Regionais

Considere seu mercado-alvo ao selecionar métodos de pagamento. Incluir opções específicas da região (como UPI para a Índia ou iDEAL para os Países Baixos) pode melhorar significativamente as taxas de conversão nesses mercados.

Monitorar e otimizar

Acompanhe quais métodos de pagamento seus clientes usam com mais frequência e ajuste seus métodos permitidos com base em padrões de uso real e dados de conversão.

Considerações Importantes

A disponibilidade do método de pagamento depende de múltiplos fatores:

Localização do Cliente: Alguns métodos de pagamento são específicos de região
Configurações do Comerciante: A configuração e capacidades da sua conta
Moeda: Os métodos de pagamento suportados variam por moeda
Tipo de Transação: Alguns métodos não suportam assinaturas ou têm valores mínimos

Adicionar um método de pagamento a allowed_payment_method_types não garante que ele aparecerá - ele também deve ser elegível com base nesses fatores.

Solução de Problemas

Método de pagamento não aparecendo no checkout

Causas possíveis:

O método de pagamento não está incluído em allowed_payment_method_types
O método de pagamento não é suportado para a localização do cliente
O método de pagamento não suporta a moeda da transação
Para assinaturas: o método de pagamento não suporta pagamentos recorrentes
O valor da transação está abaixo do limite mínimo (por exemplo, métodos BNPL)

Solução: Verifique se todos os requisitos de elegibilidade estão atendidos e verifique a configuração da sua solicitação da API.

Métodos de pagamento inesperados aparecendo

Causas possíveis:

O parâmetro allowed_payment_method_types não está sendo passado corretamente
Pode haver configurações conflitantes no seu painel de comerciante

Solução: Revise o payload da sua solicitação da API e assegure-se de que o parâmetro está formatado corretamente como um array de strings.

Método de pagamento regional não disponível

Causas possíveis:

A localização do cliente não corresponde à região suportada pelo método de pagamento
A moeda não é suportada pelo método de pagamento regional
Sua conta de comerciante pode não estar habilitada para esse método de pagamento específico

Solução: Verifique a compatibilidade regional e de moeda, e entre em contato com o suporte se você acreditar que o método deveria estar disponível.

Problemas de assinatura de método de pagamento indiano

Cobrança de assinatura falhou após upgrade/downgrade:

O novo valor da cobrança pode exceder o limite do mandato existente (limite de ₹15.000)
O cliente pode precisar atualizar seu método de pagamento para estabelecer um novo mandato

Solução: Solicite ao cliente que atualize seu método de pagamento ou ajuste o valor da assinatura para permanecer dentro dos limites do mandato.Assinatura em espera após a iniciação da cobrança:

O cliente pode ter cancelado o mandato durante a janela de processamento de 48 horas
O cliente pode não ter autorizado uma cobrança de alto valor (≥₹15.000)

Solução: Monitore eventos de webhook para cancelamentos de mandatos e falhas de pagamento. Implemente lógica de repetição ou solicite aos clientes que restabeleçam seu método de pagamento.Dedução de pagamento atrasada:

Comportamento normal: assinaturas de cartões indianos e UPI têm um atraso de 48 horas entre a iniciação da cobrança e a dedução real
Esse atraso pode se estender por até 2-3 horas adicionais dependendo das APIs bancárias

Solução: Este é um comportamento esperado. Não ative benefícios ou créditos até que a confirmação do pagamento seja recebida via webhooks.

Atualizando métodos de pagamento para assinaturas

Quando atualizar métodos de pagamento:

O cartão do cliente expira ou é substituído
O cliente deseja usar um método de pagamento diferente
A assinatura está em estado on_hold devido a falha de pagamento
O método de pagamento precisa ser alterado por qualquer motivo

Para assinaturas ativas: Atualizar o método de pagamento para uma assinatura ativa simplesmente atualiza o método de pagamento para renovações futuras. Nenhuma cobrança imediata é criada.Para assinaturas em espera: Quando uma assinatura está em estado on_hold (devido a falha de renovação ou falha de cobrança de alteração de plano), atualizar o método de pagamento irá:

Criar automaticamente uma cobrança para as pendências restantes
Gerar uma fatura para a cobrança
Processar o pagamento usando o novo método de pagamento
Reativar a assinatura para o estado active após o pagamento bem-sucedido

// Update payment method for active subscription
await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

// Or use existing payment method
await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'existing',
  payment_method_id: 'pm_abc123'
});

// For on_hold subscription - automatically creates charge
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

if (response.payment_id) {
  // Charge created for remaining dues
  // Redirect customer to response.payment_link
  // Monitor webhooks: payment.succeeded → subscription.active
}

Eventos de webhook:

Para assinaturas on_hold: Você receberá payment.succeeded seguido de subscription.active após a atualização bem-sucedida do método de pagamento
Monitore esses eventos para acompanhar o status de reativação da assinatura

Referência da API para Atualizar Método de Pagamento

Veja a documentação completa da API para atualizar métodos de pagamento.

Estados de Assinatura

Saiba mais sobre os estados de assinatura, incluindo ativo e em espera.

Expandindo Opções de Pagamento

Continuamos a adicionar novos métodos de pagamento ao Dodo Payments. Esta página será atualizada à medida que mais opções se tornem disponíveis. Se você precisar de um método de pagamento específico que não esteja listado aqui, entre em contato conosco pelo [email protected], e consideraremos adicioná-lo ao nosso roadmap.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous