현지화된 가격이란?
모든 제품은 기본 통화의 기본 가격을 가지고 있습니다. 현지화된 가격은 통화별 또는 국가별로 설정한 고정 가격으로 기본값을 무시할 수 있도록 합니다. 제품에pricing_mode를 설정하여 활성화한 다음, 시장별로 하나의 규칙을 연결하세요.
이는 각각 다른 문제를 해결하는 세 가지 독립적인 국제 가격 조정 레버 중 하나입니다:
현지화된 가격과 적응형 통화는 함께 작동합니다. 현지화된 규칙이 없으면 제품은 기본 가격으로 돌아갑니다 — 고객이 이미 기본 통화에 있는 경우 직접 부과되며, 그렇지 않으면 적응형 통화를 통해 변환됩니다.
사용 사례
Purchasing Power Parity (PPP)
민감한 가격 시장에서 본국 시장의 할인을 하지 않고 적게 청구하세요.
by_country 규칙은 $20 기본 제품을 인도의 ₹999에 판매할 수 있게 하며, 이는 단순 환율 변환이 아니라 현지 구매력에 맞춘 것입니다. PPP를 실행하는 추천하는, 본격적인 방법입니다.Charm Pricing
$19.99의 실시간 환율 변환은 €18.43처럼 어색한 숫자에 도달합니다.
by_currency 규칙은 소비자가 기대하는 깔끔하고 심리적으로 조율된 가격을 설정합니다 — €9.99, ¥1000, ₹499 — 타이핑 그대로입니다.Reversible Market-Entry Promotions
새로운 국가에 출시하나요?
by_country 규칙을 도입 가격과 함께 추가한 다음, 프로모션이 끝나면 기록 보관하여 기본/적응형 가격으로 돌아갑니다. 규칙은 삭제되지 않고 기록 보관되므로, 어떤 것이 언제 실시간으로 있었는지에 대한 깨끗한 기록을 유지합니다.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입니다. 이는 변환된 값이 아니라 설정한 가격입니다. - 규칙이 일치하지 않을 때 — 제품은 기존 동작을 유지합니다: 기본 통화에 있는 고객은 기본 가격을 직접 지불하고, 다른 모든 사람은 적응형 통화를 통해 변환됩니다.
- 규칙이 일치할 때 요금 포함 — 고객은 설정한 금액을 정확하게 지불합니다. 적응형 통화 FX 요금은 추가되는 것이 아니라 트랜잭션에 대해 요금을 포함하는 방식으로 처리되므로, 명시된 현지 가격이 항상 청구되는 가격이 됩니다.
대시보드에서 설정하기
1
Open the product form
Merchant Dashboard에서 제품으로 가서 제품을 생성하거나 (기존 제품을 열어 편집하세요). 기본 가격과 통화를 평소처럼 설정하세요.
2
Enable Localized Pricing and choose a mode
가격 섹션에서 현지화된 가격을 선택하고, 국가별 또는 통화별을 선택하세요.

3
Add a price for each market
국가 가격 추가 또는 통화 가격 추가를 클릭하고, 현지화된 가격 패널을 작성한 후 추가를 클릭하세요. 추가된 각 시장은 나중에 편집하거나 제거할 수 있는 변경 테이블에 나타납니다.
- By Country
- By Currency
국가를 선택하고, 통화를 선택한 다음 금액을 입력하세요 (예를 들어 인도는 ₹999). 그런 다음 추가를 클릭하세요.
국가가 이제 국가 덮어쓰기 테이블에 나타나며, 여기서 편집하거나 제거할 수 있습니다.


4
Save the 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
전체 제품 현지화된 가격 엔드포인트: 생성, 목록, 검색, 업데이트 및 기록 보관을 참조하세요.
결제 시 적용 방법
현지화된 가격은 각 장바구니 라인별로 해석되며,pricing_mode가 설정된 제품에만 적용됩니다. Dodo Payments는 요청에서 고객의 청구 국가와 선택적 billing_currency(생략 시, 국가에서 파생된 통화)를 읽습니다.
- 국가별: 청구 국가와 일치하는 규칙을 찾습니다. 존재하면 고객에게 규칙의 통화로 규칙의 금액을 청구합니다.
- 통화별: 고객의 통화(
billing_currency, 또는 국가에서 파생된 통화)와 일치하는 규칙을 찾습니다. 존재하면 고객에게 해당 통화로 규칙의 금액을 청구합니다. - 일치하지 않거나
pricing_mode가 없는 경우: 기본 가격이 적용됩니다. 고객의 통화가 기본 통화와 같으면 직접 청구하고, 그렇지 않으면 적응형 통화를 통해 변환됩니다.
구독 플랜 변경 시 적용 방식
Localized pricing은 구독자가 플랜을 변경할 때 함께 적용됩니다. 기존 구독이 플랜을 변경하여pricing_mode이 있는 product로 전환되면, 새 플랜의 가격은 checkout과 동일한 규칙으로 결정되며 구독에 이미 고정된 결제 국가와 통화를 사용합니다:
- 국가별: 구독의 결제 국가와 일치하는 rule이 적용됩니다. rule의 통화가 구독에 청구되는 통화와 다르면 rule의 금액이 실시간 FX 환율로 변환됩니다 — rule이 적용되며 건너뛰지 않습니다.
- 통화별: 고객에게 청구되는 통화와 일치하는 rule이 적용되며, 고객에게는 rule의 금액이 정확히 청구됩니다.
- 일치하는 항목이 없거나
pricing_mode이 없는 경우: 새 플랜의 base price가 적용되며, 필요한 경우 Adaptive Currency를 통해 변환됩니다 — checkout과 동일한 fallback입니다.
- Preview는 정확합니다. Preview Change Plan은 실제 변경 시 청구되는 것과 동일한 localized amount를 반환합니다.
- Renewal에는 localized price가 유지됩니다. 변경 후 새 플랜은 localized amount로 renewal되며, localized amount로 생성된 구독과 동일하게 fees-inclusive 상태가 유지됩니다.
- Proration은 실제 금액을 사용합니다. Upgrade 시 사용하지 않은 기간에 대한 credit은 고객이 기존 플랜에 실제로 지불한 금액을 기준으로 하며, 새 플랜의 가격은 localized rule에 따라 책정됩니다.
- 예약된 변경은 예약 시점에 가격이 고정됩니다. billing period 종료 시점으로 예약된 변경은 이후 rule을 수정하더라도 예약 시점에 계산된 금액을 청구합니다.
- 결제 통화는 변경되지 않습니다. 플랜 변경으로 구독이 정산되는 통화가 바뀌지는 않습니다. 다른 통화로 설정된 rule은 FX를 통해 해당 통화로 변환됩니다.
- Add-on은 localized pricing이 적용되지 않습니다. 새 플랜의 Add-on 가격에는 항상 base pricing이 사용됩니다.
주요 동작
Localized rule 변경은 자체 webhook을 생성하지 않습니다. 결정된 금액은 다른 모든 가격과 동일하게 결과 payment 또는 subscription에 표시됩니다.
모범 사례
- 합리적인 base price를 유지하세요. rule이 없는 모든 시장에서 Adaptive Currency를 통해 변환되어 fallback으로 사용됩니다.
- 현지에서 선호되는 깔끔한 가격으로 반올림하세요. 고정 금액의 핵심은 FX 결과가 아니라 ₹999, €9.99 또는 ¥1000과 같은 깔끔한 숫자입니다.
- 목적에 맞는 mode를 선택하세요. 구매력 기반 가격 책정에는
by_country를 사용하고, 통화 zone별로 하나의 가격이면 충분한 경우에는by_currency를 사용하세요. - 프로모션에는 재생성하지 말고 archive하세요. rule을 archive하면 history를 유지하면서 해당 시장이 base/adaptive로 되돌아갑니다. 필요할 때 나중에 재생성하거나 가격을 다시 설정할 수 있습니다.
- 총액을 광고하기 전에 세금 항목을 확인하세요. tax-exclusive product의 경우 고객은 localized amount에 세금을 더한 금액을 지불하므로, 광고에서 이를 최종 가격으로 표시하지 마세요.
관련 문서
Purchasing Power Parity
PPP를 위한 기본 제공 localized pricing과 위치 기반 discount code 비교.
Adaptive Currency
Localized pricing의 기반이 되는 자동 FX 변환 및 fee 처리.
Tax-Inclusive Pricing
가격에 세금을 포함할지 제어합니다.
Pay What You Want
고객이 금액을 선택하도록 합니다. 여기에는 localized rule이 적용되지 않습니다.

