إضافة MAGENTO

مدفوعات العملات الرقمية لـ Magento 2.

اربط متجرك بصفحة Wholly Crypto الخاصة بك. يختار العملاء شبكة ورمزًا؛ وتحدّث الإشعارات المتحقق منها الطلب.

Magento 2

v1.0.0

Magento 2.4 · PHP 8.2+ · HTTPS · InnoDB

تم الاختبار على Magento Open Source 2.4.8-p5 مع صفحة الدفع القياسية. اتبع متطلبات PHP الخاصة بإصدار Magento عندك.

بترخيص MIT · تتضمن PHP SDK · دون إعداد Composer

التثبيت

نزّل حزمة التثبيت وتحقق من SHA256SUMS. لا تستخدم ZIP الشيفرة المصدرية من GitHub.

فك ZIP في المجلد الرئيسي لـ Magento، ثم شغّل هذه الأوامر بحساب مالك ملفات متجرك. استبدل en_US برموز لغات واجهة المتجر.

php bin/magento module:enable WhollyCrypto_Payment
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f en_US
php bin/magento cache:flush

اربط متجرًا

افتح Stores → Configuration → Sales → Payment Methods → Wholly Crypto. اختر واجهة متجرك وفعّل طريقة الدفع.

أدخل أصلَي API وصفحة الدفع ومعرّفَي UUID للمشروع والمتجر ومفتاح API للقراءة والكتابة مقيدًا بالمشروع وسر توقيع IPN للمتجر. فعّل IPN في Wholly؛ وتوفر الإضافة رابط الإشعار.

اسمح بإشعارات IPN عبر جدار الحماية من دون CAPTCHA أو تسجيل دخول بالمتصفح. جرّب دفعة في متجر الاختبار قبل الإطلاق.

تبقى مفاتيح المحافظ في Wholly Crypto. لا تضيف الإضافة رسومًا نسبية؛ وتظل سياسة رصيد المعالجة الخاصة بك سارية.

اختبر مسار الدفع

تبقى المدفوعات غير المؤكدة أو الجزئية معلّقة. تحدّث الدفعة المطابقة والمسوّاة الطلب مرة واحدة. تحتاج الطلبات المدفوعة بزيادة أو المتأخرة أو غير الصالحة أو المتغيرة إلى مراجعة. العودة بالمتصفح لا تؤكد الدفع أبدًا.

يسجّل Magento فاتورة مدفوعة واحدة. ستجد معرّف فاتورة Wholly ونتيجة التحقق في Payment Information وتعليقات الطلب.

استرجع التحديثات الفائتة

يفحص cron في Magento الفواتير المحفوظة كل خمس دقائق. تقدر أيضًا تشغّل فحصًا يدويًا من مجلد متجرك.

php bin/magento whollycrypto:reconcile --limit=50
الحدود ومشكلات التسليم

لا يدعم الاسترداد التلقائي أو الخصم المتكرر أو تقسيم مدفوعات الطلب أو صفحة الدفع المضمّنة.

تحتاج Hyvä وصفحات الدفع PWA/headless وإضافات Adobe Commerce الخاصة إلى اختبارات منفصلة في بيئة تجريبية.

قد يوقف انخفاض الرصيد IPN مع بقاء الدفع متاحًا. اشحن الرصيد وأعد إرسال الإشعارات الفاشلة من سجل التسليم في Wholly.

كيف يعمل رصيد المعالجة ← · دليل IPN ←