Localized Pricing

​

What Is Localized Pricing?

​

Use Cases

​

Core Concepts

• Pricing modes — A product is in exactly one mode at a time, set by its pricing_mode:
  • by_currency: one price per currency, regardless of country. Everyone paying in EUR sees €9.99.
  • by_country: a price specific to a country (₹999 in India), even when several countries share a currency.
• Fixed amounts, in the smallest unit — A rule’s amount is an integer in the currency’s smallest unit, the same as everywhere else in the API: 99900 is ₹999.00, 999 is €9.99. It’s a price you set, never a converted value.
• When no rule matches — The product keeps its existing behavior: customers in your base currency pay the base price directly; everyone else gets it converted through Adaptive Currency.
• Fees are inclusive when a rule matches — The customer pays exactly the amount you set. The Adaptive Currency FX fee is absorbed by you (treated as fees-inclusive for that transaction) rather than added on top, so your stated local price is always the price charged.

​

Set Up in the Dashboard

1

Open the product form

In your Merchant Dashboard, go to Products and create a product (or open an existing one to edit). Set the base Price and currency as usual.

2

Enable Localized Pricing and choose a mode

In the Pricing section, tick Localized Pricing, then choose By Country or By Currency.

3

Add a price for each market

Click Add Country Price or Add Currency Price, fill in the Localized pricing panel, and click Add. Each market you add appears in the overrides table, where you can edit or remove it later.

• By Country
• By Currency

Pick a country, choose the currency, and enter the amount (for example ₹999 for India), then click Add.

The country now appears in the Country overrides table, where you can edit or remove it.

Pick a currency and enter the amount (for example €9.99 for EUR), then click Add.

The currency now appears in the Currency overrides table, where you can edit or remove it.

4

Save the product

Save with Add product. Localized prices apply to future checkouts immediately.

Run a test checkout with a billing country that has a rule, and confirm the localized amount appears.

​

Manage via API

​

Set the pricing mode

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

​

Add a localized price

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

​

List, update, and archive

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

​

How It Applies at Checkout

• By Country: looks for a rule matching the billing country. If one exists, the customer is charged the rule’s amount in the rule’s currency.
• By Currency: looks for a rule matching the customer’s currency (the billing_currency, or the currency derived from their country). If one exists, the customer is charged the rule’s amount in that currency.
• No match, or no pricing_mode: the base price applies, charged directly when the customer’s currency equals the base currency, otherwise converted through Adaptive Currency.

​

Important Behaviors

​

Best Practices

• Keep a sensible base price. It is the fallback for every market without a rule, converted through Adaptive Currency.
• Round to local charm prices. The whole point of a fixed amount is a clean number like ₹999, €9.99, or ¥1000, not an FX result.
• Pick the mode for the job. Use by_country for purchasing-power pricing; use by_currency when one price per currency zone is enough.
• Archive, don’t recreate, for promotions. Archiving a rule reverts the market to base/adaptive while preserving history; recreate or re-price later as needed.
• Mind the tax line before advertising a total. For tax-exclusive products the customer pays the localized amount plus tax, so don’t quote it as the final price in ads.

​

Related