الخصومات

​

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

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

​

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

• خصومات مرنة: نسبة مئوية أو مبلغ ثابت
• تحكم مستهدف: تقييد بالمنتج ودورات الاشتراك
• حوكمة الحملة: تواريخ انتهاء وحدود الاستخدام
• تجربة دفع سلسة: حقل UI ودعم 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'
});

​

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

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