跳转到主要内容

​
什么是本地化定价？

每个产品都有一个基础货币的基础价格。本地化定价允许您通过为每种货币或国家设置的固定价格来覆盖该基础价格。通过在产品上设置 pricing_mode 来开启此功能，然后为每个市场附加一条规则。 这是用于国际定价的三个独立杠杆之一，每个都解决不同的问题：
机制作用客户看到的金额
本地化定价为每种货币或国家设置的固定价格恰好是您设置的金额
自适应货币自动按实时外汇汇率转换您的基础价格按当前汇率转换的基础价格
折扣码按比例或固定减少基础价格基础价格减去折扣
本地化定价和自适应货币共同运作。当没有匹配的本地化规则时，产品会回落到其基础价格——如果客户已经使用您的基础货币，会直接收费，否则通过自适应货币转换。

​
用例

Purchasing Power Parity (PPP)

在价格敏感市场收取更低的费用，而不对本国市场打折。一个 by_country 规则可以让一款$20的基础产品以 ₹999在印度 销售——调整到当地购买力，而不是简单的FX转换。推荐的、本地化的PPP运行方式。

Charm Pricing

$19.99的实时FX转换可能会落到一个不便的数字上，比如€18.43。一个 by_currency 规则可以将其设置为客户期望的整洁、心理价格——€9.99、¥1000、₹499——精确如您输入的那样。

Reversible Market-Entry Promotions

在一个新的国家推出？添加一个 by_country 规则，设置促销价格，然后在促销结束后归档它，以回落到基础/自适应定价。规则会被归档，而不被删除，所以您可以保留一个清晰的记录，记下何时上线以及何时结束。

Competitive Price-Matching

将单一市场的价格与本地竞争对手匹配。一个 by_country 规则可以让 英国的价格为£9.00 保持不变，而不受GBP/USD汇率变化的影响。

​
核心概念

  • 定价模式 — 一个产品在任何时候都只处于一种模式，由其pricing_mode设置：
    • by_currency：每种货币一个价格，与国家无关。所有使用欧元支付的人都看到€9.99。
    • by_country：特定于一个国家的价格（印度₹999），即使多个国家使用同一种货币。
  • 以最小单位固定金额 — 规则的amount是该货币最小单位的整数，与API其他地方相同：99900是₹999.00，999是€9.99。它是您设置的价格，而不是转换的值。
  • 当没有规则匹配时 — 产品保持其现有行为：在您的基础货币中支付基础价格的客户；其他人通过自适应货币转换。
  • 费用在规则匹配时包含在内 — 客户支付您设定的确切金额。自适应货币外汇费用由您吸收（视为费用已包含在内），而不是加在上面，因此您声明的本地价格始终是收取的价格。

​
在仪表板中设置

1

Open the product form

在您的商家仪表板中，转到 产品 并创建一个产品（或打开现有产品进行编辑）。像往常一样设置基础价格和货币。
2

Enable Localized Pricing and choose a mode

在 定价 部分勾选 本地化定价，然后选择 按国家 或 按货币。
产品表单上启用了本地化定价，选择了按国家
3

Add a price for each market

点击 添加国家价格 或 添加货币价格，填入 本地化定价 面板，然后点击 添加。您添加的每个市场都会出现在覆盖表中，您可以稍后编辑或删除它。
选择一个国家，选择货币，输入金额（例如印度的₹999），然后点击 添加。
为印度添加999 INR覆盖
该国家现在出现在 国家覆盖 表中，您可以在其中编辑或删除它。
国家覆盖表显示印度为999 INR
4

Save the product

使用 添加产品 保存。本地化价格立即适用于未来的结账。
使用具有规则的计费国家进行测试结账，并确认显示了本地化金额。

​
通过API管理

本地化定价完全可通过API使用。首先设置产品的定价模式，然后附加规则。

​
设置定价模式

设置 pricing_mode 当您创建产品（或更新现有产品）时。null 意味着仅基础的现有行为。 
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',
});

​
添加本地化价格

给产品附加一条规则。在 by_country 模式下，需要 country_code；在 by_currency 模式下则必须省略此项。 
// ₹999.00 for customers in India
const localizedPrice = await client.products.localizedPrices.create('pdt_premium_plan', {
  currency: 'INR',
  country_code: 'IN',
  amount: 99900,
});
对于 by_currency 产品，省略 country_code。例如，对所有使用EUR支付的人实行固定 €9.99 （currency: 'EUR'，amount: 999）。

​
列出、更新和存档

您只能更新规则的amount；货币和国家一旦创建就固定。存档是一个幂等软删除，因此规则停止匹配但留在您的记录中。 
// 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

查看完整的产品本地化价格端点：创建、列出、检索、更新和存档。

​
结账时如何应用

本地化定价会根据每个购物车行项目进行解析，仅适用于设置了pricing_mode 的产品。Dodo Payments从请求中读取两个信号：客户的计费国家，以及可选的**billing_currency**（如果省略，则根据计费国家推导出货币）。
  • 按国家：查找与计费国家匹配的规则。如果存在，该客户会按规则的货币收取该规则的金额。
  • 按货币：查找与客户货币匹配的规则（billing_currency，或根据其国家推导出的货币）。如果存在，该客户会按该货币收取规则的金额。
  • 无匹配或无pricing_mode：适用基础价格，当客户的货币等于基础货币时直接收费，否则通过自适应货币转换。
每个购物车项目都会单独解析，因此您可以在同一次结账中将一个产品本地化，而将其他产品保持基础定价。如果任何项目匹配本地化规则，整个交易都将强制费用包含（见核心概念）。

​
重要行为

行为详情
税前金额本地化金额是税前价格。对于不含税的产品，税将在结账时添加，因此本地化金额不是最终总额。请参阅税收包含定价。
不适用于您想支付的价款本地化规则从不适用于您想支付的价款产品，顾客决定金额。
按货币与基础货币不同by_currency 规则必须使用不同于产品基础货币的货币。
每个市场只有一个规则一个产品在每种货币（按货币计算）或每个国家（按国家计算）最多只能有一个活动规则。
所有产品类型适用于一次性、订阅和按使用量计费的产品。
本地化规则更改不会发出自己的Webhook。解析后的金额在生成的付款或订阅中显示，与其他价格完全一样。

​
最佳实践

  • 保持合理的基础价格。 它是没有规则的每个市场的回退，通过自适应货币转换。
  • 舍入为本地魅力价格。 固定金额的全部意义在于整洁的数字，例如₹999，€9.99或¥1000，而不是FX结果。
  • 为任务选择模式。 对于购买力定价使用 by_country；对于每个货币区一个价格，使用 by_currency。
  • 归档而不是重建，以进行促销。 归档规则将市场恢复为基础/自适应，同时保留历史记录；根据需要稍后可重新创建或重新定价。
  • 在广告总价前注意税额行。 对于不含税的产品，客户支付本地化金额加上税，因此在广告中不要将其作为最终价格引用。

​
相关

Purchasing Power Parity

本地化定价与基于位置的折扣码的原生对比。

Adaptive Currency

自动FX转换及其费用处理，构建在本地化定价之上。

Tax-Inclusive Pricing

控制您的价格是否包含税费。

Pay What You Want

允许顾客选择金额。本地化规则不适用于此。
最后修改于 2026年6月26日