إضافة PRESTASHOP

مدفوعات مشفّرة لـPrestaShop.

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

احصل على الإضافة

v1.0.1

يستهدف الإصدار الأول PrestaShop 9.x وPHP 8.1+. اختُبر مع PrestaShop 9.2.0؛ اختبر القالب وصفحة الدفع في بيئة تجريبية.

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

صفحة دفع بسيطة. وطلبات متحقق منها.

  • صفحة دفع مستضافة بالأصول التي يقبلها متجرك
  • IPN موقّعة مع فحوصات API موثّقة الهوية
  • إعادة محاولات الفواتير المحفوظة وحماية من الدفع المكرر

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

التثبيت

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

whollycrypto-prestashop-1.0.1.zip

ارفع ZIP من هذه القائمة:

Modules → Module Manager → Upload a module

افتح إعدادات الوحدة. عند تعدد المتاجر، اختر متجرًا واحدًا أولًا.

Wholly Crypto → Configure

اربط متجرًا

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

استخدم HTTPS. اسمح بالإشعارات الراجعة عبر جدار الحماية دون CAPTCHA أو دخول متصفح. احفظ واختبر الاتصال، ثم أكمل دفعة تجريبية.

يفحص اختبار الاتصال الوصول إلى API، لا عملية دفع كاملة.

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

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

تعرض تفاصيل طلب PrestaShop معرّف الفاتورة. استخدم نموذج الاستعادة في الوحدة لفحص دفعة متأخرة دون إنشاء فاتورة أخرى.

الحدود ومشكلات التسليم

يدعم هذا الإصدار طلبات نقدية موجبة وصفحة دفع كاملة. لا رد أموال تلقائيًا أو خصم دوريًا. لا تُدعم سلال PrestaShop ذات الشحن المقسّم.

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

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