إنتقل إلى المحتوى الرئيسي

المدفوعات والفواتير

توفر صفحة المدفوعات (Admin → Payments & Invoices) عرضاً موحداً لجميع أنشطة الدفع والفوترة عبر المنصة. الصفحة مقسّمة إلى تبويبين: Payment Events وInvoices.

📊 إحصاءات الإيرادات​

في أعلى الصفحة، تعرض أربع بطاقات ملخص المؤشرات المالية على مستوى المنصة:

البطاقةالوصف
Total Revenueمجموع جميع مبالغ الفواتير المدفوعة
Total Refundedمجموع جميع المبالغ المستردة
Pending Amountمجموع جميع مبالغ الفواتير المعلقة
Invoice Countإجمالي عدد الفواتير عبر جميع المستأجرين

📋 تبويب أحداث الدفع​

يعرض هذا التبويب سجلاً بجميع أحداث الـ webhook المتعلقة بالدفع من Stripe وPayPal.

سجل الأحداث​

يعرض كل إدخال:

العمودالوصف
GatewayStripe أو PayPal
Event Typeمثل: customer.subscription.created، invoice.payment_failed
Tenantالمستأجر المرتبط بالحدث
Event IDالمعرف الفريد للحدث من بوابة الدفع
Processedهل تمت معالجة الحدث بنجاح
Dateوقت استلام الحدث

التصفية​

يمكن التصفية حسب:

  • بوابة الدفع (Stripe/PayPal)
  • نوع الحدث
  • المستأجر
  • النطاق الزمني

يمكن توسيع كل صف من صفوف أحداث الدفع لعرض تفاصيل الفاتورة المرتبطة، بما فيها رقم الفاتورة والمبلغ والحالة.

🔍 الأحداث المتتبعة​

أحداث Stripe​

الحدثما يحدث
checkout.session.completedتفعيل اشتراك جديد
customer.subscription.createdإنشاء سجل الاشتراك
customer.subscription.updatedتغيير الخطة أو التجديد
customer.subscription.deletedإلغاء الاشتراك
invoice.payment_failedفشل الدفع — إرسال إشعار

أحداث PayPal​

الحدثما يحدث
BILLING.SUBSCRIPTION.CREATEDبدء الاشتراك
BILLING.SUBSCRIPTION.ACTIVATEDتأكيد الاشتراك
BILLING.SUBSCRIPTION.CANCELLEDإلغاء الاشتراك
BILLING.SUBSCRIPTION.SUSPENDEDتعليق الاشتراك

🧾 تبويب الفواتير​

يعرض هذا التبويب جميع فواتير المستأجرين عبر المنصة.

التصفية​

يمكن التصفية حسب:

  • المستأجر
  • الحالة (pending، paid، void)
  • النطاق الزمني

جدول الفواتير​

العمودالوصف
Invoice Numberالمعرف الفريد
Tenantالمستأجر المالك للفاتورة
Amountإجمالي مبلغ الفاتورة
Taxمبلغ الضريبة المضمّن
Statuspending أو paid أو void
Dateوقت إنشاء الفاتورة

⏭️ الخطوات التالية​