Moeda Adaptativa

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.

​

O Que É Moeda Adaptativa?

​

Principais Benefícios

• Experiência de pagamento localizada: Os preços aparecem na moeda local por padrão.
• Mais métodos de pagamento: Desbloqueia métodos de pagamento disponíveis para a moeda local.
• Reembolsos na mesma moeda: Reembolse o cliente na moeda com a qual ele pagou.

​

Ativar Moeda Adaptativa

​

Experiência do Cliente

1. Detecção: O sistema detecta o país do cliente com base no endereço de cobrança.
2. Seleção de moeda: Se o país for suportado, os preços são exibidos na moeda local por padrão. Os clientes podem alternar para USD.
3. Métodos de pagamento: Métodos de pagamento localizados aparecem onde aplicável.
4. Checkout: O pagamento é concluído na moeda selecionada.

​

Conversão e Taxas

• Você paga: 0% (padrão) ou 2–4% (quando a taxa inclusiva está ativada)
• Seus clientes pagam: 2–4% com base no valor do pedido (padrão) ou 0% (quando a taxa inclusiva está ativada)

• 4% para pedidos abaixo de $500
• 3% para pedidos de $500 a$1.500
• 2% para pedidos acima de $1.500

​

Escolha quem arca com a taxa

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_abc', quantity: 1 }],
  adaptive_currency_fees_inclusive: true, // override the business setting for this session
  return_url: 'https://yoursite.com/return'
});

​

Moedas Suportadas

​

Reembolsos e Ajustes

1. Você vende um produto por 100 USD com Moeda Adaptável ativada.
2. Um cliente canadense vê 137 CAD a uma taxa de câmbio de 1,37 CAD por 1 USD e completa a compra.
3. Nós processamos o pagamento, convertendo 137 CAD para 100 USD para o seu acerto.
4. Mais tarde, a taxa de câmbio muda para 1,40 CAD por 1 USD e você emite um reembolso total.
5. Nós deduzimos 100 USD e reembolsamos o cliente com 140 CAD.

​

Faturas e Tributação

• As faturas mostram apenas o valor da moeda de acerto.
• Impostos e taxas de plataforma são calculados com base no valor da moeda de acerto.
• Exemplo: uma venda de $10 convertida para 36 AED ainda é refletida como$10 no Painel e nas faturas.

​

Exemplos de Integração

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_one_time_or_subscription',
      quantity: 1
    }
  ],
  billing_currency: 'AED',
  return_url: 'https://example.com/return'
});