التسعير المحلي

​

ما هو التسعير المحلي؟

​

حالات الاستخدام

​

المفاهيم الأساسية

• أوضاع التسعير — يكون المنتج في وضع واحد فقط في كل مرة، ويحدده pricing_mode الخاص به:
  • by_currency: سعر واحد لكل عملة، بغض النظر عن البلد. كل من يدفع باليورو يرى €9.99.
  • by_country: سعر خاص ببلد معين (₹999 في الهند)، حتى عندما تشترك عدة بلدان في العملة نفسها.
• مبالغ ثابتة، بأصغر وحدة — إن amount الخاص بالقاعدة هو عدد صحيح بأصغر وحدة للعملة، كما هو الحال في كل مكان آخر في API: 99900 تساوي ₹999.00، و999 تساوي €9.99. إنه سعر تحدده أنت، وليس قيمة محوّلة على الإطلاق.
• تتغلب القاعدة المطابقة على التسعير التلقائي — عند تطبيق قاعدة محلية على بند ما، يتم تجاوز كل من Purchasing Power Parity وCharm Pricing لذلك البند. يدفع العميل المبلغ الذي حددته، من دون تغيير.
• عند عدم تطابق أي قاعدة — يحتفظ المنتج بسلوكه الحالي: يدفع العملاء بعملتك الأساسية السعر الأساسي مباشرةً؛ بينما يحصل الآخرون على السعر محوّلًا عبر Adaptive Currency.
• تكون الرسوم مشمولة عند تطابق قاعدة — يدفع العميل المبلغ الذي حددته بالضبط. تتحمل أنت رسوم الصرف الأجنبي في Adaptive Currency (وتُعامل الرسوم على أنها مشمولة لهذه المعاملة) بدلًا من إضافتها إلى السعر، ولذلك يكون سعرك المحلي المعلن هو السعر المحصّل دائمًا.

​

الإعداد في لوحة التحكم

1

Open the product form

في لوحة تحكم التاجر الخاصة بك، انتقل إلى المنتجات وقم بإنشاء منتج (أو افتح منتج حالي لتحريري). حدد السعر الأساسي والعملة كما هو معتاد.

2

Enable Localized Pricing and choose a mode

في قسم التسعير، ضع علامة على التسعير المحلي، ثم اختر حسب البلد أو حسب العملة.

3

Add a price for each market

انقر على إضافة سعر البلد أو إضافة سعر العملة، ثم املئ لوحة التسعير المحلي، واضغط على إضافة. يظهر كل سوق تضيفه في جدول التجاوزات، حيث يمكنك تحريره أو حذفه لاحقاً.

• By Country
• By Currency

اختر بلداً، حدد العملة، وأدخل المبلغ (على سبيل المثال ₹999 للهند)، ثم اضغط على إضافة.

البلد يظهر الآن في جدول التجاوزات حسب البلد، حيث يمكنك تحريره أو حذفه.

اختر عملة وأدخل المبلغ (على سبيل المثال €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',
});

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: ينطبق السعر الأساسي، يتم تحصيله مباشرة عندما تكون عملة العميل مساوية للعملة الأساسية، أو يتم تحويله عبر تكييف العملة.

​

كيفية تطبيق ذلك عند تغيير خطة الاشتراك

• حسب البلد: تُطبَّق القاعدة المطابقة لبلد فوترة الاشتراك. إذا اختلفت عملة القاعدة عن العملة التي تتم فوترة الاشتراك بها، يُحوَّل مبلغ القاعدة وفق أسعار الصرف الأجنبي المباشرة — تُطبَّق القاعدة ولا يتم تجاهلها.
• حسب العملة: تُطبَّق القاعدة المطابقة للعملة التي تتم فوترة العميل بها، ويُحمَّل العميل مبلغ القاعدة كما هو تمامًا.
• عدم وجود تطابق، أو عدم وجود pricing_mode: يُطبَّق السعر الأساسي للخطة الجديدة، مع تحويله عبر Adaptive Currency عند الحاجة — وهو نفس الخيار الاحتياطي المستخدم عند الدفع.

• المعاينات دقيقة. يعرض Preview Change Plan المبلغ المترجم نفسه الذي يفرضه التغيير الفعلي.
• تحتفظ التجديدات بالسعر المترجم. بعد التغيير، تُجدَّد الخطة الجديدة بمبلغها المترجم — وتظل شاملة للرسوم — تمامًا مثل اشتراك أُنشئ بهذا السعر.
• يستخدم التوزيع النسبي المبالغ الفعلية. عند الترقية، يستند رصيد الوقت غير المستخدم إلى المبلغ الذي دفعه العميل فعليًا للخطة القديمة، بينما تُسعَّر الخطة الجديدة وفق قاعدتها المترجمة.
• تثبّت التغييرات المجدولة السعر عند جدولتها. يفرض التغيير المجدول لنهاية فترة الفوترة المبلغ المحسوب وقت الجدولة، حتى إذا عدّلت القاعدة في الفترة الفاصلة.
• لا تتغير عملة الفوترة أبدًا. لا يبدّل تغيير الخطة العملة التي تتم تسوية الاشتراك بها؛ بل تُحوَّل القاعدة بعملة أخرى إليها وفق أسعار الصرف الأجنبي.
• لا تُترجم أسعار الإضافات. تستخدم أسعار الإضافات في الخطة الجديدة دائمًا تسعيرها الأساسي.

​

سلوكيات مهمة

​

أفضل الممارسات

• حافظ على سعر أساسي معقول. فهو السعر الاحتياطي لكل سوق لا توجد له قاعدة، ويُحوّل عبر Adaptive Currency.
• أدخل أرقامًا بسيطة. الهدف الأساسي من المبلغ الثابت هو الحصول على سعر أنيق مثل ₹999 أو €9.99 أو ¥1000، وليس نتيجة تحويل وفق سعر الصرف. للتقريب التلقائي في كل العملات، راجع Charm Pricing.
• اختر الوضع المناسب للمهمة. استخدم by_country لتسعير القوة الشرائية؛ واستخدم by_currency عندما يكون سعر واحد لكل منطقة عملة كافيًا.
• أرشف القواعد بدلًا من إعادة إنشائها للعروض الترويجية. تؤدي أرشفة القاعدة إلى إعادة السوق إلى التسعير الأساسي/التسعير عبر Adaptive Currency مع الحفاظ على السجل؛ ويمكنك إعادة إنشائها أو إعادة تسعيرها لاحقًا حسب الحاجة.
• انتبه إلى بند الضريبة قبل الإعلان عن إجمالي. في المنتجات غير الشاملة للضريبة، يدفع العميل المبلغ المحلي بالإضافة إلى الضريبة، لذلك لا تذكره على أنه السعر النهائي في الإعلانات.

​

ذات صلة