Preços Localizados

​

O que é Preço Localizado?

​

Casos de Uso

​

Conceitos principais

• Modos de precificação — Um produto está exatamente em um modo por vez, definido por seu pricing_mode:
  • by_currency: um preço por moeda, independentemente do país. Todos que pagam 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.
• Valores fixos, na menor unidade — O amount de uma regra é um inteiro na menor unidade da moeda, assim como em todo o restante da API: 99900 corresponde a ₹999,00, e 999 corresponde a €9,99. É um preço definido por você, nunca um valor convertido.
• Uma regra correspondente prevalece sobre a precificação automática — Quando uma regra localizada se aplica a uma linha, Purchasing Power Parity e Charm Pricing são ignorados para essa linha. No checkout, o cliente paga o valor definido por você, sem alterações. Em uma mudança de plano de assinatura, uma regra em uma moeda diferente da assinatura é convertida; consulte How It Applies on Subscription Plan Changes.
• Quando nenhuma regra corresponde — O produto mantém seu comportamento existente: clientes na sua moeda base pagam o preço base diretamente; todos os demais têm o valor convertido por meio de Adaptive Currency.
• As tarifas são incluídas quando uma regra corresponde — O cliente paga exatamente o valor definido por você. A tarifa de câmbio de Adaptive Currency é absorvida por você (tratada como tarifas incluídas nessa transação), em vez de ser adicionada ao valor, para que o preço local informado seja sempre o preço cobrado.

​

Configurar no Dashboard

1

Open the product form

No Merchant Dashboard, acesse Products e crie um produto (ou abra um produto existente para editá-lo). Defina o Price base e a moeda normalmente.

2

Enable Localized Pricing and choose a mode

Na seção Pricing, marque Localized Pricing e escolha By Country ou By Currency.

3

Add a price for each market

Clique em Add Country Price ou Add Currency Price, preencha o painel Localized pricing e clique em Add. Cada mercado adicionado aparece na tabela de substituições, onde você pode editá-lo ou removê-lo posteriormente.

• By Country
• By Currency

Escolha um país, selecione a moeda e informe o valor (por exemplo, ₹999 para a Índia); depois, clique em Add.

O país agora aparece na tabela Country overrides, onde você pode editá-lo ou removê-lo.

Escolha uma moeda, informe o valor (por exemplo, €9,99 para EUR) e clique em Add.

A moeda agora aparece na tabela Currency overrides, onde você pode editá-la ou removê-la.

4

Save the product

Salve com Add product. Os preços localizados se aplicam imediatamente a checkouts futuros.

Execute um checkout de teste usando um país de cobrança que tenha uma regra e confirme se o valor localizado aparece.

​

Gerenciar pela API

​

Definir o modo de precificação

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

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),
    environment="test_mode",
)

product = client.products.update(
    "pdt_premium_plan",
    pricing_mode="by_country",
)

package main

import (
	"context"
	"os"

	"github.com/dodopayments/dodopayments-go"
	"github.com/dodopayments/dodopayments-go/option"
)

func main() {
	client := dodopayments.NewClient(
		option.WithBearerToken(os.Getenv("DODO_PAYMENTS_API_KEY")),
	)

	err := client.Products.Update(
		context.TODO(),
		"pdt_premium_plan",
		dodopayments.ProductUpdateParams{
			PricingMode: dodopayments.F(dodopayments.PricingModeByCountry),
		},
	)
	if err != nil {
		panic(err)
	}
}

​

Adicionar um preço localizado

// ₹999.00 for customers in India
const localizedPrice = await client.products.localizedPrices.create('pdt_premium_plan', {
  currency: 'INR',
  country_code: 'IN',
  amount: 99900,
});

# ₹999.00 for customers in India
localized_price = client.products.localized_prices.create(
    "pdt_premium_plan",
    currency="INR",
    country_code="IN",
    amount=99900,
)

// ₹999.00 for customers in India
localizedPrice, err := client.Products.LocalizedPrices.New(
	context.TODO(),
	"pdt_premium_plan",
	dodopayments.ProductLocalizedPriceNewParams{
		Currency:    dodopayments.F(dodopayments.CurrencyInr),
		CountryCode: dodopayments.F(dodopayments.CountryCodeIn),
		Amount:      dodopayments.F(int64(99900)),
	},
)

​

Listar, atualizar e arquivar

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

# List all active rules on a product
rules = client.products.localized_prices.list("pdt_premium_plan")

# Change the amount (e.g. end a promo)
client.products.localized_prices.update(
    "lcp_india_price",
    product_id="pdt_premium_plan",
    amount=119900,
)

# Archive a rule
client.products.localized_prices.archive(
    "lcp_india_price",
    product_id="pdt_premium_plan",
)

// List all active rules on a product
_, err := client.Products.LocalizedPrices.List(context.TODO(), "pdt_premium_plan")

// Change the amount (e.g. end a promo)
_, err = client.Products.LocalizedPrices.Update(
	context.TODO(),
	"pdt_premium_plan",
	"lcp_india_price",
	dodopayments.ProductLocalizedPriceUpdateParams{
		Amount: dodopayments.F(int64(119900)),
	},
)

// Archive a rule
err = client.Products.LocalizedPrices.Archive(
	context.TODO(),
	"pdt_premium_plan",
	"lcp_india_price",
)

​

Como se aplica no checkout

• By Country: procura uma regra correspondente ao país de cobrança. Se existir, o cliente será cobrado pelo valor da regra na moeda da regra.
• By Currency: procura uma regra correspondente à moeda do cliente (o billing_currency ou a moeda derivada do país). Se existir, o cliente será cobrado pelo valor da regra nessa moeda.
• Sem correspondência ou sem pricing_mode: o preço base se aplica, cobrado diretamente quando a moeda do cliente for igual à moeda base; caso contrário, será convertido por meio de Adaptive Currency.

​

Como se aplica a mudanças de plano de assinatura

• By Country: aplica-se uma regra correspondente ao país de cobrança da assinatura. Se a moeda da regra for diferente da moeda em que a assinatura é cobrada, o valor da regra será convertido pelas taxas de câmbio em tempo real — a regra é aplicada, não ignorada.
• By Currency: aplica-se uma regra correspondente à moeda em que o cliente é cobrado, e o cliente paga exatamente o valor da regra.
• Sem correspondência ou sem pricing_mode: aplica-se o preço base do novo plano, convertido por meio de Adaptive Currency quando necessário — o mesmo fallback do checkout.

• As prévias são exatas. Preview Change Plan retorna o mesmo valor localizado cobrado pela mudança efetiva.
• As renovações mantêm o preço localizado. Após a mudança, o novo plano é renovado pelo valor localizado — e continua com as tarifas incluídas — exatamente como uma assinatura criada por esse preço.
• O rateio usa valores reais. Em um upgrade, o crédito pelo tempo não utilizado é baseado no que o cliente realmente pagou pelo plano antigo, enquanto o novo plano é precificado pela regra localizada.
• As mudanças agendadas fixam o preço no momento do agendamento. Uma mudança agendada para o fim do período de cobrança cobra o valor calculado no momento do agendamento, mesmo que você edite a regra nesse intervalo.
• A moeda de cobrança nunca muda. Uma mudança de plano nunca altera a moeda em que uma assinatura é liquidada; uma regra em outra moeda é convertida por câmbio para essa moeda.
• Add-ons não são localizados. Os preços de add-ons no novo plano sempre usam a precificação base.

​

Comportamentos importantes

​

Práticas recomendadas

• Mantenha um preço base sensato. Ele é o fallback para todos os mercados sem uma regra, convertido por meio de Adaptive Currency.
• Digite valores simples. O objetivo de um valor fixo é ter um preço organizado, como ₹999, €9,99 ou ¥1000, e não um resultado de câmbio. Para arredondamento automático em todas as moedas, consulte Charm Pricing.
• Escolha o modo adequado. 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 em vez de recriar para promoções. Arquivar uma regra reverte o mercado para a precificação base/adaptativa e preserva o histórico; recrie ou defina um novo preço posteriormente, conforme necessário.
• Considere os impostos antes de anunciar um total. Para produtos com impostos não incluídos, o cliente paga o valor localizado mais os impostos; portanto, não o informe como preço final em anúncios.

​

Relacionados