الدفع

التسجيل المجاني، والدفع بالبطاقة عبر «ثواني» مع التحقق على الخادم، والتحويل البنكي، والكوبونات، والضريبة، والاسترداد.

ثلاث طرق للتسجيل

إجمالي السلة ما يحدث
صفر (دورات مجانية أو كوبون بنسبة 100%) يُحفظ الطلب مدفوعًا ويُسجَّل المتعلّم فورًا. ويمكن التسجيل في الدورة المجانية من صفحتها دون السلة.
بطاقة يُحفظ الطلب «معلّقًا»، ويدفع المتعلّم في صفحة «ثواني»، ولا تُفتح الدورة إلا حين يسأل خادمنا «ثواني» فتؤكد أن الجلسة مدفوعة.
تحويل بنكي يُحفظ الطلب «معلّقًا» وتظهر للمتعلّم بيانات التحويل، ثم يعلّمه المشرف مدفوعًا من «اللوحة > الطلبات» فيُسجَّل المتعلّم.

الأسعار والكوبونات والضريبة تُحسب دائمًا على الخادم من قاعدة البيانات، ولا تحفظ سلة المتصفح إلا معرّفات الدورات.

«ثواني» (البطاقات)

  1. افتح حساب تاجر لدى «ثواني» واحصل على المفتاحين السري والعام (مفاتيح الاختبار أولًا).
  2. اضبطهما في .env:
THAWANI_MODE="uat"            # بيئة الاختبار، و"live" للدفع الحقيقي
THAWANI_SECRET_KEY="..."
THAWANI_PUBLISHABLE_KEY="..."
  1. أعد التشغيل، ثم فعّل الدفع بالبطاقة من «اللوحة > الإعدادات». يجب أن تكون العملة الريال العُماني.

التسلسل في src/lib/thawani.ts وsrc/app/api/orders/route.ts:

  1. ينشئ POST /api/orders الطلب وجلسة دفع لدى «ثواني» بالإجمالي المحسوب على الخادم، ويعيد رابط صفحة الدفع.
  2. يدفع المتعلّم، فتعيده «ثواني» إلى /api/payments/thawani/return?order=CODE.
  3. يتجاهل هذا المسار ما في الرابط ويسأل «ثواني» عن حالة الجلسة؛ لا يُعلَّم الطلب مدفوعًا ولا تُنشأ التسجيلات إلا حين تكون الحالة paid. والجلسة الملغاة تلغي الطلب وتعيد استخدام الكوبون.

الحد الأدنى لدى «ثواني» 0.100 ريال.

التحويل البنكي

فعّله من الإعدادات واكتب بيانات التحويل باللغتين (البنك، واسم الحساب ورقمه، وما يُكتب في خانة الملاحظات). يراها المتعلّم بعد تأكيد الطلب وفي صفحة طلباته. وتبرز «اللوحة > الطلبات» التحويلات المنتظرة، وزر وصل التحويل: علّمه مدفوعًا يسجّل المتعلّم.

الكوبونات

من «اللوحة > الكوبونات»: نسبة مئوية أو مبلغ ثابت، مع حد أدنى اختياري للسلة، وحد للاستخدام، وتاريخ انتهاء، ومفتاح تشغيل. يُحتسب استخدام الكوبون في معاملة قاعدة البيانات نفسها التي يُحفظ فيها الطلب، بتحديث مشروط، فلا يمكن استخدام رمز محدود بخمسين مرة إحدى وخمسين مرة ولو تزامنت عمليات الشراء. وإلغاء طلب غير مدفوع يعيد الاستخدام.

حين يغطي الكوبون عدة دورات يُوزَّع الخصم بينها بنسبة أسعارها (allocateDiscount في src/lib/pricing.ts)، ويحفظ كل سطر في الطلب ما دُفع فعلًا مقابله، وعليه تُحسب أرباح المدرّبين.

ضريبة القيمة المضافة

من «الإعدادات > ضريبة القيمة المضافة %» (صفر افتراضيًا). تُضاف الضريبة إلى المبلغ بعد الخصم وتُقرَّب إلى البيسة.

الاسترداد

من «اللوحة > الطلبات» افتح طلبًا مدفوعًا واضغط استرداد: تُحذف التسجيلات التي أنشأها الطلب مع تقدّمها وشهاداتها ويُعلَّم الطلب مستردًا. أعد المبلغ من البنك أو من بوابة «ثواني»، فالقالب لا يستدعي واجهة الاسترداد لديها.

أرباح المدرّبين

من «الإعدادات > حصة المدرّب %» (70 افتراضيًا). يرى كل مدرّب حصته مما دفعه المتعلّمون في دوراته في صفحتي «نظرة عامة» و«الأرباح».