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

​

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

​

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

​

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

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

​

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

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، وليس نتيجة لتحويل أسعار الصرف الأجنبي.
• اختر الوضع المناسب للمهمة. استخدم by_country لتسعير القدرة الشرائية؛ واستخدم by_currency عندما يكون سعر واحد لكل منطقة عملة كافيًا.
• أرشف القواعد بدلًا من إعادة إنشائها للعروض الترويجية. تؤدي أرشفة القاعدة إلى إعادة السوق إلى السعر الأساسي/التكيفي مع الحفاظ على السجل؛ ويمكنك إعادة إنشائها أو إعادة تسعيرها لاحقًا حسب الحاجة.
• انتبه إلى بند الضريبة قبل الإعلان عن إجمالي. بالنسبة إلى المنتجات غير الشاملة للضريبة، يدفع العميل المبلغ المترجم بالإضافة إلى الضريبة، لذلك لا تذكره باعتباره السعر النهائي في الإعلانات.

​

ذات صلة