بوت Telegram لبيع VPN مع مدفوعات العملات المشفرة
بوت Telegram تستضيفه بنفسك يبيع اشتراكات VPN بالعملات المشفرة. يختار العميل باقة في المحادثة ويدفع على صفحة SnapEX Pay (USDT على TRC20 أو ERC20 أو BEP20، إضافةً إلى عملات أخرى حين يتيحها SnapEX لهذا المبلغ). وبعد تأكيد الدفعة، يُنشئ البوت المستخدم أو يُمدّد اشتراكه في لوحة Marzban أو 3x-ui أو Remnawave لديك، ويرسل رابط الاشتراك إلى المحادثة نفسها.
مجانًا. الإصدار 1.1.0.
ماذا تفعل الوحدة
- لا محفظة ولا عقدة بلوكتشين تحتاج إلى تشغيلها: تصل الأموال إلى رصيد التاجر الخاص بك في SnapEX Pay.
/startيعرض باقاتك على شكل أزرار؛ وكل ضغطة تُنشئ فاتورة SnapEX Pay ويردّ البوت بزر Pay.- يدعم Marzban و3x-ui (كلًّا من API الخاص بالـ clients في 3.1+ وAPI الأقدم الخاص بالـ inbounds) وRemnawave 2.x و3.x. ومع
PANEL_TYPE=noneيكتفي البوت بتأكيد الدفعة، وتمنح أنت الوصول بنفسك. - إشعار Webhook موقّع (HMAC-SHA256، مع نافذة مدتها 5 دقائق)؛ تُقرأ الفاتورة من جديد من API SnapEX Pay ولا تُنفَّذ إلا إذا كانت مدفوعة ومطابقة لطلب أنشأه البوت. عمليات التسليم المكررة تُنفِّذ الفاتورة مرة واحدة.
- التجديد: يُمدَّد اشتراك العميل العائد (حساب Telegram نفسه) من تاريخ الانتهاء الحالي، أو من الآن إذا كان قد مضى؛ والباقة ذات حد الترافيك تبدأ حصة جديدة.
- حاوية واحدة تعمل بـ long polling، فلا يلزم أن يكون متاحًا من الخارج إلا منفذ Webhook. تُحفظ الطلبات في SQLite مع نسخة من الباقة.
التثبيت
- في لوحة تحكم التاجر في SnapEX Pay أنشئ مفتاح API بالصلاحيتين
invoices.readوinvoices.write. - نزّل الأرشيف وفُكّ ضغطه، ونفّذ
cp .env.example .envواضبط رمز البوت، ومفتاح SnapEX Pay، وPANEL_TYPE(marzbanأو3xuiأوremnawaveأوnone)، وبيانات دخول اللوحة، وPLANS. - شغّل البوت:
docker compose up -d --build، ثم تابعdocker compose logs -f bot. - يستمع البوت على المنفذ
8080(/webhookو/health). ضعه خلف وكيل عكسي يدعم TLS مثل Caddy أو nginx. - في لوحة التحكم ← للمطورين اضبط عنوان Webhook على
https://<your bot host>/webhook، وضع السرwhsec_…(يظهر مرة واحدة فقط، عند حفظ العنوان أول مرة) فيSNAPEX_WEBHOOK_SECRET، ثم أعد التشغيل. أرسل/startإلى البوت واختبر باقة معSNAPEX_ENVIRONMENT=test.
الإعدادات
| TELEGRAM_BOT_TOKEN, SHOP_NAME | رمز البوت من @BotFather؛ واسم المتجر الذي يظهر في /start وفي وصف الفاتورة. |
|---|---|
| SNAPEX_API_KEY, SNAPEX_WEBHOOK_SECRET | مفتاح API التاجر (invoices.read، invoices.write) وسر Webhook (whsec_…). |
| SNAPEX_ENVIRONMENT, SNAPEX_FEE_ON | فواتير live أو test؛ ومن يدفع عمولة SnapEX — merchant أو customer. |
| PANEL_TYPE | marzban أو 3xui أو remnawave أو none، إضافةً إلى بيانات دخول تلك اللوحة. |
| PLANS | قيم id:days:price_usd:traffic_bytes مفصولة بفواصل؛ و0 بايت = بلا حدود. |
| SNAPEX_PARTNER_ID | اختياري: Partner ID للمُدمِج الذي أعدّ الوحدة (برنامج الإحالة في SnapEX Pay). اتركه فارغًا إذا أعددتها بنفسك. |
أسئلة
ما اللوحات التي يدعمها البوت؟
Marzban و3x-ui (MHSanaei، بكلا إصدارَي API) وRemnawave 2.x و3.x. ومع PANEL_TYPE=none يكتفي بقبول المدفوعات.
كيف يُربط العميل بمستخدم VPN؟
اسم المستخدم في اللوحة هو tg<telegram_id>، فيقابل كلَّ حساب Telegram مستخدمُ VPN واحد بالضبط، والدفعة المتكررة تُمدّد اشتراكه.
ماذا لو غيّرت الأسعار لاحقًا؟
تحتفظ الطلبات بنسخة من الباقة، لذا فتعديل PLANS لا يغيّر الطلبات المدفوعة بالفعل.
هل يمكن تنفيذ دفعة واحدة مرتين؟
لا. عمليات تسليم Webhook المكررة أو المتزامنة تُنفِّذ الفاتورة مرة واحدة، وكل ضغطة زر تحصل على فاتورة خاصة بها.
هل يحتاج الخادم إلى منفذ مفتوح لـ Telegram؟
لا. يستخدم البوت long polling؛ ولا يلزم أن يكون متاحًا لـ SnapEX Pay إلا منفذ Webhook خلف HTTPS.
هل أنت مستعد لقبول العملات المشفرة؟
أنشئ حساب تاجر، واحصل على مفتاح API، ثم اربط الوحدة. عمولة 1% على كل دفعة، دون رسوم شهرية.