مدفوعات العملات المشفرة لـ Xboard وV2Board
إضافة دفع للوحتي Xboard وV2Board لإدارة خدمات VPN والبروكسي. عند الدفع ينتقل العميل إلى صفحة SnapEX Pay، ويدفع بـ USDT على شبكة TRC20 أو ERC20 أو BEP20 (أو بطريقة أخرى يتيحها SnapEX لهذا المبلغ)، ويُفتح الطلب تلقائيًا بعد وصول إشعار Webhook موقّع. لا محفظة ولا عقدة ولا بوابة مستضافة ذاتيًا تحتاج إلى تشغيلها؛ تصل الأموال إلى رصيد التاجر الخاص بك في SnapEX Pay.
مجانًا. الإصدار 1.2.0.
ماذا تفعل الوحدة
- إضافة أصلية لـ Xboard (تُثبَّت من مدير الإضافات في لوحة الإدارة)، إلى جانب صنف جاهز
app/Payments/SnapexPay.phpيُنسخ كما هو إلى V2Board وإصدارات Xboard الأقدم. - حساب صحيح لوحدات المبالغ: إجماليات اللوحة بالسنتات تُرسَل مبلغًا عشريًا بالدولار USD، مع سعر صرف اختياري للمتاجر التي لا تبيع بالدولار.
- إشعارات Webhook موقّعة (HMAC-SHA256، ونافذة 5 دقائق)؛ تُقرأ الفاتورة مجددًا من API في SnapEX Pay، ولا يُعلَّم الطلب مدفوعًا إلا إذا كانت حالتها paid.
- الضغط على Pay مرة أخرى يعيد استخدام الفاتورة نفسها؛ وإذا انتهت صلاحيتها تُفتح فاتورة جديدة للطلب نفسه. ولا يمكن لفاتورة تجريبية أن تفتح طلبًا أبدًا ما دامت طريقة الدفع في الوضع الفعلي.
- لا تتجاوز نافذة الدفع أبدًا مهلة الطلب في اللوحة نفسها (Xboard ساعتان، وV2Board 30 دقيقة). PHP وcURL فقط، دون أي تبعيات إضافية.
التثبيت
- Xboard: في لوحة الإدارة افتح Plugins، وارفع ملف ZIP الذي نزّلته، ثم اضغط Install، ثم Enable لتفعيل «SnapEX Pay». (أو فك ضغطه وضع المجلد في اللوحة باسم
plugins/Snapexpay/— الاسم حساس لحالة الأحرف — ثم ثبّته من Plugins.) - V2Board أو Xboard أقدم: انسخ
app/Payments/SnapexPay.phpمن الأرشيف إلى اللوحة، وأعد تشغيل PHP-FPM أو Octane إذا كنت تستخدم OPcache؛ وفي V2Board تأكّد من ضبط Site URL (app_url). - افتح Payment configuration → Add payment method واختر البوابة SnapexPay. والصق مفتاح API (بالصلاحيتين
invoices.readوinvoices.write) من لوحة تحكم SnapEX Pay. - انسخ عنوان notify URL الذي تعرضه اللوحة لهذه الطريقة، واضبطه عنوانًا لـ Webhook في لوحة تحكم SnapEX Pay (للمطورين)، والصق السر
whsec_…(يظهر مرة واحدة فقط، عند حفظ العنوان أول مرة) في حقل Webhook secret. - إذا لم تكن الأسعار بالدولار USD، فاضبط «USD per 1 shop currency» (مثلًا
0.14لـ CNY). احفظ الإعدادات وجرّب دفعة.
الإعدادات
| API key | لوحة تحكم SnapEX Pay ← مفاتيح API، بالصلاحيتين invoices.read وinvoices.write. |
|---|---|
| Webhook secret | السر whsec_… الخاص بنقطة نهاية Webhook. دون توقيع صالح لا يُعلَّم أي طلب مدفوعًا. |
| Network fee paid by | merchant: يدفع العميل إجمالي الطلب بالضبط، وتُخصم الرسوم مما تستلمه. customer: تُضاف عمولة SnapEX Pay ورسوم الشبكة إلى المبلغ. |
| Payment window, minutes | في Xboard الافتراضي 60 (الحد الأقصى 120)، وفي V2Board الافتراضي 20 (الحد الأقصى 30) — لا تتجاوز مهلة الطلب في اللوحتين. |
| USD per 1 shop currency | 1 للأسعار بالدولار USD؛ ومثلًا 0.14 لـ CNY. |
| Partner ID | اختياري: Partner ID للمُدمِج الذي أعدّ الوحدة (برنامج الإحالة في SnapEX Pay). اتركه فارغًا إذا أعددتها بنفسك. |
أسئلة
هل تعمل مع V2Board؟
نعم. يحصل Xboard على إضافة أصلية؛ أما V2Board وإصدارات Xboard الأقدم فتستخدم الصنف الجاهز app/Payments/SnapexPay.php بالإعدادات نفسها.
أسعاري باليوان CNY أو بعملة أخرى.
اضبط «USD per 1 shop currency»: يُحسب المبلغ بالصيغة total / 100 × usd_rate، ومثلًا 0.14 لـ CNY.
ماذا لو ضغط العميل Pay مرتين؟
يُعاد استخدام الفاتورة نفسها؛ وإذا انتهت صلاحيتها تُفتح فاتورة جديدة للطلب نفسه.
لماذا نافذة الدفع محدودة؟
يلغي Xboard الطلبات غير المدفوعة بعد ساعتين، وV2Board بعد 30 دقيقة، لذلك لا تتجاوز النافذة هذا الحد.
لماذا أحتاج إلى HTTPS؟
لا يرسل SnapEX Pay إشعارات Webhook إلا إلى عناوين HTTPS عامة، والطلب يُفتح عند وصول إشعار Webhook.
هل أنت مستعد لقبول العملات المشفرة؟
أنشئ حساب تاجر، واحصل على مفتاح API، ثم اربط الوحدة. عمولة 1% على كل دفعة، دون رسوم شهرية.