فوترة الاستضافة

المدفوعات المشفرة لـ WISECP

اقبل العملات المشفرة على فواتير WISECP وطلباته. يختار العميل SnapEX Pay — crypto (USDT and other coins)، ويدفع في صفحة SnapEX Pay بـ USDT على TRON وEthereum وBSC وشبكات أخرى أو بعملات أخرى تُحوَّل إلى USDT، وتُعلَّم الفاتورة في WISECP مدفوعة تلقائيًا.

تنزيل الوحدة GitHub

مجانًا. الإصدار 1.0.2.

ماذا تفعل الوحدة

لا محافظ ولا عُقد تديرها: تصل الأموال إلى رصيدك كتاجر في SnapEX Pay.
تُسجَّل الدفعة عبر الـ webhook الموقّع أو فور عودة العميل من صفحة الدفع، أيهما أسبق. وفي الحالتين تُقرأ الفاتورة أولًا من جديد من واجهة SnapEX Pay البرمجية: محتوى الـ webhook وحده لا يُعلِّم شيئًا مدفوعًا، ولا تُسجَّل الدفعة مرتين أبدًا.
العميل الذي يعود قبل تأكيد الدفعة يرى صفحة حالة تتحقق كل 10 ثوانٍ وتنتقل وحدها إلى صفحة «تم الدفع بنجاح» في WISECP.
الدفعات الجزئية تُبلَّغ بحالة معلّقة (pending) مع المبلغ المستلم في ملاحظة الدفعة، لتراجعها قبل الموافقة.
وضع الاختبار: فواتير الاختبار تتأكد وحدها دون أموال حقيقية؛ وما دام الوضع مفعّلًا لا يرى زر الدفع إلا مدير مسجّل الدخول.
لا جداول إضافية في قاعدة البيانات: تحفظ الوحدة بياناتها في checkout الخاص بـ WISECP. نصوص لوحة الإدارة بالإنجليزية والتركية والروسية.
العملات: USDT ‏(TRC20 وERC20 وBEP20) لفواتير بأي مبلغ، وBTC وETH وLTC وTRX لفواتير أصغر أيضًا إذا سمحت رسوم الشبكة، والعملات الأخرى للفواتير بدءًا من ⁦$8⁩.

التثبيت

ارفع محتوى الأرشيف إلى المجلد الجذر لـ WISECP مع الحفاظ على المسار coremio/modules/Payment/SnapexPay/.
في لوحة إدارة WISECP افتح إعدادات بوابات الدفع، وابحث عن SnapEX Pay (Crypto) بين الوحدات، وفعّلها وافتح إعداداتها. في WISECP 5: ‏Payment Gateways ← أضفها في Enabled Module Selection، واحفظ، ثم افتح بطاقتها.
في لوحة التاجر في SnapEX Pay أنشئ مفتاح API بصلاحيتي invoices.read وinvoices.write والصقه في API key.
في اللوحة أضف webhook بالعنوان الظاهر تحت حقل Webhook secret (https://<موقع WISECP الخاص بك>/payment/SnapexPay/<token>/callback في WISECP 3، و…/payments/SnapexPay/<token>/callback في WISECP 5؛ انسخه من صفحة الإعدادات)، والصق السر whsec_… في Webhook secret. عبر الـ webhook تصل الدفعات حين لا يعود العميل إلى الموقع.
إن لم تكن فواتيرك بالدولار، فأبقِ USD ضمن عملات WISECP مع سعر صرف: تحوّل الوحدة المبلغ إلى الدولار بأسعار WISECP. وإن ضبطت البوابة على التحويل إلى USD، يسلّم WISECP المبلغ بالدولار ولا حاجة إلى التحويل.
فعّل Test mode، وابقَ مسجّل الدخول في لوحة الإدارة، وافتح فاتورة غير مدفوعة في منطقة العميل في المتصفح نفسه، وادفعها بطريقة اختبار في صفحة SnapEX Pay، وتحقق من أنها أصبحت مدفوعة. ثم أوقف وضع الاختبار.

الإعدادات

API key	من لوحة SnapEX Pay.
Webhook secret	`whsec_…` من إعدادات الـ webhook في اللوحة. عنوان الـ webhook ظاهر تحت الحقل.
Network fee paid by	Merchant: يدفع العميل مبلغ الفاتورة بالضبط. Client: تُضاف الرسوم فوق المبلغ.
Payment window, minutes	مدة صلاحية صفحة الدفع (1–1440، والافتراضي 60). الدفع لاحقًا يفتح صفحة جديدة.
Test mode	فواتير اختبار، للمديرين المسجّلين فقط. تُتجاهل دفعات الاختبار بعد إيقاف الوضع.
Partner ID	اختياري: ‏Partner ID للمُدمِج الذي أعدّ الوحدة (برنامج الإحالة في SnapEX Pay). اتركه فارغًا إن أعددتها بنفسك.
API URL	اتركه كما هو.

أسئلة

مع أي إصدارات WISECP تعمل؟

مع WISECP 3 وWISECP 5. فُحصت من البداية إلى النهاية في تثبيت حقيقي لـ WISECP 5.0-beta.3: الـ webhook، وعودة العميل، وwebhook متأخر بعد العودة — دفعة واحدة في كل حالة.

لماذا أضيف الـ webhook؟

إذا دفع العميل ولم يعد إلى الموقع، فالـ webhook الموقّع هو طريق وصول الدفعة إلى WISECP. وإذا عاد العميل، تُسجَّل الدفعة فورًا ولا تُسجَّل مرتين أبدًا.

فواتيري ليست بالدولار. هل تعمل؟

نعم. أبقِ USD ضمن عملات WISECP مع سعر صرف، فتحوّل الوحدة المبلغ بأسعار WISECP. أو اضبط البوابة على التحويل إلى USD، فيسلّم WISECP المبلغ بالدولار.

ماذا يظهر في WISECP عند دفع الفاتورة؟

تُبلَّغ الدفعة على أنها ناجحة، ويُعلِّم WISECP الفاتورة (أو الطلب) مدفوعة. معرّف المعاملة هو رقم فاتورة SnapEX Pay ‏(INV-…)، وتذكر ملاحظة الدفعة بماذا دفع العميل.

ماذا لو أرسل العميل أقل من مبلغ الفاتورة؟

إذا لم يُكمل العميل المبلغ في الوقت المحدد، تُبلَّغ الدفعة بحالة معلّقة (pending) مع المبلغ المستلم في الملاحظة. راجعها قبل الموافقة.

ماذا لو انتهت صلاحية صفحة الدفع دون دفع؟

لا يُسجَّل شيء، ويمكن للعميل الدفع من جديد. وإذا وصلت أموال بعد إغلاق الفاتورة، يُضاف سجل في سجل وحدات WISECP؛ والأموال في رصيدك لدى SnapEX Pay.

أين أرى ما فعلته الوحدة؟

في سجل وحدات WISECP: تُكتب فيه أخطاء الواجهة البرمجية وكل دفعة مسجّلة. لا يُكتب مفتاح API ولا سر الـ webhook في السجل أبدًا.

تكاملات أخرى

هل أنت مستعد لقبول العملات المشفرة؟

أنشئ حساب تاجر، واحصل على مفتاح API، ثم اربط الوحدة. عمولة ⁦1%⁩ على كل دفعة، دون رسوم شهرية.