स्थानीयकृत मूल्य निर्धारण

​

स्थानीयकृत मूल्य निर्धारण क्या है?

​

उपयोग के मामले

​

मुख्य अवधारणाएँ

• मूल्य निर्धारण मोड — कोई उत्पाद एक समय में केवल एक मोड में होता है, जिसे उसके pricing_mode द्वारा निर्धारित किया जाता है:
  • by_currency: देश की परवाह किए बिना, प्रत्येक मुद्रा के लिए एक कीमत। EUR में भुगतान करने वाले सभी लोगों को €9.99 दिखाई देता है।
  • by_country: किसी देश के लिए विशिष्ट कीमत (भारत में ₹999), भले ही कई देश एक ही मुद्रा साझा करते हों।
• सबसे छोटी इकाई में निश्चित राशियाँ — किसी नियम का amount मुद्रा की सबसे छोटी इकाई में एक integer होता है, जैसा API में हर जगह होता है: 99900 ₹999.00 है, और 999 €9.99 है। यह आपके द्वारा निर्धारित कीमत है, परिवर्तित मूल्य कभी नहीं।
• मिलान किया गया नियम स्वचालित मूल्य निर्धारण पर प्राथमिकता पाता है — जब किसी line पर स्थानीयकृत नियम लागू होता है, तो उस line के लिए Purchasing Power Parity और Charm Pricing दोनों छोड़ दिए जाते हैं। checkout पर ग्राहक आपके द्वारा निर्धारित राशि ही चुकाता है। subscription plan बदलने पर, subscription से अलग मुद्रा वाले नियम को परिवर्तित किया जाता है; subscription plan बदलावों पर यह कैसे लागू होता है देखें।
• जब कोई नियम मेल नहीं खाता — उत्पाद का मौजूदा व्यवहार बना रहता है: आपकी base currency में ग्राहक सीधे base price चुकाते हैं; अन्य सभी ग्राहकों के लिए इसे Adaptive Currency के माध्यम से परिवर्तित किया जाता है।
• नियम के मेल खाने पर fees शामिल होती हैं — ग्राहक ठीक वही राशि चुकाता है जो आपने निर्धारित की है। Adaptive Currency का FX शुल्क आप वहन करते हैं (उस transaction के लिए fees-inclusive माना जाता है), ग्राहक से अतिरिक्त रूप से नहीं लिया जाता; इसलिए आपकी बताई गई local price ही हमेशा charge की जाने वाली कीमत होती है।

​

Dashboard में सेट अप करें

1

Open the product form

अपने Merchant Dashboard में Products पर जाएँ और एक उत्पाद बनाएँ (या किसी मौजूदा उत्पाद को edit करने के लिए खोलें)। सामान्य रूप से base Price और currency सेट करें।

2

Enable Localized Pricing and choose a mode

Pricing section में Localized Pricing चुनें, फिर By Country या By Currency चुनें।

3

Add a price for each market

Add Country Price या Add Currency Price पर क्लिक करें, Localized pricing panel भरें और Add पर क्लिक करें। आपके द्वारा जोड़ा गया प्रत्येक market overrides table में दिखाई देगा, जहाँ आप बाद में उसे edit या remove कर सकते हैं।

• By Country
• By Currency

एक country चुनें, currency चुनें और राशि दर्ज करें (उदाहरण के लिए भारत के लिए ₹999), फिर Add पर क्लिक करें।

अब country Country overrides table में दिखाई देता है, जहाँ आप उसे edit या remove कर सकते हैं।

एक currency चुनें और राशि दर्ज करें (उदाहरण के लिए EUR के लिए €9.99), फिर Add पर क्लिक करें।

अब currency Currency overrides table में दिखाई देती है, जहाँ आप उसे edit या remove कर सकते हैं।

4

Save the product

Add product से save करें। Localized prices तुरंत future checkouts पर लागू हो जाती हैं।

ऐसे billing country के साथ test checkout चलाएँ, जिसके लिए कोई नियम है, और पुष्टि करें कि localized amount दिखाई दे रही है।

​

API के माध्यम से प्रबंधित करें

​

Pricing Mode सेट करें

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',
});

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),
    environment="test_mode",
)

product = client.products.update(
    "pdt_premium_plan",
    pricing_mode="by_country",
)

package main

import (
	"context"
	"os"

	"github.com/dodopayments/dodopayments-go"
	"github.com/dodopayments/dodopayments-go/option"
)

func main() {
	client := dodopayments.NewClient(
		option.WithBearerToken(os.Getenv("DODO_PAYMENTS_API_KEY")),
	)

	err := client.Products.Update(
		context.TODO(),
		"pdt_premium_plan",
		dodopayments.ProductUpdateParams{
			PricingMode: dodopayments.F(dodopayments.PricingModeByCountry),
		},
	)
	if err != nil {
		panic(err)
	}
}

​

Localized Price जोड़ें

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

# ₹999.00 for customers in India
localized_price = client.products.localized_prices.create(
    "pdt_premium_plan",
    currency="INR",
    country_code="IN",
    amount=99900,
)

// ₹999.00 for customers in India
localizedPrice, err := client.Products.LocalizedPrices.New(
	context.TODO(),
	"pdt_premium_plan",
	dodopayments.ProductLocalizedPriceNewParams{
		Currency:    dodopayments.F(dodopayments.CurrencyInr),
		CountryCode: dodopayments.F(dodopayments.CountryCodeIn),
		Amount:      dodopayments.F(int64(99900)),
	},
)

​

सूचीबद्ध करें, Update करें और Archive करें

// 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',
});

# List all active rules on a product
rules = client.products.localized_prices.list("pdt_premium_plan")

# Change the amount (e.g. end a promo)
client.products.localized_prices.update(
    "lcp_india_price",
    product_id="pdt_premium_plan",
    amount=119900,
)

# Archive a rule
client.products.localized_prices.archive(
    "lcp_india_price",
    product_id="pdt_premium_plan",
)

// List all active rules on a product
_, err := client.Products.LocalizedPrices.List(context.TODO(), "pdt_premium_plan")

// Change the amount (e.g. end a promo)
_, err = client.Products.LocalizedPrices.Update(
	context.TODO(),
	"pdt_premium_plan",
	"lcp_india_price",
	dodopayments.ProductLocalizedPriceUpdateParams{
		Amount: dodopayments.F(int64(119900)),
	},
)

// Archive a rule
err = client.Products.LocalizedPrices.Archive(
	context.TODO(),
	"pdt_premium_plan",
	"lcp_india_price",
)

​

Checkout पर यह कैसे लागू होता है

• By Country: billing country से मेल खाने वाला rule खोजता है। यदि कोई rule मिलता है, तो customer से rule की currency में उसकी amount charge की जाती है।
• By Currency: customer की currency से मेल खाने वाला rule खोजता है (billing_currency, या उनके country से प्राप्त currency)। यदि कोई rule मिलता है, तो customer से उसी currency में rule की amount charge की जाती है।
• कोई match नहीं, या pricing_mode नहीं है: base price लागू होती है; customer की currency base currency के बराबर होने पर सीधे charge की जाती है, अन्यथा Adaptive Currency के माध्यम से परिवर्तित की जाती है।

​

Subscription Plan बदलावों पर यह कैसे लागू होता है

• By Country: subscription के billing country से मेल खाने वाला rule लागू होता है। यदि rule की currency उस currency से अलग है जिसमें subscription billed है, तो rule की amount को live FX rates पर परिवर्तित किया जाता है — rule लागू होता है, छोड़ा नहीं जाता।
• By Currency: customer को billed currency से मेल खाने वाला rule लागू होता है और customer से ठीक rule की amount charge की जाती है।
• कोई match नहीं, या pricing_mode नहीं है: नए plan की base price लागू होती है, आवश्यकता होने पर Adaptive Currency के माध्यम से परिवर्तित की जाती है — checkout जैसा ही fallback।

• Previews सटीक होते हैं। Preview Change Plan वही localized amount लौटाता है जिसे वास्तविक change charge करता है।
• Renewals localized price बनाए रखते हैं। Change के बाद नया plan अपनी localized amount पर renew होता है और fees-inclusive बना रहता है, ठीक उसी तरह जैसे उस price पर बनाई गई subscription।
• Proration वास्तविक amounts का उपयोग करता है। Upgrade पर unused time का credit उस राशि पर आधारित होता है जो customer ने पुराने plan के लिए वास्तव में चुकाई थी, जबकि नए plan की कीमत उसके localized rule से तय होती है।
• Scheduled changes schedule किए जाने पर price lock करते हैं। Billing period के अंत के लिए scheduled change, schedule किए जाने के समय calculate की गई amount charge करता है, भले ही बीच में आप rule edit कर दें।
• Billing currency कभी नहीं बदलती। Plan change उस currency को कभी नहीं बदलता जिसमें subscription settle होती है; किसी अन्य currency वाले rule को FX के माध्यम से उसी currency में परिवर्तित किया जाता है।
• Add-ons localized नहीं होते। नए plan पर add-on prices हमेशा अपनी base pricing का उपयोग करती हैं।

​

महत्वपूर्ण व्यवहार

​

सर्वोत्तम प्रथाएँ

• उचित base price रखें। यह बिना rule वाले प्रत्येक market के लिए fallback है, जिसे Adaptive Currency के माध्यम से परिवर्तित किया जाता है।
• साफ़-सुथरी संख्याएँ दर्ज करें। Fixed amount का उद्देश्य ₹999, €9.99 या ¥1000 जैसी सुव्यवस्थित price है, न कि FX result। प्रत्येक currency में automatic rounding के लिए Charm Pricing देखें।
• काम के अनुसार mode चुनें। Purchasing-power pricing के लिए by_country का उपयोग करें; जब प्रत्येक currency zone के लिए एक price पर्याप्त हो, तो by_currency का उपयोग करें।
• Promotions के लिए recreate करने के बजाय archive करें। किसी rule को archive करने से history सुरक्षित रखते हुए market base/adaptive पर लौट जाता है; आवश्यकता के अनुसार बाद में recreate या re-price करें।
• कुल राशि का विज्ञापन करने से पहले tax line पर ध्यान दें। Tax-exclusive products के लिए customer localized amount और tax चुकाता है, इसलिए इसे ads में final price के रूप में quote न करें।

​

संबंधित