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

​

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

​

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

​

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

• Pricing modes — कोई product एक समय में ठीक एक mode में होता है, जो उसके pricing_mode द्वारा set किया जाता है:
  • by_currency: प्रत्येक currency के लिए एक price, country की परवाह किए बिना। EUR में payment करने वाला हर व्यक्ति €9.99 देखता है।
  • by_country: किसी country के लिए specific price (भारत में ₹999), तब भी जब कई countries एक ही currency share करते हों।
• Fixed amounts, in the smallest unit — किसी rule का amount currency की smallest unit में एक integer होता है, ठीक API में हर जगह की तरह: 99900 ₹999.00 है, 999 €9.99 है। यह आपके द्वारा set की गई price है, converted value कभी नहीं।
• A matched rule wins over automatic pricing — जब कोई localized rule किसी line पर लागू होता है, तो उस line के लिए Purchasing Power Parity और Charm Pricing दोनों skip कर दिए जाते हैं। Customer आपके द्वारा set की गई राशि का unchanged payment करता है।
• When no rule matches — Product अपना existing behavior बनाए रखता है: आपकी base currency में customers सीधे base price pay करते हैं; बाकी सभी को Adaptive Currency के माध्यम से convert किया जाता है।
• Fees are inclusive when a rule matches — Customer ठीक वही amount pay करता है जो आपने set की है। Adaptive Currency की FX fee आप absorb करते हैं (उस transaction के लिए fees-inclusive मानी जाती है), customer से ऊपर से add नहीं की जाती; इसलिए आपकी बताई गई local price ही हमेशा charged price होती है।

​

डैशबोर्ड में सेट अप करें

1

Open the product form

आपके मर्चेंट डैशबोर्ड में, Products पर जाएं और एक उत्पाद बनाएं (या संपादित करने के लिए एक मौजूदा खोलें)। सामान्य रूप से आधार मूल्य और मुद्रा सेट करें।

2

Enable Localized Pricing and choose a mode

मूल्य निर्धारण अनुभाग में, स्थानीयकृत मूल्य निर्धारण पर टिक करें, फिर देश के द्वारा या मुद्रा के द्वारा चुनें।

3

Add a price for each market

Add Country Price या Add Currency Price पर क्लिक करें, स्थानीयकृत मूल्य निर्धारण पैनल भरें, और Add पर क्लिक करें। प्रत्येक बाजार जिसे आप जोड़ते हैं वह ओवरराइड्स टेबल में दिखाई देता है, जहां आप इसे बाद में संपादित या हटा सकते हैं।

• By Country
• By Currency

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

देश अब देश ओवरराइड्स टेबल में दिखाई देता है, जहां आप इसे संपादित या हटा सकते हैं।

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

मुद्रा अब मुद्रा ओवरराइड्स टेबल में दिखाई देती है, जहां आप इसे संपादित या हटा सकते हैं।

4

Save the product

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

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)
	}
}

​

एक स्थानीयकृत कीमत जोड़ें

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

​

सूची, अपडेट, और संग्रहित करें

// 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
rules, 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",
)

​

यह चेकआउट पर कैसे लागू होता है

• देश के द्वारा: बिलिंग देश से मेल खाने वाले नियम की खोज करता है। अगर एक मौजूद है, तो ग्राहक को उस मुद्रा में नियम की राशि चार्ज की जाती है।
• मुद्रा के द्वारा: ग्राहक की मुद्रा से मेल खाने वाले नियम की खोज करता है (billing_currency, या उनके देश से व्युत्पन्न मुद्रा)। अगर एक मौजूद है, तो ग्राहक को उस मुद्रा में नियम की राशि चार्ज की जाती है।
• कोई मेल नहीं, या कोई pricing_mode नहीं: आधार कीमत लागू होती है, सीधे तब चार्ज की जाती है जब ग्राहक की मुद्रा आधार मुद्रा के बराबर होती है, अन्यथा अनुकूली मुद्रा के माध्यम से रूपांतरित होती है।

​

Subscription Plan में बदलावों पर इसका प्रभाव

• By Country: subscription के billing country से match करने वाला rule लागू होता है। यदि rule की currency उस currency से अलग है जिसमें subscription का billing होता है, तो rule की amount को live FX rates पर convert किया जाता है — rule को लागू किया जाता है, छोड़ा नहीं जाता।
• By Currency: customer से billing के लिए उपयोग की जा रही currency से match करने वाला rule लागू होता है, और customer से ठीक rule की amount charge की जाती है।
• कोई match नहीं, या कोई pricing_mode नहीं: नए plan की base price लागू होती है, और आवश्यकता होने पर Adaptive Currency के माध्यम से convert की जाती है — 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 उस amount पर आधारित होता है जो customer ने पुराने plan के लिए वास्तव में paid किया था, जबकि नए plan की pricing उसके localized rule से निर्धारित होती है।
• Scheduled changes schedule किए जाने के समय price lock करते हैं। Billing period के अंत के लिए scheduled change, scheduling के समय calculated amount charge करता है, भले ही इस बीच आप rule को edit कर दें।
• Billing currency कभी नहीं बदलती। Plan change कभी उस currency को switch नहीं करता जिसमें subscription settle होती है; किसी अन्य currency में मौजूद rule को FX के माध्यम से subscription की currency में convert किया जाता है।
• Add-ons localized नहीं होते। नए plan पर add-on prices हमेशा अपनी base pricing का उपयोग करती हैं।

​

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

​

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

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

​

संबंधित