مقدمة
وحدة الاشتراكات تتيح إعداد المدفوعات الدورية للمستخدمين مقابل مجموعة ثابتة من المنتجات في المشروع. تتكون الاشتراك من مجموعة من المنتجات وفترة — يتم خصم التكلفة من المستخدم تلقائيًا (أو يدويًا) كل N يومًا، والتي تُحسب كمجموع أسعار المنتجات الداخلة فيها.
تتكون الوحدة من جزئين رئيسيين:
- وحدة "الاشتراكات" في القائمة الجانبية — فهرس لجميع اشتراكات المشروع. هنا يمكنك إنشاء، تعديل، وحذف الاشتراكات، وضبط حساب الدفع، والفترة، ومحتوى المنتجات. لمزيد من التفاصيل — في قسم إعدادات الاشتراكات.
- علامة "الاشتراكات" في بطاقة المستخدم — قائمة الاشتراكات الخاصة بمستخدم معين مع الحالات، وتو اريخ الانتهاء، والإجراءات اليدوية (للاشتراكات من نوع
custom). لمزيد من التفاصيل — في قسم اشتراكات المستخدم.
يتم العمل مع الاشتراكات من جانب تطبيق العميل عبر API. لمزيد من التفاصيل — في قسم API للاشتراكات.
كيف تعمل الاشتراكات
عند إنشاء اشتراك في لوحة الإدارة، تختار:
- حساب الدفع — يحدد كيفية إجراء الدفع. لمزيد من التفاصيل حول أنواع الحسابات — في قسم حسابات الدفع.
- الفترة بالأيام — كم مرة يحتاج المستخدم للدفع لتجديد الاشتراك.
- قائمة المنتجات الداخلة في الاشتراك — يتم حساب التكلفة الإجمالية للاشتراك من أسعارها الحالية.
عندما يقوم المستخدم بتفعيل الاشتراك عبر API، يقوم النظام بـ:
- إنشاء سجل للاشتراك لدى المستخدم.
- إرجاع رابط للدفع (لـ
stripeوmidtrans) أو تفعيل الاشتراك مباشرة لنوعcustom. - بعد انتهاء الفترة، يتم خصم الدفع التالي تلقائيًا (
stripe،midtrans) أو ينتظر التجديد اليدوي (custom).
حسابات الدفع المدعومة
يمكن ربط الاشتراك بأحد أنواع حسابات الدفع التالية:
- Stripe — خصومات دورية تلقائية عبر Stripe. بعد إنشاء الاشتراك، يُرجع API رابط للدفع الأولي.
- Midtrans — خصومات دورية تلقائية عبر Midtrans. بالمثل، يُرجع رابط للدفع.
- Custom — اشتراك يدوي. لا تتم الخصومات تلقائيًا؛ يتم التجديد والإلغاء بواسطة المسؤول من بطاقة المستخدم.
نوع حساب الدفع يحدد الإجراءات المتاحة على الاشتراك وما إذا كان يمكن إلغاؤه عبر API. يتم إلغاء الاشتراكات custom فقط من خلال لوحة الإدارة — في قسم المستخدم.
ديناميكية التكلفة
يتم حساب تكلفة الاشتراك كمجموع أسعار المنتجات الداخلة فيه. إذا قمت بتغيير سعر أحد المنتجات، ستقوم الاشتراكات النشطة تلقائيًا بإعادة حساب تكلفتها — سيتم تطبيق القيمة الجديدة بدءًا من الفترة التالية للخصم.
يتم دفع الفترة الحالية دائمًا بالسعر الساري في وقت بدايتها. هذا يسمح بتغيير محتوى وأسعار المنتجات دون التأثير على الفترات التي تم دفعها بالفعل من قبل المستخدم.