الخصومات

​

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

​

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

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

​

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

​

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

• اسم الخصم (مطلوب): تسمية داخلية للوحة التحكم.
• الرمز (مطلوب): السلسلة التي يدخلها العملاء عند الدفع. أنشئ رمزًا عشوائيًا أو أدخل رمزك الخاص (بحد أدنى 3 أحرف، مع تحويله تلقائيًا إلى أحرف كبيرة).
• النوع (مطلوب): نسبة مئوية (خصم بنسبة مئوية) أو مبلغ (خصم ثابت).
• المبلغ (مطلوب): بالنسبة المئوية، نسبة الخصم في لوحة التحكم (مثل 15 لنسبة 15%). عبر API، تكون القيمة نفسها بوحدات نقاط الأساس (1500). بالنسبة للمبلغ، يكون الخصم الثابت بعملة الرمز الافتراضية.
• تاريخ البدء (اختياري): جدولة تفعيل الرمز في تاريخ مستقبلي. اتركه فارغًا لتفعيله فورًا.
• تاريخ الانتهاء (اختياري): التاريخ الذي يصبح بعده الرمز غير قابل للاسترداد.
• حد الاستخدام (اختياري، ضمن متقدم): الحد الأقصى لعمليات الاسترداد الإجمالية لجميع العملاء.
• حد الاستخدام لكل عميل (اختياري، ضمن متقدم): الحد الأقصى لعمليات الاسترداد من قِبل أي عميل واحد. يجب أن يكون أقل من حد الاستخدام الإجمالي أو مساويًا له عند تحديد كليهما.
• أهلية العميل (اختياري): تحديد من يمكنه الاسترداد — جميع العملاء، أو العملاء لأول مرة، أو العملاء الحاليون، أو قائمة محددة يدويًا.
• خيارات العملة (اختياري): مبلغ الخصم لكل عملة تبيع بها. راجع خيارات كل عملة.
• تقييد المنتج (اختياري): تقييد الرمز بمنتجات معينة.
• حد دورة الاشتراك (اختياري، ضمن متقدم): عدد دورات الفوترة التي ينطبق عليها الخصم. اتركه فارغًا ليكون الخصم غير محدد المدة.
• الحفاظ عند تغيير الخطة (اختياري): إبقاء الخصم نشطًا عند تغيير خطة الاشتراك (preserve_on_plan_change).
• البيانات الوصفية (اختياري): إرفاق أزواج مفتاح–قيمة مخصصة للتتبع الداخلي.
• طلب حد أدنى لقيمة الطلب (اختياري، ضمن متقدم): الحد الأدنى للإجمالي الفرعي للسلة (لكل عملة) لتطبيق الرمز.

​

أنواع الخصومات

​

أهلية العميل

​

خيارات كل عملة

• المبلغ — بالنسبة لخصم من نوع المبلغ، يكون الخصم الثابت بتلك العملة؛ وبالنسبة لخصم من نوع النسبة المئوية، يكون الحد الأقصى للخصم. يُطابق max_amount_possible في API.
• الافتراضية — عيّن عملة واحدة كعملة افتراضية. تُحوَّل العملات غير المهيأة انطلاقًا من هذه العملة الافتراضية.

• الإجمالي الفرعي الأدنى — لا يُطبّق الرمز إلا عندما تصل السلة إلى هذا الإجمالي الفرعي بتلك العملة. يعني 0 عدم وجود حد أدنى.

​

تجربة إتمام الشراء

​

تجميع رموز الخصم

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  discount_codes: ['WELCOME10', 'BLACKFRIDAY20'], // applied in this order
  customer: { email: 'user@example.com' },
  return_url: 'https://yoursite.com/return'
});

​

إدارة API

​

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

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

​

أمثلة التكامل

​

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

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

​

تطبيق الخصومات في Checkout Sessions

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_abc', quantity: 1 }
  ],
  discount_codes: ['BLACKFRIDAY2024', 'NEWUSER5'], // stacked in array order
  customer: { email: 'user@example.com', name: 'Jane Doe' },
  return_url: 'https://yoursite.com/return'
});

​

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

await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  discount_codes: ['UPGRADE20']
});

​

إخفاء حقل رمز الخصم

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  feature_flags: {
    allow_discount_code: false
  },
  return_url: 'https://yoursite.com/return'
});

​

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

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