Moeda Adaptativa

Adaptive Currency exibe os preços dos produtos na moeda local do cliente, em vez de apenas na sua moeda-base. Quando ativado, o checkout usa por padrão a moeda local detectada para os países compatíveis, com a opção de voltar à sua moeda-base.

Como funciona

Sua moeda-base é aquela em que você definiu o preço do produto ou adicional — ela pode ser qualquer moeda que o Dodo Payments possa cobrar, não apenas USD. Adaptive Currency converte esse preço-base usando taxas de câmbio em tempo real. Para definir seu próprio preço fixo por moeda ou país, consulte Localized Pricing.

Principais benefícios

Checkout localizado — Os preços aparecem por padrão na moeda local do cliente
Mais métodos de pagamento — Desbloqueia métodos de pagamento disponíveis apenas para a moeda local
Reembolsos na mesma moeda — Reembolse o cliente na moeda usada no pagamento
Precificação avançada — Ativa Purchasing Power Parity e Charm Pricing para otimização automática de preços por mercado

Ativar o Adaptive Currency

Open Settings

Acesse o Merchant Dashboard e vá para Settings → Business.

Enable Adaptive Currency

Ative o Adaptive Currency. Você pode desativá-lo a qualquer momento.

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

Save and Test

Salve suas configurações e verifique se um checkout de teste exibe os preços na sua moeda local quando compatível.

Experiência do cliente

Quando o Adaptive Currency está ativado:

Detecção — O sistema detecta o país do cliente com base no endereço de cobrança
Seleção da moeda — Se o país for compatível, os preços serão exibidos por padrão na moeda local. Os clientes podem voltar à sua moeda-base
Métodos de pagamento — Métodos de pagamento locais aparecem quando aplicável
Checkout — O pagamento é concluído na moeda selecionada

Conversão e tarifas

Adaptive Currency cobra o cliente na moeda local usando taxas de câmbio em tempo real. As tarifas variam conforme o valor do pedido:

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

Por padrão, essas tarifas são adicionadas ao preço exibido e ficam a cargo do cliente. Com a configuração Fees Inclusive, você pode absorver a tarifa: o cliente vê o mesmo preço na moeda local, e a tarifa é deduzida do seu repasse.

Ativar Fees Inclusive

Open Settings

Acesse Settings → Business e ative o Adaptive Currency, caso ainda não tenha feito isso.

Enable Fees Inclusive

Depois de ativar o Adaptive Currency, ative o botão Fees Inclusive na mesma seção.

Mode	Customer Sees	Merchant Settles
Exclusive (default)	Preço local + tarifa de 2–4% adicional	Preço-base integral
Inclusive	Preço local (inalterado)	Preço-base menos a tarifa de 2–4%

Substituir por solicitação

Você pode substituir o padrão do merchant por solicitação passando adaptive_currency_fees_inclusive (boolean) em um pagamento único, uma assinatura sob demanda (on_demand.adaptive_currency_fees_inclusive), uma cobrança de assinatura ou uma alteração de plano. Em sessões de checkout, ele é aceito apenas para assinaturas sob demanda, como subscription_data.on_demand.adaptive_currency_fees_inclusive, e não no nível superior da solicitação:

// Note: POST /payments is deprecated. Checkout sessions don't accept
// `adaptive_currency_fees_inclusive` for one-time payments, so this override
// still runs through the one-time payment route.
const payment = await client.payments.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  customer: { customer_id: 'cus_123' },
  billing: { country: 'US' },
  adaptive_currency_fees_inclusive: true, // override the business setting for this payment
  return_url: 'https://yoursite.com/return'
});

As transações INR → INR são sempre tratadas como inclusivas, independentemente da configuração da empresa ou da substituição por solicitação.

Quando uma regra de Localized Pricing corresponde, a transação é sempre tratada como inclusiva, independentemente da configuração Fees Inclusive ou de qualquer substituição por solicitação. O cliente paga exatamente o valor localizado definido por você, e a tarifa de conversão é deduzida do seu repasse.

Valores mínimos

Todo pagamento deve atingir o mínimo da moeda em que o cliente paga, e as assinaturas têm valores mínimos maiores do que os pagamentos únicos. Os mesmos valores mínimos se aplicam a todos os métodos de pagamento. A verificação usa o total, incluindo impostos.

Moeda de cobrança	Pagamentos únicos	Assinaturas
USD	$0.50	$1.00
EUR e GBP	0.50 EUR, 0.30 GBP	0.50 EUR, 0.30 GBP
Todas as outras moedas	O mínimo em Moedas aceitas, e pelo menos o equivalente a $0.50	O mínimo em Moedas aceitas, e pelo menos o equivalente a $1.00

Pagamentos em moedas diferentes de USD, EUR e GBP são liquidados em USD. Para essas moedas, o checkout primeiro verifica o preço convertido para USD, antes da cobrança da taxa de Adaptive Currency, e depois verifica o valor na moeda do cliente. O valor deve passar por ambas as verificações, portanto o mínimo efetivo pode ser maior do que o mínimo listado para a moeda. Por exemplo, o mínimo listado para AED é 2.00 AED, mas uma assinatura em AED deve valer pelo menos $1.00, o que corresponde a aproximadamente 3.70 AED. Uma assinatura de 2.00 AED não passa na verificação em USD. Se um pagamento estiver abaixo do mínimo, a API retornará TOTAL_PAYMENT_AMOUNT_BELOW_MINIMUM_AMOUNT. A mensagem informa qual mínimo não foi atingido. Para um pagamento em outra moeda, esse pode ser o mínimo em USD, como Minimum amount of 1.00 USD is required to process payment.

Moedas aceitas

A tabela lista o valor mínimo de cada moeda. O mínimo se aplica a pagamentos únicos e assinaturas. Consulte Valores mínimos para verificação adicional em USD.

Código da moeda	Nome da moeda	Países	Valor mínimo
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 bengalês	Bangladesh	100.00 BDT
BMD	Dólar bermudense	Bermudas	1.00 BMD
BND	Dólar de Brunei	Brunei	1.00 BND
BOB	Boliviano boliviano	Bolívia	5.00 BOB
BRL	Real brasileiro	Brasil	0.50 BRL
BSD	Dólar bahamense	Bahamas	1.00 BSD
BWP	Pula botsuanês	Botsuana	15.00 BWP
BZD	Dólar belizenho	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	500 CLP
CNY	Yuan chinês	China	4.00 CNY
CRC	Colón costa-riquenho	Costa Rica	500.00 CRC
CZK	Coroa tcheca	República Tcheca	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 guianense	Guiana	200.00 GYD
HKD	Dólar de Hong Kong	Hong Kong	4.00 HKD
HNL	Lempira hondurenha	Honduras	25.00 HNL
HUF	Florim 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 do Sri Lanka	Sri Lanka	300.00 LKR
LRD	Dólar liberiano	Libéria	200.00 LRD
LSL	Loti do Lesoto	Lesoto	20.00 LSL
MAD	Dirham marroquino	Marrocos	10.00 MAD
MKD	Denar macedônio	Macedônia do Norte	50.00 MKD
MOP	Pataca macaense	Macau	10.00 MOP
MUR	Rúpia mauriciana	Maurício	50.00 MUR
MVR	Rufiyaa maldiva	Maldivas	15.00 MVR
MWK	Kwacha malauiano	Malaui	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 papuásia	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 catari	Catar	3.00 QAR
RON	Leu romeno	Romênia	2.00 RON
RSD	Dinar sérvio	Sérvia	60.00 RSD
SAR	Rial saudita	Arábia Saudita	2.00 SAR
SBD	Dólar das Ilhas Salomão	Ilhas Salomão	10.00 SBD
SCR	Rúpia seichelense	Seicheles	15.00 SCR
SEK	Coroa sueca	Suécia	3.00 SEK
SGD	Dólar de Singapura	Singapura	0.50 SGD
SZL	Lilangeni suazi	Essuatíni	20.00 SZL
THB	Baht tailandês	Tailândia	25.00 THB
TOP	Paʻanga tonganês	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 samoano	Samoa	2.00 WST
XAF	Franco CFA da África Central	Camarões, República Centro-Africana, Chade, República do Congo, Guiné Equatorial, Gabão	300 XAF
XOF	Franco CFA da África Ocidental	Benim, 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

Dodo Payments emite reembolsos na moeda originalmente paga pelo cliente, usando a taxa de câmbio mais recente. O valor na sua moeda base permanece fixo no Dashboard, nas faturas e no reembolso. Dependendo das variações cambiais, o cliente pode receber mais ou menos do que o valor original na moeda local.

As taxas de Adaptive Currency (taxas de câmbio) não são reembolsadas.

Exemplo de reembolso

Você vende um produto por 100 USD com Adaptive Currency ativado
Um cliente canadense vê 137 CAD a uma taxa de câmbio de 1.37 CAD por 1 USD e conclui a compra
Dodo Payments processa o pagamento, convertendo 137 CAD em 100 USD para sua liquidação
Mais tarde, a taxa de câmbio muda para 1.40 CAD por 1 USD e você emite um reembolso integral
Dodo Payments desconta 100 USD e reembolsa o cliente em 140 CAD

Faturas e tributação

As faturas mostram apenas o valor na moeda de liquidação
Os impostos e as taxas da plataforma são calculados sobre o valor na moeda de liquidação
Exemplo: uma venda de $10 convertida para 36 AED ainda aparece como $10 no Dashboard e nas faturas

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

Definir a moeda de cobrança por checkout

Passe billing_currency para definir explicitamente a moeda de cobrança de uma sessão de checkout:

Quando Adaptive Currency está desativado, billing_currency é ignorado.

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

Páginas relacionadas

Purchasing Power Parity

Reduza os preços automaticamente por país. Requer Adaptive Currency.

Charm Pricing

Arredonde os preços convertidos para finais simples, como 49.99. Requer Adaptive Currency.

Localized Pricing

Defina um preço exato por país ou moeda em vez da conversão automática.

Tax-Inclusive Pricing

Controle se os preços incluem impostos.

Checkout Session

Crie sessões de checkout com configuração de moeda de cobrança.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Como funciona

Principais benefícios

Ativar o Adaptive Currency

Experiência do cliente

Conversão e tarifas

Ativar Fees Inclusive

Substituir por solicitação

Valores mínimos

Moedas aceitas

Reembolsos e ajustes

Exemplo de reembolso

Faturas e tributação

Definir a moeda de cobrança por checkout

Páginas relacionadas

Purchasing Power Parity

Charm Pricing

Localized Pricing

Tax-Inclusive Pricing

Checkout Session

​Como funciona

​Principais benefícios

​Ativar o Adaptive Currency

​Experiência do cliente

​Conversão e tarifas

​Ativar Fees Inclusive

​Substituir por solicitação

​Valores mínimos

​Moedas aceitas

​Reembolsos e ajustes

​Exemplo de reembolso

​Faturas e tributação

​Definir a moeda de cobrança por checkout

​Páginas relacionadas

Purchasing Power Parity

Charm Pricing

Localized Pricing

Tax-Inclusive Pricing

Checkout Session

Como funciona

Principais benefícios

Ativar o Adaptive Currency

Experiência do cliente

Conversão e tarifas

Ativar Fees Inclusive

Substituir por solicitação

Valores mínimos

Moedas aceitas

Reembolsos e ajustes

Exemplo de reembolso

Faturas e tributação

Definir a moeda de cobrança por checkout

Páginas relacionadas