ووردبريس / ووكومرس

اقبل مدفوعات العملات المشفرة على متجر WooCommerce الخاص بك باستخدام إضافة QuantaPay Payment الرسمية.

المتطلبات

• WordPress 5.8+
• WooCommerce (أي إصدار حديث)
• PHP 7.4+ (يوصى بـ PHP 8.x)
• حساب QuantaPay Cloud (cloud.quantapay.app)

التثبيت

من دليل WordPress Plugin

1. اذهب إلىالإضافات ← أضف جديدفي لوحة تحكم WordPress الخاصة بك.
2. ابحث عن"QuantaPay Payment".
3. انقر علىتثبيت الآن، ثمتفعيل.

التثبيت اليدوي

1. قم بتنزيل الإضافة منwordpress.org/plugins/quantapay-payment.
2. ارفع المجلدquantapay-paymentإلى/wp-content/plugins/.
3. قم بتفعيل الإضافة فيالإضافات ← الإضافات المثبتة.

الإعداد

الخطوة 1: احصل على بيانات الاعتماد الخاصة بك

من لوحة تحكم QuantaPay Cloud الخاصة بك:

1. مفتاح API— موجود فيالإعدادات ← الحساب
2. مفتاح Webhook السري— موجود فيالإعدادات ← المدفوعات ← Webhook

الخطوة 2: أدخل بيانات الاعتماد في WordPress

1. انتقل إلى قائمةQuantaPayفي الشريط الجانبي WordPress الخاص بك.
2. الصقمفتاح واجهة برمجة تطبيقات السحابة (Cloud API Key)ومفتاح Webhook السري.
3. حفظ الإعدادات.

الخطوة 3: تكوين عنوان URL لـ Webhook

1. تنشئ الإضافة عنوان URL لـ webhook:https://yoursite.com/wp-json/quantapay/webhook
2. انسخ عنوان URL هذا والصقه فيCloud → Settings → Payments → Webhook URL.

الخطوة 4: تمكين البوابة

اذهب إلىWooCommerce → Settings → Payments → QuantaPayوقم بتمكينها.

إعدادات WooCommerce

تضيف الإضافة إعدادات مباشرة في صفحة مدفوعات WooCommerce:

تهيئة سريعة

توفر قائمةQuantaPayالشريط الجانبي علامة تبويب "تهيئة سريعة" حيث يمكنك إدارة:

• عناوين المحفظة
• العملة الافتراضية
• عنوان URL لإعادة التوجيه لصفحة الشكر
• نسخة/رسائل صفحة الدفع

تتم مزامنة التغييرات التي يتم إجراؤها هنا مع إعدادات QuantaPay Cloud الخاصة بك.

دعم حظر الدفع

تدعم الإضافة بشكل كامل WooCommerce Block Checkout (صفحة الدفع الجديدة المستندة إلى React). تشترك كل من صفحة الدفع الكلاسيكية و Block في نفس التكوين وتعرضان شريط أيقونات العملات المشفرة (BTC و ETH و USDT و USDC و BNB).

مسار الدفع

1. يختار العميل "ادفع بالعملات المشفرة" عند الدفع.
2. يقوم WooCommerce بإنشاء الطلب واستدعاء QuantaPay Checkout Session API.
3. يتم إعادة توجيه العميل إلى صفحة الدفع الخاصة بـ QuantaPay.
4. يختار العميل العملة المشفرة، ويقوم بمسح رمز QR، ويرسل الدفعة.
5. بعد تأكيد blockchain، ترسل QuantaPay إشعار webhook إلى موقع WordPress الخاص بك.
6. يقوم المكوّن الإضافي بتحديث حالة طلب WooCommerce إلى "قيد المعالجة" أو "مكتمل".
7. يتم إعادة توجيه العميل إلى صفحة الشكر الخاصة بـ WooCommerce.

مزامنة لوحة التحكم

من صفحة إدارة QuantaPay في WordPress، يمكنك:

• عرض أرصدة محفظتك
• تصفح أحدث 100 معاملة
• التحقق من سجلات التصحيح
• الاطلاع على إشعارات الدفعات الناقصة والفواتير منتهية الصلاحية

الأمان

• يتم التحقق من Webhooks باستخدام توقيع المفتاح السري المشترك.
• يتم تشفير الإعدادات الحساسة (مفاتيح API) في حالة السكون.
• تحمي توقيعات HMAC-SHA256 إنشاء جلسة الدفع من العبث.
• تقوم سجلات التصحيح تلقائيًا بتنقيح الأسرار.

تهيئة Cloudflare / WAF

إذا كان موقعك خلف Cloudflare أو WAF آخر، فاسمح لنقطة نهاية webhook:

1. قم بإنشاء قاعدة Firewall/WAF مطابقةURI يحتوي على /wp-json/quantapay.
2. اضبط الإجراء علىسماحأوتجاوز الأمان.
3. تأكد من أن مستوى الأمان ليس مضبوطًا على "أنا تحت الهجوم" لهذا URL.

اللغات المدعومة

يأتي المكوّن الإضافي مع ترجمات لـ 9 لغات:

• الإنجليزية والصينية (المبسطة) والإسبانية والبرتغالية (البرازيلية) والروسية والفرنسية واليابانية والكورية والألمانية

التسعير

تفرض QuantaPay رسومًا ثابتة قدرها0.8٪ لكل دفعة عملات مشفرة ناجحة. لا توجد رسوم شهرية أو رسوم سحب.