الخصومات

​

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

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

​

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

• خصومات مرنة: خصومات تعتمد على النسبة المئوية
• رموز قابلة للجمع: يمكن تطبيق ما يصل إلى 20 رمزًا لكل عملية دفع، أو اشتراك — اجمع الحملات (مثل WELCOME10 + BLACKFRIDAY20) دون إنشاء رموز مخصصة
• تحكم مستهدف: قيّد حسب المنتجات ودورات الاشتراك
• إدارة الحملات: تواريخ انتهاء وحدود الاستخدام
• دفع سلس: دعم حقل واجهة المستخدم وAPI عبر جلسات الدفع

​

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

​

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

• اسم الخصم (مطلوب): الاسم الظاهر داخليًا وفي لوحة البيانات
• الرمز (مطلوب): النص الذي يدخله العملاء عند الدفع
• النوع والمبلغ (مطلوب): تعيين قيمة النسبة المئوية (حاليًا تدعم الخصومات المعتمدة على النسبة المئوية فقط)، أو إنشاء رمز عشوائي باستخدام الزر المتاح
• تاريخ الانتهاء (اختياري): التاريخ الذي يصبح فيه الرمز غير صالح
• حد الاستخدام (اختياري): الحد الأقصى لإجمالي عمليات الاسترداد لجميع العملاء
• تقييد المنتج (اختياري): تحديد التطبيق على المنتجات المختارة
• حد دورة الاشتراك (اختياري): عدد دورات الفوترة التي ينطبق عليها الخصم
• البيانات الوصفية (اختياري): إرفاق أزواج مفاتيح مخصصة للتتبع الداخلي أو التكاملات

​

تجربة الدفع

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

​

إدارة API

​

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

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

​

أمثلة تكامل

​

إنشاء خصم مع البيانات الوصفية

const discount = await client.discounts.create({
  type: 'percentage',
  amount: 1500, // 15%
  code: 'SUMMER2025',
  metadata: {
    campaign: 'summer_promo',
    source: 'email_blast'
  }
});

​

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

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

​

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

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

​

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

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

​

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

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

​

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

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