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

​

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

​

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

​

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

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

​

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

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. يظهر كل سوق تضيفه في جدول التجاوزات، حيث يمكنك تعديله أو إزالته لاحقًا.

• By Country
• By Currency

اختر دولة، وحدد العملة، وأدخل المبلغ (مثلًا ₹999 للهند)، ثم انقر على Add.

تظهر الدولة الآن في جدول Country overrides، حيث يمكنك تعديلها أو إزالتها.

اختر عملة وأدخل المبلغ (مثلًا €9.99 لليورو EUR)، ثم انقر على Add.

تظهر العملة الآن في جدول Currency overrides، حيث يمكنك تعديلها أو إزالتها.

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
_, 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",
)

​

كيفية تطبيقه عند الدفع

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

​

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

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

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

​

السلوكيات المهمة

​

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

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

​

ذات صلة