Moeda Adaptativa - Dodo Payments Documentation

A Moeda Adaptativa permite mostrar preços localizados e aceitar pagamentos na moeda local dos clientes. Isso reduz atritos no checkout e gera confiança.

O Que É Moeda Adaptativa?

A Moeda Adaptativa exibe os preços dos produtos na moeda local do cliente em vez de uma moeda global fixa (por exemplo, USD). Quando ativada, o checkout padrão é a moeda local detectada para os países suportados, com a opção de alternar para USD. Adaptive Currency converte seu preço base nas taxas de câmbio em tempo real. Para definir seu próprio preço fixo por moeda ou país, veja Preços Localizados.

Benefícios Principais

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 que ele pagou.

Ativar Moeda Adaptativa

Open Settings

Faça login no seu Painel do Comerciante e vá para Configurações → Negócios.

Toggle Adaptive Pricing

Ative a opção de Preço Adaptativo. Você pode desativá-lo a qualquer momento.

As alterações se aplicam apenas a transações futuras.

Confirm and Save

Salve suas configurações.

Verifique se um teste de checkout mostra preços na sua moeda local quando suportado.

Experiência do Cliente

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

Conversão e Tarifas

Adaptive Currency cobra o cliente na moeda local usando as taxas de câmbio mais recentes.

Você paga: 0% (padrão) ou 2–4% (quando tarifas inclusivas estão ativadas)
Seus clientes pagam: 2–4% com base no valor do pedido (padrão) ou 0% (quando tarifas inclusivas estão ativadas)

Tarifas escalonadas aplicadas na finalização da compra:

4% para pedidos abaixo de $500
3% de 500 a $1,500
2% para acima de $1,500

Escolha quem arca com a tarifa

Por padrão, as tarifas de moeda adaptativa são adicionadas ao seu preço exibido e suportadas pelo cliente. Com a configuração Tarifas Inclusivas, você pode absorver a tarifa: o cliente vê o mesmo preço na moeda local que sempre veria, e a tarifa é deduzida do seu pagamento.

Enable Adaptive Pricing

Vá para Configurações → Negócios e ative a opção de Preço Adaptativo se ainda não o fez.

Toggle Fees Inclusive

Assim que o Preço Adaptativo estiver ativado, habilite a sub-opção Tarifas Inclusivas na mesma seção.

Modo	Cliente vê	Comerciante liquida
Exclusivo (padrão)	Preço local + tarifa de 2–4%	Preço base completo
Inclusivo	Preço local (inalterado)	Preço base menos a tarifa de 2–4%

Você também pode substituir o padrão do comerciante por solicitação passando adaptive_currency_fees_inclusive (booleano) em uma sessão de checkout, pagamento ou assinatura sob demanda:

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'
});

Transações INR → INR são sempre tratadas como inclusivas, independentemente da configuração do negócio ou substituição por solicitação.

Quando uma regra de Preços Localizados é correspondida, a transação é sempre tratada como inclusiva, independentemente da sua configuração de Tarifas Inclusivas ou qualquer substituição por solicitação. O cliente paga exatamente o valor localizado que você definiu, e a tarifa de conversão é deduzida do seu pagamento.

Moedas Suportadas

Código da Moeda	Nome da Moeda	Países	Quantidade Mínima
AED	Dirham dos Emirados Árabes Unidos	Emirados Árabes Unidos	2.00 AED
ALL	Lek Albanês	Albânia	50.00 ALL
AMD	Dram Armênio	Armênia	500.00 AMD
AUD	Dólar Australiano	Austrália, Nauru	0.50 AUD
AWG	Florim Arubano	Aruba	2.00 AWG
AZN	Manat Azeri	Azerbaijão	2.00 AZN
BAM	Marco Conversível da Bósnia-Herzegovina	Bósnia e Herzegovina	2.00 BAM
BDT	Taka de Bangladesh	Bangladesh	100.00 BDT
BMD	Dólar das Bermudas	Bermuda	1.00 BMD
BND	Dólar do Brunei	Brunei	1.00 BND
BOB	Boliviano	Bolívia	5.00 BOB
BRL	Real Brasileiro	Brasil	0.50 BRL
BSD	Dólar das Bahamas	Bahamas	1.00 BSD
BWP	Pula de Botswana	Botswana	15.00 BWP
BZD	Dólar do Belize	Belize	2.00 BZD
CAD	Dólar Canadense	Canadá	0.50 CAD
CHF	Franco Suíço	Suíça, Liechtenstein	0.50 CHF
CLP	Peso Chileno	Chile	1000.00 CLP
CNY	Iuan Chinês	China	4.00 CNY
CRC	Colón Costa-riquenho	Costa Rica	500.00 CRC
CZK	Coroa Checa	República Checa	15.00 CZK
DKK	Coroa Dinamarquesa	Dinamarca, Groenlândia	2.50 DKK
DOP	Peso Dominicano	República Dominicana	100.00 DOP
EGP	Libra Egípcia	Egito	50.00 EGP
ETB	Birr Etíope	Etiópia	100.00 ETB
EUR	Euro	Áustria, Bélgica, Chipre, Estônia, Finlândia, França, Alemanha, Grécia, Irlanda, Itália, Letônia, Lituânia, Luxemburgo, Malta, Países Baixos, Portugal, Eslováquia, Eslovênia, Espanha, Andorra, Mônaco, Croácia, San Marino, Montenegro	0.50 EUR
FJD	Dólar Fijiano	Fiji	2.00 FJD
GBP	Libra Esterlina	Reino Unido	0.30 GBP
GEL	Lari Georgiano	Geórgia	3.00 GEL
GMD	Dalasi Gambiano	Gâmbia	100.00 GMD
GTQ	Quetzal Guatemalteco	Guatemala	10.00 GTQ
GYD	Dólar Guianês	Guiana	200.00 GYD
HKD	Dólar de Hong Kong	Hong Kong	4.00 HKD
HNL	Lempira Hondurenha	Honduras	25.00 HNL
HUF	Forint Húngaro	Hungria	175.00 HUF
IDR	Rupia Indonésia	Indonésia	8500.00 IDR
ILS	Novo Shekel Israelense	Israel	3.00 ILS
INR	Rúpia Indiana	Índia	5.00 INR
JPY	Iene Japonês	Japão	50 JPY
KRW	Won Sul-Coreano	Coreia do Sul	50 KRW
KZT	Tenge Cazaque	Cazaquistão	500.00 KZT
LKR	Rúpia de Sri Lanka	Sri Lanka	300.00 LKR
LRD	Dólar Liberiano	Libéria	200.00 LRD
LSL	Loti Lesotiano	Lesoto	20.00 LSL
MAD	Dirham Marroquino	Marrocos	10.00 MAD
MKD	Dinar Macedônio	Macedônia do Norte	50.00 MKD
MOP	Pataca de Macau	Macau	10.00 MOP
MUR	Rúpia Mauriciana	Maurícia	50.00 MUR
MVR	Rupia Maldiva	Maldivas	15.00 MVR
MWK	Kwacha Malauiana	Malawi	2000.00 MWK
MXN	Peso Mexicano	México	10.00 MXN
MYR	Ringgit Malaio	Malásia	4.00 MYR
NGN	Naira Nigeriana	Nigéria	2000.00 NGN
NOK	Coroa Norueguesa	Noruega	3.00 NOK
NPR	Rúpia Nepalesa	Nepal	150.00 NPR
NZD	Dólar Neozelandês	Nova Zelândia	1.00 NZD
PEN	Sol Peruano	Peru	3.00 PEN
PGK	Kina Papua-Nova Guiné	Papua Nova Guiné	4.00 PGK
PHP	Peso Filipino	Filipinas	50.00 PHP
PLN	Zloty Polonês	Polônia	2.00 PLN
PYG	Guarani Paraguaio	Paraguai	4000 PYG
QAR	Rial do Catar	Catar	3.00 QAR
RON	Leu Romeno	Romênia	2.00 RON
RSD	Dinar Sérvio	Sérvia	60.00 RSD
SAR	Riyal Saudita	Arábia Saudita	2.00 SAR
SBD	Dólar das Ilhas Salomão	Ilhas Salomão	10.00 SBD
SCR	Rúpia de Seicheles	Seicheles	15.00 SCR
SEK	Coroa Sueca	Suécia	3.00 SEK
SGD	Dólar de Singapura	Singapura	0.50 SGD
SZL	Lilangeni Suazi	Eswatini	20.00 SZL
THB	Baht Tailandês	Tailândia	25.00 THB
TOP	Paʻanga Tongolesa	Tonga	2.00 TOP
TRY	Lira Turca	Turquia	20.00 TRY
TWD	Novo Dólar Taiwanês	Taiwan	20.00 TWD
TZS	Xelim Tanzaniano	Tanzânia	3000.00 TZS
UYU	Peso Uruguaio	Uruguai	50.00 UYU
VND	Dong Vietnamita	Vietnã	12000 VND
WST	Tala Samoana	Samoa	2.00 WST
XAF	Franco CFA Central Africano	Camarões, República Centro-Africana, Chade, República do Congo, Guiné Equatorial, Gabão	300 XAF
XOF	Franco CFA Ocidental Africano	Benin, Burkina Faso, Costa do Marfim, Guiné-Bissau, Mali, Níger, Senegal, Togo	300 XOF
ZAR	Rand Sul-Africano	África do Sul	20.00 ZAR
ZMW	Kwacha Zambiano	Zâmbia	30.00 ZMW

Reembolsos e Ajustes

A Dodo Payments emite reembolsos na moeda em que o cliente originalmente pagou, usando a taxa de câmbio mais recente. O valor global em USD permanece fixo no seu painel, nas faturas e no reembolso. Isso significa que o cliente pode receber mais ou menos que o valor original na moeda local dependendo das mudanças no câmbio.

As tarifas de Moeda Adaptativa, que geralmente são as tarifas de câmbio, não são reembolsadas.

Exemplo de reembolso

Você vende um produto por 100 USD com Moeda Adaptativa ativada.
Um cliente canadense vê 137 CAD a uma taxa de câmbio de 1.37 CAD por 1 USD e conclui a compra.
Processamos o pagamento, convertendo 137 CAD para 100 USD para sua liquidação.
Posteriormente, a taxa de câmbio muda para 1.40 CAD por 1 USD e você emite um reembolso completo.
Deduzimos 100 USD e reembolsamos o cliente com 140 CAD.

Faturas e Tributação

As faturas mostram apenas o valor na moeda de liquidação.
Impostos e taxas de plataforma são calculados sobre o valor na moeda de liquidação.
Exemplo: uma venda de $10 convertida para 36 AED ainda se reflete como $10 no Painel e nas faturas.

Todos os valores são arredondados de acordo com a lógica interna de arredondamento da Dodo Payments.

Exemplos de Integração

Sessões de Checkout com moeda de cobrança Passe billing_currency para definir explicitamente a moeda de cobrança para a sessão.

Quando o Preço Adaptativo está desativado, billing_currency é ignorado.

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'
});

Checkout Session

Configure a Moeda de Cobrança usando nossa API de Sessão de Checkout.

​O Que É Moeda Adaptativa?

​Benefícios Principais

​Ativar Moeda Adaptativa

​Experiência do Cliente

​Conversão e Tarifas

​Escolha quem arca com a tarifa

​Moedas Suportadas

​Reembolsos e Ajustes

​Faturas e Tributação

​Exemplos de Integração

Checkout Session

O Que É Moeda Adaptativa?

Benefícios Principais

Ativar Moeda Adaptativa

Experiência do Cliente

Conversão e Tarifas

Escolha quem arca com a tarifa

Moedas Suportadas

Reembolsos e Ajustes

Faturas e Tributação

Exemplos de Integração