guide

دليل دمج إضافة QuantaPay لووردبريس

شرح كامل لتثبيت وضبط إضافة QuantaPay في WooCommerce وEDD.

محدث: 11‏/1‏/2026

نظرة عامة

تتوفر الإضافة على WordPress.org وتوفر مدفوعات عملات رقمية غير وصائية. هذا الدليل يجمع المتطلبات وخطوات التكوين باللغة العربية.

المتطلبات

• ووردبريس 5.8+ وWooCommerce 6.0+ أو EDD 3.0+ مع PHP 7.4+.

• إمكانية الوصول إلى cloud.quantapay.app.

• حساب QuantaPay Cloud يحتوي على API Key وWebhook Secret.

• السماح بعنوان https://yoursite.com/wp-json/quantapay/webhook داخل WAF/Cloudflare.

التثبيت

1) حمّل أحدث ملف zip.

2) الإضافات → أضف جديدًا → رفع إضافة → quantapay-payment.zip.

3) فعّل “QuantaPay Payment” لعرض صفحة الإعدادات.

الضبط

• الإعدادات → QuantaPay: الصق API Key وWebhook Secret واحفظ الإعدادات؛ انسخ رابط الـWebhook.

• WooCommerce → الإعدادات → المدفوعات → QuantaPay: فعّل الطريقة واضبط النصوص والعملة.

• Quick Config لتعديل المحافظ وصفحة الشكر والرسائل.

• EDD → Settings → Payment Gateways → QuantaPay لتفعيلها في نماذج EDD.

الويبهوك والجدار الناري

1) في QuantaPay Cloud → Settings → Webhooks أضف الرابط القادم من ووردبريس.

2) أنشئ قاعدة في Cloudflare/WAF (Hostname + URI) للسماح أو التجاوز، ويمكن التحقق من User-Agent “QuantaPay-Webhook”.

3) تجنب وضع “I’m Under Attack” لهذا المسار حتى تصل الطلبات الموقعة أولًا.

الاختبار والدعم

• أنشئ طلبًا تجريبيًا بقيمة 1 دولار وتأكد من تحديث الحالة.

• راجع سجل wp-content/uploads/quantapay/quantapay-debug.log عند الحاجة فقط.

• روابط مفيدة: WordPress.org / QuantaPay Cloud / Docs AR

المساعدة

للمساعدة راسل [email protected].