انتقل إلى المحتوى

المفاهيم الأساسية

الباقات والحدود والفواتير.

لكل مساحة عمل اشتراك، وتحدد الواجهة البرمجية ما يحق لها من أحداث دفع موثّقة، لا من مجرد عودة المتصفح.

الباقات

الباقات التجريبية هي: Starter بـ 29 دولارًا شهريًا (3 مقاعد، و10,000 طلب، و5 غيغابايت)، وPro بـ 99 دولارًا (10 مقاعد، و100,000 طلب، و20 غيغابايت)، وScale بـ 249 دولارًا (30 مقعدًا، و500,000 طلب، و100 غيغابايت). هذه أسعار المنتج التجريبي نفسه، ولا علاقة لها بتراخيص Northstack. وتبدأ كل مساحة عمل جديدة بفترة تجريبية على Starter مدتها 14 يومًا.

مزوّدان للدفع

يحدد BILLING_PROVIDER طريقة الدفع:

  • simulator: صفحة دفع داخل لوحة التحكم لا تحتاج إلى أي مفاتيح ولا تحرّك أي أموال.
  • stripe: Stripe Checkout بنمط الاشتراك وبوابة Stripe للفوترة، باستخدام STRIPE_SECRET_KEY.

إشعارات الويب

وجّه إشعار ويب من Stripe إلى POST /api/billing/webhooks/stripe واضبط STRIPE_WEBHOOK_SECRET. تتحقق الواجهة البرمجية من كل توقيع، وتعالج كل حدث مرة واحدة فقط. وعند عودة الشخص من صفحة الدفع، تقرأ الواجهة البرمجية الجلسة من Stripe أيضًا، فيتأكد الدفع حتى في تثبيت محلي لا تصله الإشعارات.

التأخر في السداد والإلغاء

يجعل تعثّرُ الدفع مساحةَ العمل متأخرة السداد ويُظهر تنبيهًا بذلك. وبعد BILLING_GRACE_DAYS (سبعة أيام افتراضيًا) تبقى المساحة قابلة للقراءة، لكن يتوقف فيها كل عمل جديد يُحتسب على الفاتورة، ولا تُحذف أي بيانات بسبب تعثر الدفع. أما الاشتراك الملغى فيبقى فعّالًا حتى نهاية الفترة المدفوعة.

شراء التراخيص

تبيع صفحة الأسعار الترخيصين عبر صفحة الدفع الخاصة بالموقع على /checkout. يكتب المشتري بريده واسمه، ويختار البطاقة أو PayPal، ثم يدفع على صفحة Stripe أو PayPal نفسها، فلا يعرض الموقع أي حقل لبيانات البطاقة.

  • تستخدم البطاقات STRIPE_SECRET_KEY، وتصل أحداثها إلى إشعار الويب نفسه الذي تستخدمه الفوترة.
  • يستخدم PayPal المتغيرين PAYPAL_CLIENT_ID وPAYPAL_CLIENT_SECRET، مع PAYPAL_ENV=sandbox حتى تبدأ البيع الفعلي. وتحصّل الواجهة البرمجية المبلغ حين يعود المشتري.
  • الطريقة التي لا مفاتيح لها تمر عبر صفحة الدفع التجريبية في الموقع، ولا يُحصَّل فيها أي مبلغ. وفي وضع العرض لا يُعرض أي مفتاح حقيقي أبدًا.

لا يُعدّ الطلب مدفوعًا إلا بعد أن تتحقق منه الواجهة البرمجية لدى مزوّد الدفع. ويعرض الإيصال عندها مفتاح الترخيص، ويُرسل المفتاح نفسه إلى بريد المشتري. والأسعار التي تحصّلها الواجهة البرمجية في back-end/src/modules/licenses/constants/license-offers.ts، فأبقها مطابقة لما في website/src/config/licenses.ts الذي يعرضها.

التالي: إدارة المنصة