الانتقال إلى المحتوى الرئيسي
Discount codes overview cover
تتيح لك رموز الخصم إجراء ترويجيات وحوافز مستهدفة. أنشئ خصومات بنسبة مئوية أو مبلغ ثابت، وحدد الحدود وتواريخ انتهاء الصلاحية، وقيّدها بالمنتجات، وطبقها بسلاسة في عملية الدفع.

Checkout Sessions

قم بتطبيق الرموز أثناء إتمام الدفع المستضاف باستخدام discount_code وعناصر التحكم في واجهة المستخدم.

Validate Discount

تحقق مما إذا كان الخصم صالحًا بواسطة معرفه.

Get Discount by Code

ابحث عن الخصم وتأكد من صحته باستخدام اسم الرمز الخاص به (على سبيل المثال، “SAVE20”).

Create Discount (API)

أنشئ رموز خصم جديدة برمجيًا.

List & Update Discounts

تصفح وإدارة الخصومات الحالية؛ قم بالتحديث أو الحذف حسب الحاجة.

Plan Change Discounts

تطبيق رموز الخصم عند ترقية أو تخفيض خطط الاشتراك.

ما هي رموز الخصم؟

رموز الخصم هي رموز ترويجية تقلل من الإجمالي عند الدفع. إنها مثالية لـ:
  • الحملات الموسمية: الجمعة السوداء، إطلاق المنتجات، أو الذكريات السنوية
  • عروض الاستحواذ: حوافز الشراء الأول أو مكافآت الإحالة
  • الحفاظ على العملاء: مكافآت الاستعادة أو الولاء للعملاء الحاليين
  • صفقات B2B: التسعير المتفق عليه أو المتفاوض عليه عبر رموز خاصة

الفوائد الرئيسية

  • خصومات مرنة: نسبة مئوية أو مبلغ ثابت
  • تحكم مستهدف: تقييد بالمنتج ودورات الاشتراك
  • حوكمة الحملة: تواريخ انتهاء وحدود الاستخدام
  • تجربة دفع سلسة: حقل UI ودعم API عبر جلسات الدفع

إنشاء رموز الخصم

أنشئ رموز الخصم في لوحة التحكم في Dodo Payments، ثم قم بتطبيقها في الدفع المستضاف أو عبر API.

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

  • اسم الخصم (مطلوب): الاسم الداخلي واسم العرض في لوحة التحكم
  • الرمز (مطلوب): السلسلة التي يدخلها العملاء عند الدفع
  • النوع والمبلغ (مطلوب): تحديد نسبة مئوية أو قيمة مبلغ ثابت، أو توليد رمز عشوائي باستخدام الزر المقدم
  • تاريخ الانتهاء (اختياري): التاريخ الذي يصبح فيه الرمز غير صالح
  • حد الاستخدام (اختياري): إجمالي الحد الأقصى للتنفيذات عبر جميع العملاء
  • تقييد المنتج (اختياري): تحديد التطبيق على المنتجات المختارة
  • حد دورة الاشتراك (اختياري): عدد دورات الفوترة التي ينطبق عليها الخصم
استخدم حدود الدورات للتسعير التمهيدي للاشتراكات (مثل “خصم 50% لمدة 3 أشهر”).

تجربة الدفع

  1. يدخل المتسوقون الرمز في حقل الدفع.
  2. يتم تطبيق الخصومات المؤهلة وتحديث الإجماليات فورًا.
في جلسات الدفع، قم بتمرير discount_code لتطبيق رمز مسبقًا، واضبط feature_flags.allow_discount_code لعرض حقل الإدخال.

إدارة API

أنشئ رموز الخصم برمجيًا مع النوع والمبلغ.

API Reference

عرض إنشاء واجهة برمجة تطبيقات الخصم.
قائمة جميع الخصومات أو استرداد التفاصيل للإدارة والمراجعة.

API Reference

تصفح قائمة APIs والاسترداد.
ابحث عن خصم باستخدام رمزه القابل للقراءة البشري (مثل “SAVE20”) بدلاً من المعرف الداخلي.

API Reference

استرداد الخصم بالاسم الرمز.
تعديل تكوين الخصم مثل المبلغ أو الانتهاء أو القيود.

API Reference

تعلم كيفية تحديث تفاصيل الخصم.
تحقق مما إذا كان الخصم صالحًا وقابل للتطبيق قبل التطبيق.

API Reference

تحقق من استخدام الخصم.
إلغاء التفعيل أو إزالة الخصومات التي لم تعد بحاجة إليها.

API Reference

حذف خصم.

حالات استخدام شائعة

  • عروض تمهيدية: عروض إطلاق محدودة الزمن لمنتجات جديدة
  • الشراء بالجملة أو B2B: خصومات متفق عليها لمجموعات منتجات محددة
  • استراتيجيات الحفاظ: رموز استعادة في سياقات منع التسرب
  • حملات موسمية: ترويجات قائمة على العطلات أو الأحداث

أمثلة تكامل

تطبيق خصم في جلسات الدفع

تطبيق خصم مسبق وإظهار واجهة إدخال الرمز.
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  discount_code: 'BLACKFRIDAY2024',
  customer: { email: 'user@example.com', name: 'Jane Doe' },
  return_url: 'https://yoursite.com/return'
});

تطبيق خصم أثناء تغيير الخطط

تقديم أسعار ترويجية عند ترقية أو تخفيض اشتراك العملاء.
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  discount_code: 'UPGRADE20'
});
إذا كان الاشتراك يحتوي بالفعل على خصم مع preserve_on_plan_change=true ولم تقم بتمرير رمز جديد، يتم الحفاظ على الخصم الحالي تلقائيًا عندما يكون قابلاً للتطبيق على المنتج الجديد.

تمكين إدخال الخصم بدون تطبيق مسبق

دع العملاء يدخلون رمزًا عند الدفع بدون تمرير واحد مسبقًا.
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  feature_flags: {
    allow_discount_code: true
  },
  return_url: 'https://yoursite.com/return'
});

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

  • تسمية واضحة: استخدم رموزًا قابلة للتعرف تتطابق مع أسماء الحملات
  • تحديد زمني: أضف تواريخ انتهاء لتشجيع العجلة ومنع الإساءة
  • نطاق بحكمة: حدد لمنتجات معينة لتجنب تسرب الأرباح
  • التحقق مبكرًا: تحقق من ملاءمة الرمز قبل تأكيد الدفع
  • مراقبة التأثير: تتبع الاستخدام والتحويل حسب الحملة
رموز الخصم أدوات قوية للاكتساب والحفاظ. ابدأ بعروض بسيطة ومسماة بشكل جيد، تحقق بدقه، وقم بالتكرير بناءً على الأداء.
Last modified on March 24, 2026