현지화된 가격

​

현지화된 가격이란?

​

사용 사례

​

핵심 개념

• 가격 모드 — 제품은 한 번에 정확히 하나의 모드에 있으며, 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). 그런 다음 추가를 클릭하세요.

국가가 이제 국가 덮어쓰기 테이블에 나타나며, 여기서 편집하거나 제거할 수 있습니다.

통화를 선택하고 금액을 입력하세요 (예를 들어 EUR는 €9.99). 그런 다음 추가를 클릭하세요.

통화가 이제 통화 덮어쓰기 테이블에 표시되며, 여기서 편집하거나 제거할 수 있습니다.

4

Save the product

제품 추가로 저장하세요. 현지화된 가격은 이후 결제에 즉시 적용됩니다.

규칙이 있는 청구 국가로 테스트 결제를 실행하고, 현지화된 금액이 나타나는지 확인하세요.

​

API를 통한 관리

​

가격 모드 설정하기

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  environment: 'test_mode',
});

const product = await client.products.update('pdt_premium_plan', {
  pricing_mode: 'by_country',
});

​

현지화된 가격 추가

// ₹999.00 for customers in India
const localizedPrice = await client.products.localizedPrices.create('pdt_premium_plan', {
  currency: 'INR',
  country_code: 'IN',
  amount: 99900,
});

​

나열, 업데이트 및 기록 보관

// List all active rules on a product
const rules = await client.products.localizedPrices.list('pdt_premium_plan');

// Change the amount (e.g. end a promo)
await client.products.localizedPrices.update('lcp_india_price', {
  product_id: 'pdt_premium_plan',
  amount: 119900,
});

// Archive a rule
await client.products.localizedPrices.archive('lcp_india_price', {
  product_id: 'pdt_premium_plan',
});

​

결제 시 적용 방법

• 국가별: 청구 국가와 일치하는 규칙을 찾습니다. 존재하면 고객에게 규칙의 통화로 규칙의 금액을 청구합니다.
• 통화별: 고객의 통화(billing_currency, 또는 국가에서 파생된 통화)와 일치하는 규칙을 찾습니다. 존재하면 고객에게 해당 통화로 규칙의 금액을 청구합니다.
• 일치하지 않거나 pricing_mode가 없는 경우: 기본 가격이 적용됩니다. 고객의 통화가 기본 통화와 같으면 직접 청구하고, 그렇지 않으면 적응형 통화를 통해 변환됩니다.

​

주요 동작

​

모범 사례

• 합리적인 기본 가격을 유지하십시오. 규칙인 없는 모든 시장에 대한 대체 가격이며, 적응형 통화를 통해 변환됩니다.
• 현지 매력적인 가격에 맞추세요. 고정 금액의 전체 목적은 ₹999, €9.99 또는 ¥1000과 같은 깔끔한 수치를 설정하는 것입니다, 환율 결과가 아닙니다.
• 작업에 맞는 모드를 선택하세요. 구매력 가격 설정에는 by_country를 사용하세요. 통화 영역별로 하나의 가격만 필요한 경우 by_currency를 사용하세요.
• 프로모션은 기록 보관, 재생성하지 마세요. 규칙 기록 보관은 기록을 유지하면서 시장을 기본/적응형으로 복원합니다; 나중에 필요할 경우 새로 만들거나 다시 가격을 조정하세요.
• 광고하기 전에 세금 라인을 유의하세요. 세금이 제외된 제품인 경우 고객은 현지화된 금액에 세금을 추가로 지불하므로, 광고의 최종 가격으로 인용하지 마세요.

​

관련된 내용