ローカライズ価格とは?
すべての製品には、基準通貨で設定された基準価格があります。ローカライズ価格を使用すると、その基準価格を通貨ごと、または国ごとに設定した固定価格で上書きできます。製品でpricing_mode を設定して有効にし、市場ごとに1つのルールを追加します。
国際価格設定のための、独立した3つの手段のうちの1つです。それぞれ異なる課題を解決します。
ローカライズ価格と Adaptive Currency は連携して動作します。ローカライズルールに一致しない場合、製品は基準価格にフォールバックします。顧客がすでに基準通貨を使用している場合は基準価格を直接請求し、それ以外の場合は Adaptive Currency を通じて変換します。
ユースケース
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 ルールに導入価格を設定し、プロモーション終了後にアーカイブすると、基準価格またはAdaptive Currencyによる価格にフォールバックできます。ルールは削除されずにアーカイブされるため、いつどの価格が有効だったかを記録として保持できます。Competitive Price-Matching
現地の競合他社に合わせるため、特定の市場に価格を固定できます。英国で £9.00とする
by_country ルールを設定すれば、GBP/USDレートが変動してもその価格を維持できます。基本概念
- 価格設定モード — 製品は常に1つのモードのみを使用します。モードは
pricing_modeで設定します。by_currency:国に関係なく、通貨ごとに1つの価格を設定します。EURで支払うすべての顧客に€9.99が表示されます。by_country:通貨を共有する国が複数ある場合でも、国ごとに固有の価格(インドでは₹999)を設定します。
- 最小単位で指定する固定金額 — ルールの
amountは、APIの他の場所と同様、通貨の最小単位を表す整数です。99900は₹999.00、999は€9.99を意味します。設定した価格がそのまま適用され、変換された値ではありません。 - 一致するルールがない場合 — 製品は既存の動作を維持します。基準通貨の顧客には基準価格を直接請求し、それ以外の顧客には Adaptive Currency を通じて変換した価格を請求します。
- ルールが一致した場合、手数料は価格に含まれます — 顧客が支払う金額は、設定した金額と完全に同じです。 Adaptive Currency のFX手数料はDodoが負担し、その取引では手数料込みとして扱われるため、設定した現地価格が常に請求額になります。
Dashboardで設定する
1
Open the product form
Merchant Dashboardで Products に移動し、製品を作成します(または既存の製品を開いて編集します)。通常どおり、基準 Price と通貨を設定します。
2
Enable Localized Pricing and choose a mode
Pricing セクションで Localized Pricing にチェックを入れ、By Country または By Currency を選択します。

3
Add a price for each market
Add Country Price または Add Currency Price をクリックし、Localized pricing パネルに入力して Add をクリックします。追加した各市場はオーバーライドテーブルに表示され、後から編集または削除できます。
- By Country
- By Currency
国を選択し、通貨を選んで金額(例:インドの場合は₹999)を入力し、Add をクリックします。
国が Country overrides テーブルに表示されます。ここで編集または削除できます。


4
Save the product
Add product で保存します。ローカライズ価格は、以降のチェックアウトにすぐ適用されます。
ルールが設定された請求先国でテストチェックアウトを実行し、ローカライズされた金額が表示されることを確認します。
APIで管理する
ローカライズ価格はAPIで完全に利用できます。まず製品の価格設定モードを設定し、その後ルールを追加します。価格設定モードを設定する
製品を作成するとき(または既存の製品を更新するとき)にpricing_mode を設定します。null は基準価格のみを意味し、既存の動作と同じです。
ローカライズ価格を追加する
製品にルールを追加します。by_country モードでは country_code が必須です。by_currency モードでは省略する必要があります。
by_currency 製品では country_code を省略します。たとえば、EURで支払うすべての顧客に一律の €9.99 を設定できます(currency: 'EUR'、amount: 999)。
一覧表示、更新、アーカイブ
更新できるのはルールのamount のみです。通貨と国は作成後に変更できません。アーカイブは冪等なソフト削除であり、ルールは一致対象から外れますが、履歴には残ります。
API Reference
Product Localized Pricesの全エンドポイント(作成、一覧表示、取得、更新、アーカイブ)を確認してください。
チェックアウトでの適用方法
ローカライズ価格はカート内の各明細行ごとに解決され、pricing_mode が設定された製品にのみ適用されます。Dodo Payments はリクエストから、顧客の請求先国と、任意の billing_currency の2つの情報を読み取ります(省略した場合、請求先国から通貨が導出されます)。
- By Country:請求先国に一致するルールを検索します。一致するルールがある場合、ルールの通貨で設定金額を顧客に請求します。
- By Currency:顧客の通貨(
billing_currency、または国から導出された通貨)に一致するルールを検索します。一致するルールがある場合、その通貨でルールの設定金額を顧客に請求します。 - 一致するルールがない場合、または
pricing_modeがない場合:基準価格が適用されます。顧客の通貨が基準通貨と同じ場合は直接請求し、それ以外の場合は Adaptive Currency を通じて変換します。
サブスクリプションプラン変更時の適用方法
ローカライズされた価格は、購読者がプランを変更した際にも引き継がれます。既存のサブスクリプションがプランを変更して、pricing_modeを持つ商品に移行する場合、新しいプランの価格はチェックアウトと同じルールで解決されます。適用されるのは、サブスクリプションに設定済みの請求先国と通貨です。
- 国別: サブスクリプションの請求先国に一致するルールが適用されます。ルールの通貨がサブスクリプションの請求通貨と異なる場合、ルールの金額はリアルタイムのFXレートで換算されます。ルールは適用され、スキップされることはありません。
- 通貨別: 顧客の請求通貨に一致するルールが適用され、顧客にはルールの金額がそのまま請求されます。
- 一致するルールがない場合、または
pricing_modeがない場合: 新しいプランの基本価格が適用され、必要に応じてAdaptive Currencyを通じて換算されます。チェックアウトと同じフォールバックです。
- プレビューは正確です。 Preview Change Planは、実際の変更時に請求されるものと同じローカライズ済み金額を返します。
- 更新時もローカライズされた価格が維持されます。 変更後、新しいプランはローカライズ済みの金額で更新され、その金額に手数料が含まれる状態も維持されます。これは、その価格で作成されたサブスクリプションと同じです。
- 日割り計算には実際の金額が使用されます。 アップグレード時、未使用期間に対するクレジットは顧客が以前のプランに実際に支払った金額に基づきます。一方、新しいプランの価格はローカライズされたルールによって決まります。
- 予定された変更では、予定時点で価格が確定します。 請求期間の終了時に予定された変更では、その間にルールを編集した場合でも、予定時点で計算された金額が請求されます。
- 請求通貨は変わりません。 プラン変更によって、サブスクリプションの決済通貨が切り替わることはありません。別の通貨のルールは、FX換算によってサブスクリプションの通貨に変換されます。
- アドオンはローカライズされません。 新しいプランのアドオン価格には、常に基本価格が使用されます。
重要な動作
ローカライズされたルールの変更によって、固有のwebhookが発行されることはありません。解決された金額は、他の価格と同様に、結果として生成される支払いまたはサブスクリプションに表示されます。
ベストプラクティス
- 適切な基準価格を設定する。 ルールがないすべての市場では、Adaptive Currency を通じて変換された基準価格がフォールバックとして使用されます。
- 現地向けのチャームプライスに丸める。 固定金額の目的は、FX変換の結果ではなく、₹999、€9.99、¥1000のようなわかりやすい価格にすることです。
- 目的に合ったモードを選ぶ。 購買力に基づく価格設定には
by_countryを使用し、通貨圏ごとに1つの価格で十分な場合はby_currencyを使用します。 - プロモーションでは再作成せずアーカイブする。 ルールをアーカイブすると、市場は履歴を保持したまま基準価格またはAdaptive Currencyに戻ります。必要に応じて後から再作成または再価格設定できます。
- 合計額を広告する前に税額を確認する。 税抜き製品では、顧客はローカライズ金額に加えて税を支払います。広告で最終価格として表示しないでください。
関連情報
Purchasing Power Parity
PPP向けの、ネイティブなローカライズ価格とロケーションベースの割引コードの比較。
Adaptive Currency
自動FX変換と、ローカライズ価格が利用する手数料処理。
Tax-Inclusive Pricing
価格に税を含めるかどうかを設定します。
Pay What You Want
顧客が金額を選択できるようにします。ここではローカライズルールは適用されません。

