الاشتراك — فوترة سحابة صناديق

إصدار المنتج: 1.0.0+1 آخر تحديث: 2026-08-03 الجمهور المستهدف: مستخدمون بصلاحية billing:read (billing:update للتعديل)

أ. صفحة الاشتراك

المسار: /billing/subscription (ومن مركز الفوترة).

تعرض الاشتراك النشط (أو المعلّق): الخطة، الحالة، الأشهر، المقاعد/الموظفون، بدل التخزين، وتوقيت الفوترة عند توفره من الواجهة البرمجية.

حالات شائعة: active، pending، trialing، past_due، cancelled، وما يعيده الـ API.

ب. كيف يعمل التسعير

تستخدم سحابة صناديق أسعار الخطة (وليست مستويات ثابتة بالاسم). تختار المؤسسة:

الإجمالي مرة واحدة لكل فترة (اشتراك جديد):

(السعر_الشهري × الأشهر)
+ (سعر_الموظف × الموظفون)
+ (max(التخزين − التخزين_المجاني, 0) × سعر_GB)

يُفوتر فقط التخزين فوق البدل المجاني. بطاقة عرض الخطط وفواتير الاشتراك الجديد تستخدم نفس الصيغة.

ج. اشتراك جديد

1. افتح الفوترة > الخطط.
2. عيّن الأشهر والموظفين/المقاعد والتخزين.
3. راجع الإجمالي → ادفع → Stripe Checkout (وضع الاشتراك).
4. العودة عبر مسارات النجاح/الإلغاء؛ يؤكّد التطبيق الجلسة عند النجاح (وقد يفعّل الـ webhook أيضاً).

د. تعديل (تحديث) الاشتراك

عند وجود اشتراك تشغيلي:

1. المركز أو الاشتراك → تحديث / تعديل (/billing/subscription/adjust).
2. عدّل الأشهر والمقاعد والتخزين ضمن الحدود.
3. التأكيد → تجهيز القيم وإنشاء فاتورة غير مدفوعة لـ رسوم التحديث. إن كانت الرسوم صفراً تُطبَّق فوراً بلا فاتورة.
4. ادفع الفاتورة عبر Checkout بوضع الدفع.
5. بعد الدفع تصبح القيم المجهّزة فعّالة. الفواتير السابقة لا تُعاد حسابها ولا يُرد رصيد للتخفيضات.

الخفض لا يُنتج رصيداً. لا يمكن خفض التخزين دون ما تستخدمه المؤسسة فعلياً في الوسائط.

كتالوج الخطط لا يبدأ اشتراكاً جديداً ثانياً وأنت مشترك؛ يوجّهك إلى التعديل.

هـ. ما ليس في واجهة المستأجر

• صفحة إلغاء الاشتراك
• نموذج تجديد منفصل
• خزنة بطاقات / Customer Portal
• جدول إعادة محاولة Past Due داخل التطبيق
• تفصيل بنود التقسيم على شاشة التعديل

ذات صلة: نظرة عامة | الخطط | الفواتير | الاستخدام | المدفوعات