EN

WooCommerce

WooCommerce — تثبيت وإعداد التاجر

نظرة عامة

إضافة Sela لـ WooCommerce تربط متجرك بمنصّة دفع Sela (sela.ly) بحيث يمكنك تقديم وسائل دفع محلّية عند إتمام الشراء. تُؤكَّد الطلبات باستخدام webhook موقَّع، وليس بالاعتماد على عودة متصفّح العميل وحدها.

إصدار الدليل: 1.0.0 (متوافق مع ترويسة الإضافة).

المتطلّبات

  • WordPress: 5.0 أو أحدث.
  • WooCommerce: مُثبَّت ومُفعَّل.
  • PHP: 7.0 أو أحدث.
  • HTTPS: موصى به بشدّة للإنتاج (للمدفوعات وتسليم الـ webhooks).
  • حساب تاجر Sela: مفعَّل، ومُتاح له الوصول إلى API والبوابات.

ما تحتاجه من لوحة تحكم Sela

قبل تكوين الإضافة، جهّز التالي في لوحة تحكم التاجر في Sela:

  • Client ID و Secret ID (بيانات اعتماد التكامل / API).
  • Webhook Secret (للتحقق من تواقيع طلبات webhook الواردة).
  • فعّل بوابات الدفع التي تريد تقديمها في إعدادات بوابات Sela (إن كانت لوحتك تفصل البوابات حسب الـ alias).

خطوات التثبيت

1) الحصول على حزمة الإضافة

نزّل sela-woo.zip من المصدر الذي توفّره Sela (مثل لوحة تحكم التاجر أو منطقة المطوّرين). لا تُعد تسمية المجلّد داخل الأرشيف إذا كان التوثيق يشير إلى المسار sela-woo.

2) رفع الإضافة إلى WordPress

في wp-admin: Plugins → Add New → Upload Plugin. اختر sela-woo.zip ثم Install Now. بعد اكتمال التثبيت، اضغط Activate.

طريقة بديلة: فكّ ضغط الحزمة وارفع مجلّد sela-woo عبر FTP/SFTP إلى wp-content/plugins/، ثم فعّلها من شاشة الإضافات.

3) تأكيد WooCommerce

تأكّد من أن WooCommerce يعمل وأن إعدادات العملة والدفع في متجرك مطابقة لطريقة عملك.

التكوين والربط مع Sela

  1. اذهب إلى WooCommerce → Settings → Payments.
  2. افتح Sela (البوّابة الرئيسية).
  3. فعّل البوّابة (مثل Enable Sela).
  4. أدخل Client ID و Secret ID من لوحة Sela.
  5. البيئة:
    • Production: وضع Sandbox معطَّل — تستخدم الطلبات المسار (/pay/api/v1).
    • Sandbox: وضع Sandbox مفعَّل — تستخدم الطلبات المسار (/pay/sandbox/api/v1).
  6. انسخ Webhook URL المعروض في الإضافة وأضفه إلى إعدادات webhook/API في Sela.
  7. الصق نفس Webhook Secret من Sela في حقل الإضافة — يجب أن يطابق تماماً حتى تُتحقَّق التواقيع (X-Sela-Signature).
  8. احفظ التغييرات.

بوابات الـ Alias الاختيارية

إذا كان حسابك في Sela يُظهر بوابات alias (مثل Yasr Pay و Masrafi Pay و Sahara Pay و Banking Card لـ moamalat و Edfali)، فعّل كل طريقة مقابلة تحت Payments في WooCommerce. تبقى بيانات الاعتماد والبيئة قادمة من إعدادات بوّابة Sela الرئيسية.

كيف تُؤكَّد الطلبات

عودة العميل من صفحة الدفع ليست كافية وحدها لإنهاء الطلب بأمان. المصدر الموثوق لحالة الدفع النهائية هو webhook موقَّع من Sela؛ والإضافة مبنيّة حول هذا التدفّق.

استكشاف الأخطاء

  • طرق الدفع لا تظهر: تحقّق من أن الإضافة مفعَّلة، والطريقة ممكَّنة تحت Payments، والبوّابة مفعَّلة في Sela.
  • الطلب لا يكتمل بعد الدفع: تأكّد من تطابق Webhook Secret، وتوفّر HTTPS، وعدم وجود ما يحجب طلبات POST إلى رابط الـ webhook.
  • أخطاء Sandbox مقابل Production: تحقّق من مفتاح Sandbox في إعدادات بوّابة Sela الرئيسية.

الخصوصية والتتبّع (ملخّص)

التتبّع التشغيلي من جانب Sela محدود (مثل فحوص الاتصال، وصحة الـ webhooks، ودعم الامتثال)، حسب سياسة المنصّة. لا تُرسَل بيانات العملاء الكاملة أو حمولات الطلبات الكاملة كجزء من بيانات الصحة الاختيارية للإضافة، كما هو موصوف في سياسة/قراءة الإضافة.