٩. الخطط والمدفوعات¶

ملاحظة

بعد الدفع الناجح يُنشأ/يُجدّد المستخدم تلقائياً بمعاملات الخطة.

نظام الخطط¶

Plans → New Plan

الحقل	الوصف
Name	اسم الخطة (مثل "Monthly 50GB")
Data limit	حد الحركة
Duration days	فترة الاشتراك
Device limit	عدد الأجهزة
Reset strategy	monthly / …
Price (Toman)	سعر بالريال
Price (USD)	سعر بالدولار/كريبتو
Max users	حد المبيعات (0 = غير محدود)
Enabled	نشط/غير نشط

الطلبات¶

Orders — قائمة الطلبات:

الحالة	المعنى
`pending`	في انتظار الدفع
`paid`	مدفوع — المستخدم أُنشئ/جدّد
`failed`	فشل
`expired`	انتهت المهلة

بوابة ZarinPal (Rial)¶

التكوين¶

اضبط متغيرات env المتعلقة بـ ZarinPal في deploy/.env (Merchant ID و callback URL).

تدفق الدفع¶

sequenceDiagram
    User->>Panel: Select plan
    Panel->>ZarinPal: Payment request
    ZarinPal->>User: Redirect to gateway
    User->>ZarinPal: Pay
    ZarinPal->>Panel: Callback verify
    Panel->>Panel: Create/renew user

بوابة NowPayments (Crypto)¶

IPN Webhook¶

POST /api/payment/ipn/nowpayments

توقيع HMAC-SHA512 مع NowPaymentsIPNSecret
بعد التحقق → تفعيل تلقائي

المبيعات الآلية¶

أنشئ خطة نشطة
رابط مبيعات عام (في UI/API)
بعد الدفع الناجح → مستخدم بمعاملات الخطة

الموزّع + الخطط¶

يمكن للموزّع بيع خطط ضمن حصته — المستخدمون مسجلون تحت admin_id الخاص به.