현지화된 가격이란?
모든 제품은 기본 통화의 기본 가격을 가지고 있습니다. 현지화된 가격은 통화별 또는 국가별로 설정한 고정 가격으로 기본값을 무시할 수 있도록 합니다. 제품에pricing_mode를 설정하여 활성화한 다음, 시장별로 하나의 규칙을 연결하세요.
국제 가격 책정을 위한 여러 독립적인 수단 중 하나이며, 각 수단은 서로 다른 문제를 해결합니다:
현지화된 가격과 적응형 통화는 함께 작동합니다. 현지화된 규칙이 없으면 제품은 기본 가격으로 돌아갑니다 — 고객이 이미 기본 통화에 있는 경우 직접 부과되며, 그렇지 않으면 적응형 통화를 통해 변환됩니다.
사용 사례
Exact Prices for One Market
가격에 민감한 시장에 특정 금액을 청구합니다.
by_country 규칙을 사용하면 $20 기본 상품을 인도에서 ₹999에 판매할 수 있습니다. 이는 FX 변환 금액이 아니라 사용자가 선택한 정확한 숫자입니다. 대신 국가별로 가격을 자동 인하하려면 Purchasing Power Parity를 사용하세요.Exact Prices per Currency Zone
$19.99를 실시간 FX로 변환하면 €18.43처럼 어색한 숫자가 됩니다.
by_currency 규칙은 입력한 정확한 가격인 €9.99, ¥1000, ₹499를 설정합니다. 모든 통화에서 변환된 가격을 깔끔한 끝자리로 자동 반올림하려면 Charm Pricing을 사용하세요.Reversible Market-Entry Promotions
새로운 국가에서 출시하시나요? 도입 가격으로
by_country 규칙을 추가한 다음, 프로모션이 종료되면 보관하여 기본/Adaptive 가격으로 돌아가세요. 규칙은 삭제되지 않고 보관되므로, 언제 어떤 가격이 적용되었는지에 대한 깔끔한 기록을 유지할 수 있습니다.Competitive Price-Matching
단일 시장의 가격을 현지 경쟁업체에 맞추어 고정합니다. 영국에서 £9.00으로 설정한
by_country 규칙은 GBP/USD 환율이 어떻게 변하더라도 해당 정확한 가격을 유지합니다.핵심 개념
- 가격 책정 모드 — 제품은 한 번에 정확히 하나의 모드로 설정되며,
pricing_mode에 의해 결정됩니다:by_currency: 국가와 관계없이 통화별 가격 하나를 적용합니다. EUR로 결제하는 모든 고객에게 €9.99가 표시됩니다.by_country: 여러 국가가 동일한 통화를 사용하더라도 국가별 가격을 적용합니다(인도의 경우 ₹999).
- 최소 단위의 고정 금액 — 규칙의
amount은 통화의 최소 단위로 표시되는 정수이며, API의 다른 모든 곳과 동일합니다.99900은 ₹999.00이고,999은 €9.99입니다. 이는 직접 설정한 가격이며, 변환된 값이 아닙니다. - 일치하는 규칙이 자동 가격 책정보다 우선합니다 — 현지화된 규칙이 항목에 적용되면 해당 항목에서는 Purchasing Power Parity와 Charm Pricing이 모두 건너뛰어집니다. 결제 시 고객은 설정한 금액을 변경 없이 지불합니다. 구독 요금제가 변경될 때 구독과 다른 통화의 규칙은 변환됩니다. 자세한 내용은 구독 요금제 변경 시 적용 방식을 참조하세요.
- 일치하는 규칙이 없는 경우 — 제품은 기존 방식으로 동작합니다. 기본 통화를 사용하는 고객은 기본 가격을 직접 지불하고, 그 외의 고객에게는 Adaptive Currency를 통해 가격이 변환됩니다.
- 규칙이 일치하면 수수료가 포함됩니다 — 고객은 설정한 금액과 정확히 동일한 금액을 지불합니다. Adaptive Currency의 FX 수수료는 거래에 포함된 수수료로 처리되어 판매자가 부담하며, 추가로 부과되지 않습니다. 따라서 명시한 현지 가격이 항상 실제 청구 금액이 됩니다.
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를 클릭합니다. 추가한 각 시장은 overrides 테이블에 표시되며, 나중에 편집하거나 삭제할 수 있습니다.
- By Country
- By Currency
국가를 선택하고 통화를 선택한 후 금액(예: 인도의 경우 ₹999)을 입력하고 Add를 클릭합니다.
이제 국가가 Country overrides 테이블에 표시되며, 여기에서 편집하거나 삭제할 수 있습니다.


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만 업데이트할 수 있으며, 생성 후에는 통화와 국가를 변경할 수 없습니다. 보관은 멱등적인 soft-delete이므로 규칙은 더 이상 일치하지 않지만 기록에는 남습니다.
API Reference
전체 Product Localized Prices endpoints에서 create, list, retrieve, update 및 archive 작업을 확인하세요.
결제 시 적용 방식
현지화된 가격은 장바구니의 각 항목별로 확인되며,pricing_mode이 설정된 제품에만 적용됩니다. Dodo Payments는 요청에서 고객의 billing country와 선택 사항인 **billing_currency**이라는 두 가지 신호를 읽습니다(생략하면 결제 국가에서 통화를 계산합니다).
- By Country: 결제 국가와 일치하는 규칙을 찾습니다. 규칙이 있으면 고객에게 규칙의 통화로 규칙의 금액을 청구합니다.
- By Currency: 고객의 통화와 일치하는 규칙을 찾습니다(
billing_currency또는 국가에서 계산된 통화). 규칙이 있으면 고객에게 해당 통화로 규칙의 금액을 청구합니다. - 일치 항목이 없거나
pricing_mode이 없는 경우: 기본 가격이 적용됩니다. 고객의 통화가 기본 통화와 같으면 직접 청구하고, 그렇지 않으면 Adaptive Currency를 통해 변환합니다.
구독 요금제 변경 시 적용 방식
현지화된 가격은 구독자가 요금제를 변경할 때도 따라갑니다. 기존 구독이 요금제를 변경하여pricing_mode이 설정된 제품으로 이동하면, 구독에 이미 고정된 결제 국가와 통화를 사용하여 결제와 동일한 규칙으로 새 요금제 가격을 확인합니다:
- By Country: 구독의 결제 국가와 일치하는 규칙이 적용됩니다. 규칙의 통화가 구독 결제 통화와 다르면 규칙의 금액이 실시간 FX 환율로 변환됩니다. 규칙은 건너뛰지 않고 적용됩니다.
- By Currency: 고객의 결제 통화와 일치하는 규칙이 적용되며, 고객에게 규칙의 금액과 정확히 동일한 금액을 청구합니다.
- 일치 항목이 없거나
pricing_mode이 없는 경우: 새 요금제의 기본 가격이 적용되며, 필요한 경우 Adaptive Currency를 통해 변환됩니다. 이는 결제와 동일한 대체 방식입니다.
- 미리보기는 정확합니다. Preview Change Plan은 실제 변경 시 청구되는 것과 동일한 현지화된 금액을 반환합니다.
- 갱신 시에도 현지화된 가격이 유지됩니다. 변경 후 새 요금제는 해당 가격으로 생성된 구독과 동일하게 현지화된 금액으로 갱신되며, 수수료 포함 상태도 유지됩니다.
- 일할 계산에는 실제 금액이 사용됩니다. 업그레이드 시 사용하지 않은 기간에 대한 크레딧은 고객이 기존 요금제에 실제로 지불한 금액을 기준으로 계산하고, 새 요금제에는 현지화된 규칙에 따른 가격을 적용합니다.
- 예약된 변경은 예약 시점에 가격을 고정합니다. 청구 기간 종료 시점으로 예약된 변경은 그 사이에 규칙을 편집하더라도 예약 시 계산된 금액을 청구합니다.
- 결제 통화는 변경되지 않습니다. 요금제 변경으로 구독이 결제되는 통화가 바뀌지는 않습니다. 다른 통화의 규칙은 FX를 통해 해당 통화로 변환됩니다.
- 추가 기능은 현지화되지 않습니다. 새 요금제의 추가 기능 가격에는 항상 기본 가격이 사용됩니다.
주요 동작
현지화된 규칙 변경은 자체 webhook을 생성하지 않습니다. 확인된 금액은 다른 모든 가격과 동일하게 결과 결제 또는 구독에 표시됩니다.
모범 사례
- 합리적인 기본 가격을 유지하세요. 기본 가격은 규칙이 없는 모든 시장에 대한 대체 가격이며, Adaptive Currency를 통해 변환됩니다.
- 깔끔한 금액을 입력하세요. 고정 금액의 핵심은 FX 결과가 아니라 ₹999, €9.99 또는 ¥1000처럼 정돈된 가격을 설정하는 것입니다. 모든 통화에 자동으로 반올림을 적용하려면 Charm Pricing을 참조하세요.
- 목적에 맞는 모드를 선택하세요. 구매력 기반 가격에는
by_country을 사용하고, 통화 영역별 가격 하나로 충분한 경우에는by_currency을 사용하세요. - 프로모션에는 새로 생성하지 말고 보관하세요. 규칙을 보관하면 기록을 유지하면서 시장을 기본 가격/Adaptive Currency로 되돌릴 수 있습니다. 필요에 따라 나중에 다시 생성하거나 가격을 조정하세요.
- 총액을 광고하기 전에 세금 항목을 확인하세요. 세금 별도 제품의 경우 고객은 현지화된 금액에 세금이 더해진 금액을 지불하므로, 광고에서 이를 최종 가격으로 안내하지 마세요.
관련 항목
Purchasing Power Parity
국가별로 하나의 비율을 적용하여 가격을 자동으로 낮춥니다.
Charm Pricing
모든 통화에서 변환된 가격을 49.99와 같은 깔끔한 끝자리로 반올림합니다.
Adaptive Currency
현지화된 가격 책정의 기반이 되는 자동 FX 변환 및 수수료 처리를 제공합니다.
Tax-Inclusive Pricing
가격에 세금을 포함할지 여부를 제어합니다.
Pay What You Want
고객이 금액을 선택하도록 합니다. 여기에는 현지화된 규칙이 적용되지 않습니다.

