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 を表します。これは設定した価格であり、換算された値ではありません。
  • 一致するルールが自動価格設定より優先される — ローカライズルールが明細に適用される場合、購買力平価端数価格設定はその明細に対してスキップされます。顧客は、設定した金額をそのまま支払います。
  • 一致するルールがない場合 — 商品は従来の動作を維持します。基本通貨を使用する顧客は基本価格をそのまま支払い、それ以外の顧客には Adaptive Currency を通じて換算された価格が適用されます。
  • ルールが一致する場合、手数料は価格に含まれる — 顧客が支払うのは、設定した金額そのものです。Adaptive Currency の為替手数料は顧客に追加請求されず、販売者が負担します(その取引では手数料込みとして扱われます)。そのため、提示した現地価格が常に請求額になります。

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 を選択します。
製品フォームでLocalized Pricingを有効にし、By Countryを選択した状態
3

Add a price for each market

Add Country Price または Add Currency Price をクリックし、Localized pricing パネルに入力して Add をクリックします。追加した各市場はオーバーライドテーブルに表示され、後から編集または削除できます。
国を選択し、通貨を選んで金額(例:インドの場合は₹999)を入力し、Add をクリックします。
インドに999 INRのオーバーライドを追加
国が Country overrides テーブルに表示されます。ここで編集または削除できます。
インドに999 INRが設定された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 を通じて変換します。
カートの各明細行は個別に解決されるため、同じチェックアウト内で1つの製品だけをローカライズし、他の製品には基準価格を適用できます。いずれかの明細行がローカライズルールに一致すると、取引全体が手数料込みになります(基本概念を参照)。

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

ローカライズされた価格は、購読者がプランを変更した際にも引き継がれます。既存のサブスクリプションがプランを変更して、pricing_modeを持つ商品に移行する場合、新しいプランの価格はチェックアウトと同じルールで解決されます。適用されるのは、サブスクリプションに設定済みの請求先国と通貨です。
  • 国別: サブスクリプションの請求先国に一致するルールが適用されます。ルールの通貨がサブスクリプションの請求通貨と異なる場合、ルールの金額はリアルタイムのFXレートで換算されます。ルールは適用され、スキップされることはありません。
  • 通貨別: 顧客の請求通貨に一致するルールが適用され、顧客にはルールの金額がそのまま請求されます。
  • 一致するルールがない場合、またはpricing_modeがない場合: 新しいプランの基本価格が適用され、必要に応じてAdaptive Currencyを通じて換算されます。チェックアウトと同じフォールバックです。
これは、プラン変更の起点となり得るすべての場所で適用されます。Change Plan APICustomer Portalでのセルフサービスによるプラン変更、請求期間の終了時に予定された変更が対象です。
  • プレビューは正確です。 Preview Change Planは、実際の変更時に請求されるものと同じローカライズ済み金額を返します。
  • 更新時もローカライズされた価格が維持されます。 変更後、新しいプランはローカライズ済みの金額で更新され、その金額に手数料が含まれる状態も維持されます。これは、その価格で作成されたサブスクリプションと同じです。
  • 日割り計算には実際の金額が使用されます。 アップグレード時、未使用期間に対するクレジットは顧客が以前のプランに実際に支払った金額に基づきます。一方、新しいプランの価格はローカライズされたルールによって決まります。
  • 予定された変更では、予定時点で価格が確定します。 請求期間の終了時に予定された変更では、その間にルールを編集した場合でも、予定時点で計算された金額が請求されます。
  • 請求通貨は変わりません。 プラン変更によって、サブスクリプションの決済通貨が切り替わることはありません。別の通貨のルールは、FX換算によってサブスクリプションの通貨に変換されます。
  • アドオンはローカライズされません。 新しいプランのアドオン価格には、常に基本価格が使用されます。

重要な動作

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

ベストプラクティス

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

関連情報

Purchasing Power Parity

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

Charm Pricing

すべての通貨で、換算価格を49.99などのきりのよい末尾に丸めます。

Adaptive Currency

ローカライズ価格の基盤となる自動為替換算と手数料処理を提供します。

Tax-Inclusive Pricing

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

Pay What You Want

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