إضافة مجانية
بوابة دفع بالعملات الرقمية لـ WHMCS
تضيف وحدة mistKET المجانية زر «ادفع بالعملات الرقمية» إلى فواتير WHMCS. يدفع العميل في صفحة الدفع الآمنة، وتُسجَّل الدفعة على الفاتورة بعد تأكيدها.
ماذا تفعل الإضافة
- زر «ادفع بالعملات الرقمية» في فاتورة WHMCS ينقل العميل إلى صفحة الدفع.
- تُضاف المدفوعات المؤكدة إلى الفاتورة تلقائيًا، ويكون رقم المعاملة هو معرّف فاتورة mistKET.
- يتم التحقق من كل webhook بمفتاح التوقيع، وتعيد الوحدة قراءة الفاتورة من واجهة البرمجة وتتحقق من المبلغ والعملة قبل تسجيل الدفعة.
- تُسجَّل كل خطوة في Billing › Gateway Log.
التثبيت
- نزّل
mistket-whmcs.zipمن هذه الصفحة. - ارفع مجلد
modulesمن الأرشيف إلى المجلد الجذر لـ WHMCS (يُدمج مع مجلدmodulesالموجود). - في لوحة إدارة WHMCS اذهب إلى System Settings › Payment Gateways وفعّل mistKET (Crypto).
- الصق API Key وAPI Secret ومفتاح توقيع webhook من لوحة mistKET ثم احفظ.
أين تجد مفاتيحك
- في لوحة التاجر افتح API & webhook › API keys › New key وانسخ API Key وAPI Secret. يظهر المفتاح السري مرة واحدة فقط.
- في الصفحة نفسها افتح تبويب Webhook › Signing secret وانسخ المفتاح الذي يبدأ بـ
whsec_. تتحقق الإضافة به من كل إشعار. - لا تحتاج إلى إدخال عنوان webhook في اللوحة: ترسل الإضافة عنوانها مع كل فاتورة. لاختبار الاتصال، أدخله في Webhook URL واستخدم Send test notification.
يجب أن تتم الموافقة على مشروعك قبل إنشاء الفواتير. إذا كنت تستخدم قائمة عناوين IP مسموحة لواجهة البرمجة، فأضف عنوان IP الخاص بخادمك.
كيف تُعالَج حالات الدفع
confirmed · overpaid | تُضاف الدفعة إلى فاتورة WHMCS. |
|---|---|
paid | يُسجَّل: تم رصد الدفعة بانتظار التأكيدات (تبقى الفاتورة غير مدفوعة). |
underpaid | يُسجَّل مع المبلغ المستلم والمتبقي، ويمكنك قبوله من لوحة mistKET. |
expired · cancelled | يُسجَّل، ويمكن للعميل الضغط مجددًا على «ادفع بالعملات الرقمية» للحصول على دفعة جديدة. |
المتطلبات
| عملة الفاتورة | USD, EUR, TRY, RUB, GBP, AED (للعملات الأخرى استخدم «Convert To For Processing») |
|---|---|
| قاعدة البيانات | تنشئ الوحدة الجدول mod_mistket_invoices عند أول استخدام |
| Webhook | /modules/gateways/callback/mistket.php، يُرسل تلقائيًا مع كل فاتورة |
الإضافة مجانية. تُطبق العمولة القياسية على المدفوعات المؤكدة فقط. الأسعار
الأسئلة الشائعة
هل الإضافة مجانية؟
نعم، يمكنك تنزيل الإضافة واستخدامها مجانًا. تدفع فقط العمولة القياسية على المدفوعات المؤكدة، ولا توجد رسوم إعداد أو رسوم شهرية.
هل يجب أن أضبط عنوان webhook؟
لا. ترسل الإضافة عنوان webhook تلقائيًا مع كل فاتورة. ويمكنك اختياريًا إدخاله في اللوحة لإرسال إشعار تجريبي.
ما عملات الفواتير المدعومة؟
USD وEUR وTRY وRUB وGBP وAED. للعملات الأخرى استخدم خيار WHMCS «Convert To For Processing».
ماذا لو دفع العميل مبلغًا أقل؟
يُسجَّل الدفع الناقص مع المبلغ المستلم والمتبقي، ويمكنك قبول المبلغ المستلم من لوحة mistKET.
ابدأ بقبول المدفوعات بالعملات الرقمية
أنشئ حساب تاجرالتسجيل ببريدك الإلكتروني وكلمة مرور. تتم مراجعة كل مشروع قبل أن يتمكن من قبول المدفوعات.
انظر أيضًا: WooCommerce · الأسعار · التوثيق