현지화된 가격이란?
모든 제품은 기본 통화의 기본 가격을 가지고 있습니다. 현지화된 가격은 통화별 또는 국가별로 설정한 고정 가격으로 기본값을 무시할 수 있도록 합니다. 제품에pricing_mode를 설정하여 활성화한 다음, 시장별로 하나의 규칙을 연결하세요.
국제 가격 책정을 위한 여러 독립적인 수단 중 하나이며, 각 수단은 서로 다른 문제를 해결합니다:
현지화된 가격과 적응형 통화는 함께 작동합니다. 현지화된 규칙이 없으면 제품은 기본 가격으로 돌아갑니다 — 고객이 이미 기본 통화에 있는 경우 직접 부과되며, 그렇지 않으면 적응형 통화를 통해 변환됩니다.
사용 사례
Exact Prices for One Market
Exact Prices per Currency Zone
Reversible Market-Entry Promotions
Competitive Price-Matching
핵심 개념
- 가격 책정 모드 — 제품은 한 번에 정확히 하나의 모드로 설정되며,
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
결제 시 적용 방식
현지화된 가격은 장바구니의 각 항목별로 확인되며,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로 되돌릴 수 있습니다. 필요에 따라 나중에 다시 생성하거나 가격을 조정하세요.
- 총액을 광고하기 전에 세금 항목을 확인하세요. 세금 별도 제품의 경우 고객은 현지화된 금액에 세금이 더해진 금액을 지불하므로, 광고에서 이를 최종 가격으로 안내하지 마세요.

