Skip to main content

ローカライズ価格とは?

すべての製品には、基準通貨で設定された基準価格があります。ローカライズ価格を使用すると、その基準価格を通貨ごと、または国ごとに設定した固定価格で上書きできます。製品で pricing_mode を設定して有効にし、市場ごとに1つのルールを追加します。 国際価格設定のための独立した手段はいくつかあり、それぞれ異なる課題を解決します。
ローカライズ価格と Adaptive Currency は連携して動作します。ローカライズルールに一致しない場合、製品は基準価格にフォールバックします。顧客がすでに基準通貨を使用している場合は基準価格を直接請求し、それ以外の場合は Adaptive Currency を通じて変換します。

ユースケース

Exact Prices for One Market

価格に敏感な市場で、特定の金額を請求します。by_country ルールを使えば、$20 の基本商品を インドで ₹999 で販売できます。これは為替換算額ではなく、選択した金額そのものです。国ごとに価格を自動的に引き下げるには、購買力平価を使用してください。

Exact Prices per Currency Zone

$19.99 を現在の為替レートで換算すると、€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 を表します。これは設定した価格であり、換算された値ではありません。
  • 一致するルールが自動価格設定より優先される — ローカライズされたルールが明細に適用される場合、その明細では Purchasing Power Parity と Charm Pricing の両方がスキップされます。チェックアウトでは、顧客は設定した金額を変更なく支払います。サブスクリプションプランの変更時に、ルールの通貨がサブスクリプションの通貨と異なる場合は換算されます。詳しくは サブスクリプションプランの変更時の適用方法 を参照してください。
  • 一致するルールがない場合 — 商品は従来の動作を維持します。基準通貨の顧客は基準価格をそのまま支払い、それ以外の顧客には Adaptive Currency を通じて換算された価格が適用されます。
  • ルールが一致する場合、手数料は内包される — 顧客は設定した金額そのものを支払います。Adaptive Currency の為替手数料は、上乗せされるのではなく、あなたが負担します(その取引では手数料込みとして扱われます)。そのため、提示した現地価格が常に請求額になります。

ダッシュボードで設定する

1

Open the product form

Merchant Dashboard で Products に移動し、商品を作成します(または既存の商品を開いて編集します)。通常どおり、基準 Price と通貨を設定します。
2

Enable Localized Pricing and choose a mode

Pricing セクションで Localized Pricing にチェックを入れ、By Country または By Currency を選択します。
Localized Pricing enabled on the product form with By Country selected
3

Add a price for each market

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

Save the product

Add product で保存します。ローカライズされた価格は、以降のチェックアウトにすぐ適用されます。
ルールが設定されている請求先の国を使用してテストチェックアウトを実行し、ローカライズされた金額が表示されることを確認します。

API で管理する

Localized Pricing は 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 はリクエストから2つの情報を読み取ります。顧客の billing country と、任意の billing_currency です(省略した場合、請求先の国から通貨が導出されます)。
  • By Country: 請求先の国に一致するルールを探します。一致するルールがある場合、顧客にはそのルールの通貨で金額が請求されます。
  • By Currency: 顧客の通貨(billing_currency、または国から導出された通貨)に一致するルールを探します。一致するルールがある場合、その通貨でルールの金額が請求されます。
  • 一致するルールがない場合、または pricing_mode がない場合: 基準価格が適用されます。顧客の通貨が基準通貨と一致する場合はそのまま請求され、それ以外の場合は Adaptive Currency を通じて換算されます。
カートの各明細は個別に解決されるため、同じチェックアウト内で1つの商品だけをローカライズし、他の商品には基準価格を適用できます。いずれかの明細にローカライズされたルールが一致すると、取引全体が手数料込みになります(基本概念 を参照)。

サブスクリプションプランの変更時の適用方法

加入者がプランを切り替えると、Localized Pricing も引き継がれます。既存のサブスクリプションが プランを変更 して pricing_mode が設定された商品になる場合、新しいプランの価格は、サブスクリプションに固定されている請求先の国と通貨を使用し、チェックアウトと同じルールで解決されます。
  • By Country: サブスクリプションの請求先の国に一致するルールが適用されます。ルールの通貨がサブスクリプションの請求通貨と異なる場合、ルールの金額は現在の為替レートで換算されます。ルールはスキップされず、適用されます。
  • By Currency: 顧客の請求通貨に一致するルールが適用され、顧客にはルールの金額がそのまま請求されます。
  • 一致するルールがない場合、または pricing_mode がない場合: 新しいプランの基準価格が適用され、必要に応じて Adaptive Currency を通じて換算されます。これはチェックアウトと同じフォールバック動作です。
これは、プラン変更が発生するすべてのケースに当てはまります。Change Plan API、Customer Portal のセルフサービスによるプラン変更、請求期間終了時に予定された変更が対象です。
  • プレビューは正確です。 Preview Change Plan は、実際の変更で請求されるものと同じローカライズされた金額を返します。
  • 更新ではローカライズされた価格が維持されます。 変更後、新しいプランはそのローカライズされた金額で更新され、同じ価格で作成されたサブスクリプションと同様に手数料込みの状態が維持されます。
  • 日割り計算には実際の金額が使用されます。 アップグレード時、未使用期間のクレジットは顧客が旧プランに実際に支払った金額に基づき、新しいプランにはローカライズされたルールによる価格が適用されます。
  • 予定された変更では、予定時点で価格が固定されます。 請求期間の終了時に予定された変更では、途中でルールを編集しても、予定時点で計算された金額が請求されます。
  • 請求通貨は変わりません。 プラン変更によって、サブスクリプションの決済通貨が切り替わることはありません。別の通貨のルールは為替換算されます。
  • アドオンはローカライズされません。 新しいプランのアドオン価格には常に基準価格が使用されます。

重要な動作

ローカライズされたルールの変更によって、専用の webhook が発行されることはありません。解決された金額は、他の価格と同様に、結果として作成される支払いまたはサブスクリプションに表示されます。

ベストプラクティス

  • 妥当な基準価格を設定する。 ルールがないすべての市場では、Adaptive Currency を通じて換算された基準価格がフォールバックとして使用されます。
  • 端数の整った金額を入力する。 固定額の目的は、為替換算結果ではなく、₹999、€9.99、¥1000 のように端数の整った価格を設定することです。すべての通貨で自動的に丸めるには、Charm Pricing を参照してください。
  • 目的に合ったモードを選ぶ。 購買力に応じた価格設定には by_country を使用し、通貨圏ごとに1つの価格で十分な場合は by_currency を使用します。
  • プロモーションでは再作成せず、アーカイブする。 ルールをアーカイブすると、市場は履歴を保持したまま基準価格または Adaptive Currency に戻ります。必要に応じて後から再作成または再価格設定できます。
  • 合計額を宣伝する前に税額を確認する。 税別の商品では、顧客はローカライズされた金額に加えて税金を支払います。そのため、広告で最終価格として提示しないでください。

関連項目

Purchasing Power Parity

国ごとに1つの割合を設定し、価格を自動的に引き下げます。

Charm Pricing

すべての通貨で、換算後の価格を49.99のような端数の整った金額に丸めます。

Adaptive Currency

自動為替換算と、Localized Pricing の基盤となる手数料処理を提供します。

Tax-Inclusive Pricing

価格に税金を含めるかどうかを制御します。

Pay What You Want

顧客が金額を選択できるようにします。ここではローカライズされたルールは適用されません。
最終更新日 2026年9月26日