إضافات SHOPWARE

مدفوعات العملات الرقمية لـ Shopware 5 و6.

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

Shopware 5

v1.0.0

Shopware 5.7.20+ (5.7.x) · PHP 7.4+ · HTTPS · InnoDB

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

Shopware 6

v1.0.0

Shopware 6.7 · PHP 8.2+ · HTTPS · InnoDB

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

التثبيت

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

Shopware 5

whollycrypto-shopware5-1.0.0.zip

Configuration → Plugin Manager → Installed → Upload plugin

Shopware 6

whollycrypto-shopware6-1.0.0.zip

Extensions → My extensions → Upload extension

ثبّت الإضافة وفعّلها، ثم افتح إعداداتها لمتجرك الفرعي أو قناة البيع.

فعّل Wholly Crypto ضمن طرق الدفع في متجرك. في Shopware 6، أضفه أيضًا إلى قناة البيع.

اربط متجرًا

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

أدخل أيضًا رابط HTTPS العام لمتجرك، مع أي مجلد فرعي للغة أو التثبيت.

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

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

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

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

ستجد تفاصيل الفاتورة في التعليق الداخلي للطلب في Shopware 5، أو في حقول Wholly Crypto المخصصة للطلب في Shopware 6.

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

شغّل هذا الأمر من مجلد متجرك لفحص الفواتير المحفوظة من دون إنشاء نسخ مكررة. يمكنك جدولته كل خمس دقائق.

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

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

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

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