القسائم

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

تُدار القسائم في تطبيقك من خلال Admin > Commerce > Products، ضمن قسم Coupons، وكذلك في تبويب Cupones في لوحة إدارة تطبيقك المنشور.

مكوّنات القسيمة

الحقل	ملاحظات
`code`	رمز الترويج الذي يكتبه العملاء عند الدفع (مثلاً `LAUNCH20`)
`percent_off` أو `amount_off`	حقلان متنافيان. النسبة المئوية تتراوح بين 1 و100. المبلغ يُحدَّد بأصغر وحدة للعملة (سنتات).
`currency`	مطلوب لخصومات `amount_off` (رمز ISO المكوّن من ثلاثة أحرف). يُقبل عند الإنشاء ويُمرَّر إلى Stripe، لكنه لا يُخزَّن ولا يُعاد إرساله عبر الـ API بعد ذلك.
`duration`	`once` (الدفعة الأولى فقط)، أو `repeating` (لمدة `duration_in_months`)، أو `forever`
`duration_in_months`	مطلوب عندما تكون `duration` بقيمة `repeating`
`max_redemptions`	الحد الأقصى الإجمالي لجميع العملاء
`redeem_by`	تاريخ الانتهاء الذي تتوقف القسيمة عن العمل بعده
`name`	الاسم المعروض للعملاء
`active`	مفتاح تبديل لتفعيل القسيمة أو تعطيلها دون حذفها

إنشاء قسيمة

من تبويب Coupons الفرعي، انقر على Add coupon واملأ الحقول. إليك بعض الأشكال الشائعة:

الهدف	الإعدادات
خصم 20% للأبد	`percent_off: 20`، المدة forever
خصم 10 دولارات، استخدام واحد، تنتهي خلال 30 يوماً	`amount_off: 1000`، العملة USD، المدة once، الحد الأقصى للاسترداد 1، تاريخ الانتهاء بعد 30 يوماً
خصم 50% على الأشهر الثلاثة الأولى من الاشتراك	`percent_off: 50`، المدة repeating، المدة بالأشهر 3

أو اطلب من الذكاء الاصطناعي مباشرةً: "Create a LAUNCH20 coupon for 20% off forever."

تطبيق قسيمة عند الدفع

يوجد طريقتان يمكن للعميل من خلالهما استخدام الرمز:

في صفحة دفع Stripe — يظهر حقل رمز الترويج تلقائياً، فيمكن للعميل كتابة الرمز هناك دون أي جهد منك.
في سلة التسوق الخاصة بك — أضف حقل رمز ترويجي إلى سلة التسوق ومرِّر ما كتبه العميل إلى طلب الدفع على شكل couponCode. يتحقق السيرفر من صحة الرمز ويحسب الخصم من بيانات التجارة الخاصة بك (لا من أي مبلغ يُرسله المتصفح)، ويسجّله على الطلب ويربط قسيمة Stripe المناظرة لضمان صحة المبلغ المخصوم.

اطلب من الذكاء الاصطناعي: "Add a promo code field to the cart and apply it at checkout."

العرض والتعديل والتعطيل

يُدرج تبويب Coupons الفرعي جميع القسائم مع عدد مرات استردادها مقارنةً بالحد الأقصى المحدد، مما يتيح لك متابعة أداء الحملات بنظرة واحدة. التعديل محدود عمداً — راجع الملاحظات أدناه — غير أنه يمكنك تعطيل أي قسيمة دون حذفها، مما يوقف عملها فوراً عند الدفع.

ملاحظات وقيود

الرموز ومبالغ الخصم غير قابلة للتعديل. يمكنك تحديث name المعروض وتبديل حالة active، لكن لا يمكنك تعديل percent_off أو amount_off أو code ذاته. أنشئ قسيمة جديدة إذا احتجت إلى شروط مختلفة.
times_redeemed يزداد تلقائياً وهو للقراءة فقط — مفيد لتتبع أداء الحملات.
تُطبَّق القسائم على مستوى العميل، لا على مستوى الطلب — فإذا كانت القسيمة forever واشترك العميل، فسيحصل كل تجديد على الخصم.