نظرة عامة

إضافة QuantaPay Payment علىWordPress.orgتضيف بوابة عملات رقمية غير احتجازية إلى WooCommerce (الدفع الكلاسيكي، Blocks، HPOS) و Easy Digital Downloads. استخدم هذا المستند للاحتفاظ بكل خطوة في مكان واحد بدلاً من التنقل بين ملفات الأسئلة الشائعة/ملفات Readme.

المتطلبات

• WordPress 5.8+ مع WooCommerce 6.0+ أو EDD 3.0+، PHP 7.4+ (يوصى بـ 8.x).

• وصول HTTPS صادر إلى cloud.quantapay.app للتحقق من API + Webhook.

• مساحة عمل QuantaPay Cloud نشطة مع مفتاح API وسر Webhook.

• القدرة على السماح بالطلبات إلى https://yoursite.com/wp-json/quantapay/webhook من خلال WAF/Cloudflare.

تثبيت الإضافة

1) قم بتنزيل أحدث ملف zip من WordPress.org أو الإصدار الداخلي الخاص بك.

2) في إدارة WordPress، انتقل إلى Plugins → Add New → Upload Plugin وقم بتحميل quantapay-payment.zip.

3) قم بتنشيط "QuantaPay Payment". تظهر شاشة جديدة للإعدادات ← QuantaPay لبيانات الاعتماد.

تكوين بيانات الاعتماد والدفع

• افتحSettings → QuantaPayوالصق مفتاح Cloud API + سر Webhook، ثم احفظ. تعرض الصفحة عنوان URL لـ Webhook الذي تم إنشاؤه (https://yourdomain.com/wp-json/quantapay/webhook).

• WooCommerce: انتقل إلىWooCommerce → Settings → Payments → QuantaPay(أو Payments → Manage في واجهة المستخدم الجديدة) وقم بتبديل "Enable". اختر عنوان/وصف الدفع والعملة الافتراضية.

• التكوين السريع: لا تزال تحت Settings → QuantaPay، يمكنك مزامنة عناوين المحفظة وإعادة توجيه صفحة الشكر ونسخة الدفع المترجمة وتفضيل التسجيل دون تعديل PHP.

• Easy Digital Downloads: قم بتمكين البوابة ضمنDownloads → Settings → Payment Gateways → QuantaPayلعرضها في نماذج الدفع EDD.

قائمة التحقق من Webhook والجدار الناري

1) في QuantaPay Cloud، انتقل إلى Settings → Webhooks والصق نقطة نهاية WordPress المعروضة في الإضافة. انقر فوق "Verify Secret" لتخزين التوقيع.

2) إذا كنت تستخدم Cloudflare أو WAF آخر، فقم بإنشاء قاعدة: اسم المضيف يساوي yourdomain.com و URI يحتوي على /wp-json/quantapay، الإجراء Allow/Bypass. اختياريًا، قم بالتصفية بواسطة وكيل مستخدم QuantaPay-Webhook أو رأس التوقيع.

3) حافظ على خروج الموقع من وضع "أنا تحت الهجوم" لنقطة النهاية هذه حتى تصل عمليات الاسترجاع الموقعة إلى WordPress قبل أن تتحقق الإضافة منها.

الاختبار واستكشاف الأخطاء وإصلاحها

• ضع طلب اختبار بقيمة 1 دولار في WooCommerce أو EDD واختر QuantaPay. تأكد من أن الصفحة المستضافة تعرض نفس العملة والمبلغ.

• في QuantaPay Cloud، ضع علامة على الفاتورة على أنها مدفوعة أو أرسل تحويل عملة رقمية حقيقي؛ يجب أن ينقل WordPress الطلب من معلق إلى قيد المعالجة/مكتمل مع تجزئة blockchain المخزنة في ملاحظات الطلب.

• إذا لم يتم تحديث الطلبات، فتحقق من مفتاح Cloud API/سر Webhook، وتأكد من أن Cloudflare يسمح بنقطة النهاية، وراجع wp-content/uploads/quantapay/quantapay-debug.log (قم فقط بتمكين التسجيل أثناء الاختبار؛ يتم تنقيح الأسرار).

• استخدم الزر "Test Cloud API" داخل Settings → QuantaPay لتأكيد بيانات الاعتماد وتحديث لقطات المحفظة دون إنشاء طلب جديد.

الإزالة أو إعادة التثبيت

يؤدي إلغاء تنشيط الإضافة إلى الاحتفاظ بالتكوين لوقت لاحق. يؤدي اختيار حذف إلى إزالة الخيارات المخزنة وتفضيلات التسجيل ولكنه لا يمس أبدًا طلبات WooCommerce أو EDD. قم دائمًا بعمل نسخة احتياطية قبل استبدال الموصل في الإنتاج.

روابط مفيدة

•التنزيل / سجل التغييرات على WordPress.org

•لوحة معلومات QuantaPay Cloud

•فهرس المستندات

• الدعم:[email protected]

هل تحتاج إلى مساعدة؟

هل تحتاج إلى مساعدة؟ راسل[email protected]وقم بذكر عنوان URL للموقع بالإضافة إلى رقم التعريف الخاص بالطلب.