مدفوعات العملات المشفرة لـ BILLmanager
اقبل العملات المشفرة في BILLmanager. يختار العميل SnapEX Pay (crypto) عند شحن الرصيد أو دفع طلب، ويدفع على صفحة SnapEX Pay بـ USDT على شبكات TRON وEthereum وBSC وغيرها، أو بعملات أخرى تُحوَّل إلى USDT، فتُضاف الدفعة في BILLmanager تلقائيًا.
مجانًا. الإصدار 1.1.0.
ماذا تفعل الوحدة
- لا محافظ ولا عُقد تحتاج إلى تشغيلها: تصل الأموال إلى رصيد التاجر الخاص بك في SnapEX Pay.
- ثلاث طرق مستقلة لإضافة الدفعة: إشعار Webhook الموقّع، وعودة العميل من صفحة الدفع، والفحص الدوري (
checkpay). ضياع إشعار Webhook لا يترك دفعة مدفوعة دون إضافة أبدًا، ولا تُضاف أي دفعة مرتين. - يُقرأ المبلغ دائمًا من جديد عبر API الخاص بـ SnapEX Pay؛ ومحتوى إشعار Webhook وحده لا يضيف شيئًا أبدًا.
- لا تُضاف الدفعات الجزئية تلقائيًا: يطلب منك السجل مراجعتها.
- وضع الاختبار: تُؤكَّد الفواتير التجريبية من تلقاء نفسها دون أموال حقيقية، ولا تُضاف أبدًا بعد إيقاف وضع الاختبار.
التثبيت
- على خادم BILLmanager، بصلاحيات root:
tar xzf snapexpay-billmanager-1.1.0.tar.gz،cd snapexpay-billmanager-1.1.0،sh install.sh. ينسخ السكربت الوحدة إلى/usr/local/mgr5، ويضيف مهمة cron لـcheckpayكل 5 دقائق (/etc/cron.d/snapexpay) احتياطًا، ثم يعيد تشغيل BILLmanager. - في لوحة تحكم التاجر في SnapEX Pay أنشئ مفتاح API بالصلاحيتين
invoices.readوinvoices.write. - BILLmanager → Provider → Payment methods → Add → SnapEX Pay (crypto). العملة: USD. الصق مفتاح API؛ وعند الحفظ يُتحقَّق منه لدى SnapEX Pay.
- Webhook (يُنصح به): في لوحة التحكم اضبط عنوان Webhook على
https://<your billing domain>/mancgi/snapexpayresult، والصق السرwhsec_…في حقل Webhook secret. - العملاء الذين يدفعون بعملات أخرى: يحوّل BILLmanager المبلغ إلى عملة طريقة الدفع (USD) بأسعار الصرف لديه، لذا أبقِ سعر USD محدَّثًا.
- اختبر أولًا: طريقة دفع منفصلة مع تفعيل Test mode، متاحة لعميل تجريبي فقط (Payment methods → القيود حسب مجموعة العملاء). ثم أوقف وضع الاختبار أو احذفها.
الإعدادات
| API key | من لوحة تحكم SnapEX Pay. |
|---|---|
| Webhook secret | whsec_… من إعدادات Webhook في لوحة التحكم. من دونه تُضاف الدفعات مع ذلك عند عودة العميل وعبر الفحص الدوري. |
| Client pays the network fee | معطّل: يدفع العميل مبلغ الدفعة بالضبط، وتُخصم الرسوم مما تستلمه. مفعّل: تُضاف عمولة SnapEX Pay ورسوم الشبكة إلى المبلغ. |
| Payment window, minutes | مدة صلاحية صفحة الدفع في SnapEX (1–1440، الافتراضي 60). فتح الدفعة مجددًا لاحقًا يُنشئ صفحة جديدة. |
| Test mode | فواتير تجريبية دون أموال حقيقية. بعد إيقاف هذا الوضع لا تُضاف الدفعات التجريبية أبدًا. |
| API URL | اتركه فارغًا. |
| Partner ID | اختياري: Partner ID للمُدمِج الذي أعدّ الوحدة (برنامج الإحالة في SnapEX Pay). اتركه فارغًا إذا أعددتها بنفسك. |
أسئلة
ما إصدارات BILLmanager المدعومة؟
BILLmanager 6، أي إصدار. لا تحتاج الوحدة إلا إلى python3 3.6+ مع المكتبة القياسية على خادم BILLmanager.
ماذا يحدث إذا لم يصل إشعار Webhook؟
تُضاف الدفعة مع ذلك عند عودة العميل من صفحة الدفع أو عبر الفحص الدوري الذي يعمل كل 5 دقائق. ولا تُضاف أي دفعة مرتين.
يدفع عملائي بالروبل أو بعملات أخرى. هل ستعمل الوحدة؟
نعم. طريقة الدفع بعملة USD، ويحوّل BILLmanager المبلغ بأسعار الصرف لديه؛ أبقِ سعر USD محدَّثًا.
ماذا لو أرسل العميل أقل من المبلغ المطلوب؟
إذا لم يُكمل العميل المبلغ في الوقت المحدد، فلا يُضاف شيء، ويُكتب في السجل «closed with a PARTIAL payment (…) - review in SnapEX Pay and credit manually».
ماذا لو لم يدفع العميل في الوقت المحدد؟
تبقى الدفعة بحالة «In payment» ليتمكن العميل من المحاولة مجددًا؛ وبعد يوم من انتهاء آخر فاتورة SnapEX تُلغى.
كيف أزيل الوحدة؟
شغّل sh install.sh --uninstall. يبقى سجل الدفعات في var/snapexpay.sqlite. وكل ما تفعله الوحدة يُسجَّل في /usr/local/mgr5/var/pmsnapexpay.log.
هل أنت مستعد لقبول العملات المشفرة؟
أنشئ حساب تاجر، واحصل على مفتاح API، ثم اربط الوحدة. عمولة 1% على كل دفعة، دون رسوم شهرية.