Pular para o conteúdo principal

O que é Preço Localizado?

Todo produto tem um preço base em uma moeda base. O Preço Localizado permite substituir essa base com preços fixos que você define por moeda ou por país. Ative-o configurando um pricing_mode no produto, e então anexe uma regra por mercado. É um de três mecanismos independentes para precificação internacional, cada um resolvendo um problema diferente:
MecanismoO que fazO número que o cliente vê
Preço LocalizadoUm preço fixo que você define por moeda ou paísExatamente o valor que você definiu
Moeda AdaptativaConverte automaticamente seu preço base nas taxas de câmbio ao vivoPreço base convertido na taxa de câmbio atual
Códigos de DescontoUma redução percentual ou fixa sobre o preço basePreço base menos o desconto
Preço Localizado e Moeda Adaptativa funcionam juntos. Quando não há regra localizada correspondente, o produto retorna ao seu preço base — cobrado diretamente se o cliente já estiver na sua moeda base, ou convertido por Moeda Adaptativa se não estiver.

Casos de Uso

Purchasing Power Parity (PPP)

Cobrar menos em mercados sensíveis ao preço sem descontar seu mercado doméstico. Uma regra by_country permite que um produto base de $20 seja vendido por ₹999 na Índia — ajustado ao poder de compra local, não a uma conversão direta de FX. A maneira recomendada e nativa de executar PPP.

Charm Pricing

Uma conversão ao vivo do FX de $19.99 resulta em um número estranho como €18.43. Uma regra by_currency define o preço limpo e ajustado psicologicamente que os clientes esperam — €9.99, ¥1000, ₹499 — exatamente como digitado.

Reversible Market-Entry Promotions

Lançando em um novo país? Adicione uma regra by_country com um preço introdutório, depois arquive-a quando a promoção terminar para retornar ao preço base/adaptativo. As regras são arquivadas, nunca excluídas, para que você mantenha um registro limpo do que estava ativo e quando.

Competitive Price-Matching

Fixe um único mercado para corresponder a um concorrente local. Uma regra by_country para £9.00 no Reino Unido mantém esse preço exato independentemente de como a taxa GBP/USD se move.

Conceitos Principais

  • Modos de precificação — Um produto está exatamente em um modo de cada vez, definido pelo seu pricing_mode:
    • by_currency: um preço por moeda, independentemente do país. Todos pagando em EUR veem €9.99.
    • by_country: um preço específico para um país (₹999 na Índia), mesmo quando vários países compartilham uma moeda.
  • Quantias fixas, na menor unidade — O amount de uma regra é um inteiro na menor unidade da moeda, assim como em qualquer outro lugar na API: 99900 é ₹999.00, 999 é €9.99. É um preço que você define, nunca um valor convertido.
  • Quando nenhuma regra é correspondente — O produto mantém o comportamento existente: clientes na sua moeda base pagam o preço base diretamente; todos os outros o recebem convertido através da Moeda Adaptativa.
  • As taxas estão inclusas quando uma regra é correspondente — O cliente paga exatamente o valor que você definiu. A taxa de FX da Moeda Adaptativa é absorvida por você (tratada como inclusiva para essa transação) em vez de adicionada por cima, para que seu preço local declarado seja sempre o preço cobrado.

Configurar no Painel

1

Open the product form

No seu Painel do Comerciante, vá para Produtos e crie um produto (ou abra um existente para editar). Defina o Preço base e a moeda como de costume.
2

Enable Localized Pricing and choose a mode

Na seção Preços, marque Preço Localizado, depois escolha Por País ou Por Moeda.
Preços Localizados ativados no formulário do produto com Por País selecionado
3

Add a price for each market

Clique em Adicionar Preço por País ou Adicionar Preço por Moeda, preencha o painel de Preco Localizado e clique em Adicionar. Cada mercado que você adicionar aparece na tabela de substituições, onde você pode editar ou removê-lo depois.
Escolha um país, selecione a moeda e insira o valor (por exemplo ₹999 para a Índia), depois clique em Adicionar.
Adicionando uma substituição de 999 INR para a Índia
O país agora aparece na tabela de Substituições por País, onde você pode editá-lo ou removê-lo.
Tabela de substituições por país mostrando Índia a 999 INR
4

Save the product

Salvar com Adicionar produto. Os preços localizados são aplicados nas futuras finalizações de compra imediatamente.
Execute uma finalização de compra de teste com um país de cobrança que tenha uma regra e confirme que o valor localizado aparece.

Gerenciar via API

O Preço Localizado está totalmente disponível na API. Primeiro, defina o modo de precificação do produto, depois anexe regras.

Definir o modo de precificação

Defina pricing_mode quando você criar o produto (ou atualizar um já existente). null significa apenas base, o comportamento existente.
import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  environment: 'test_mode',
});

const product = await client.products.update('pdt_premium_plan', {
  pricing_mode: 'by_country',
});

Adicionar um preço localizado

Anexe uma regra ao produto. No modo by_country o country_code é necessário; no modo by_currency ele deve ser omitido.
// ₹999.00 for customers in India
const localizedPrice = await client.products.localizedPrices.create('pdt_premium_plan', {
  currency: 'INR',
  country_code: 'IN',
  amount: 99900,
});
Para um produto by_currency, omita country_code. Por exemplo, um €9.99 para todos que pagam em EUR (currency: 'EUR', amount: 999).

Listar, atualizar e arquivar

Você pode atualizar apenas o amount de uma regra; moeda e país são fixos uma vez criados. O arquivamento é uma exclusão suave idempotente, então a regra para de corresponder, mas permanece em seu histórico.
// List all active rules on a product
const rules = await client.products.localizedPrices.list('pdt_premium_plan');

// Change the amount (e.g. end a promo)
await client.products.localizedPrices.update('lcp_india_price', {
  product_id: 'pdt_premium_plan',
  amount: 119900,
});

// Archive a rule
await client.products.localizedPrices.archive('lcp_india_price', {
  product_id: 'pdt_premium_plan',
});

API Reference

Veja os endpoints completos de Preços Localizados de Produto: criar, listar, recuperar, atualizar e arquivar.

Como se Aplica na Finalização de Compra

O preço localizado é resolvido por linha de carrinho e apenas para produtos que têm um pricing_mode definido. A Dodo Payments lê dois sinais do pedido: o país de cobrança do cliente e uma billing_currency opcional (quando omitida, uma moeda é derivada do país de cobrança).
  • Por País: procura uma regra que corresponda ao país de cobrança. Se existir, o cliente é cobrado o valor da regra na moeda da regra.
  • Por Moeda: procura uma regra que corresponda à moeda do cliente (o billing_currency, ou a moeda derivada do país dele). Se existir, o cliente é cobrado o valor da regra nessa moeda.
  • Nenhuma correspondência, ou nenhum pricing_mode: o preço base se aplica, cobrado diretamente quando a moeda do cliente é igual à moeda base, caso contrário convertido através da Moeda Adaptativa.
Cada linha de carrinho é resolvida por conta própria, então você pode localizar um produto e deixar outros com precificação base na mesma finalização de compra. Se qualquer linha corresponder a uma regra localizada, a transação inteira força taxas inclusas (veja Conceitos Principais).

Comportamentos Importantes

ComportamentoDetalhe
Quantias antes do impostoUm valor localizado é o preço antes do imposto. Para produtos sem imposto, o imposto é adicionado por cima na finalização de compra, então o valor localizado não é o total final. Veja Preço com Impostos Incluídos.
Não para Pague o Quanto QuiserRegras localizadas nunca se aplicam a produtos Pague o Quanto Quiser, onde o cliente escolhe o valor.
Por-moeda difere da baseUma regra by_currency deve usar uma moeda diferente da moeda base do produto.
Uma regra por mercadoUm produto pode ter no máximo uma regra ativa por moeda (por-moeda) ou por país (por-país).
Todos os tipos de produtoAplica-se a produtos de uso único, assinatura e baseados em uso.
Mudanças em regras localizadas não emitem seus próprios webhooks. O valor resolvido aparece no pagamento ou assinatura resultante exatamente como qualquer outro preço.

Práticas Recomendadas

  • Mantenha um preço base sensato. Ele é o fallback para todos os mercados sem uma regra, convertido através da Moeda Adaptativa.
  • Arredonde para custos psicológicos locais. Todo o ponto de uma quantia fixa é um número limpo como ₹999, €9.99 ou ¥1000, não um resultado de FX.
  • Escolha o modo para o trabalho. Use by_country para precificação baseada no poder de compra; use by_currency quando um preço por zona monetária for suficiente.
  • Arquive, não recrie, para promoções. Arquivar uma regra reverte o mercado para base/adaptativo enquanto preserva o histórico; recrie ou reprecifique mais tarde conforme necessário.
  • Preste atenção na linha de impostos antes de anunciar um total. Para produtos sem imposto, o cliente paga o valor localizado mais imposto, então não o cite como o preço final em anúncios.

Relacionados

Purchasing Power Parity

Preços localizados nativos vs. códigos de desconto baseados na localização para PPP.

Adaptive Currency

Conversão automática de FX e o tratamento de taxas que a precificação localizada constrói.

Tax-Inclusive Pricing

Controle se seus preços incluem imposto.

Pay What You Want

Deixe os clientes escolherem o valor. Regras localizadas não se aplicam lá.
Última modificação em 26 de junho de 2026