ربط ميسر بـWooCommerce: الإعداد والاختبار وحل مشاكل الدفع

العميل يرى عملية ناجحة، لكن الطلب ما زال معلّقًا. هذه هي اللحظة التي تكشف الفرق بين إضافة وسيلة دفع وربطها بطريقة يعتمد عليها المتجر.

ربط ميسر بـWooCommerce يمر بأربع نقاط: تثبيت الإضافة الرسمية، إدخال مفاتيح البيئة الصحيحة، إعداد إشعارات الدفع Webhooks، ثم اختبار العملية وحالة الطلب. هذا شرح للتكامل المباشر عبر إضافة Moyasar، مبني على الوثائق الرسمية المتاحة بتاريخ 12 أكتوبر 2026؛ لم يُجرَ اختبار على حساب تاجر فعلي ضمن إعداد المقال.

ما الذي تجهّزه قبل تثبيت ميسر؟

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

• نسخة احتياطية للملفات وقاعدة البيانات وبيئة Staging لتجربة التغييرات.
• WordPress وWooCommerce وإصدار PHP مدعوم ومتوافق، مع مراجعة متطلبات الإضافة الحالية.
• HTTPS صالح على الدومين الذي سيستخدمه العميل.
• صفحة Checkout تعمل قبل إضافة ميسر، مع معرفة هل تستخدم Blocks أم الواجهة التقليدية.
• قائمة بإضافات الكاش والحماية وتخصيص الدفع التي قد تؤثر في الربط.

توثيق التثبيت وقت المراجعة يعرض سلسلة الإضافة 8.0.4. استخدم ذلك لفهم سياق الشرح، ثم تحقق من الإصدار المتاح لك. الحد الأدنى الذي تسمح به إضافة ليس توصية بالبقاء على إصدار PHP قديم.

تثبيت الإضافة الرسمية

1. من لوحة WordPress افتح «إضافات ← أضف جديدًا» وابحث عن Moyasar.
2. تحقق من أن المطور هو Moyasar، وطابقها مع صفحة الإضافة الرسمية.
3. ثبت الإضافة وفعّلها، ثم افتح إعداداتها من تبويب Payments داخل إعدادات WooCommerce.

إذا كان المتجر يستخدم ربطًا قديمًا أو إضافة أخرى لميسر، سجّل طريقة عملها والطلبات التي تعتمد عليها قبل الاستبدال. اختبر الترحيل على النسخة التجريبية، ولا تفعّل بوابتين تحملان الاسم نفسه للعميل دون سبب واضح.

إعداد المفاتيح وWebhooks

من لوحة ميسر افتح Settings ثم API Keys. داخل إعدادات الإضافة فعّل Test Mode للاختبار، وضع Publishable Key وSecret Key التجريبيين في حقولهما. مفاتيح pk_test_… وsk_test_… للاختبار، وpk_live_… وsk_live_… للتشغيل الفعلي. احفظ التغييرات.

للإشعارات، انسخ Webhook URL وSecret اللذين تعرضهما الإضافة. في لوحة ميسر افتح Settings ثم Webhooks وأضف نقطة الاستقبال، مع All Events وطريقة POST وفق دليلها. انسخ رابط متجرك المعروض فعلًا؛ لا تستخدم رابط المثال الموجود في أي شرح.

راجع تعيين حالات الطلب: يذكر التوثيق Processing كافتراضي للنجاح، وFailed للفشل. لا تغيّر نجاح الدفع إلى Completed لمجرد الرغبة في إنهاء الطلب إذا كان فريقك ما زال يحتاج تجهيز المنتج وشحنه.

المفتاح السري يبقى في إعدادات الربط المخصصة له. لا تضعه داخل JavaScript أو صفحة عامة أو لقطة شاشة للدعم. عند توثيق الاختبار احتفظ بمعرّف العملية، لا ببيانات الدفع الحساسة.

تفعيل وسائل الدفع وApple Pay

فعّل الوسائل المطلوبة من إعدادات الدفع، ثم راجع إعداد كل وسيلة. توثيق ميسر يشرح البطاقات وApple Pay وSTC Pay وSamsung Pay، ويعرض خيار Moyasar Invoice للدفع عبر صفحة مستضافة. اختر ما يناسب حسابك وتجربة العميل، ولا تفترض أن جميع الخيارات ستظهر لكل جهاز.

Apple Pay يحتاج HTTPS والتحقق من الدومين. اتبع إعداد Domain Verification في الإضافة وتأكد من إمكانية الوصول إلى ملف الربط المطلوب داخل مسار /.well-known/. وجود الزر على جهاز واحد لا يكفي؛ اختبر على جهاز وبيئة دفع مدعومين. اختبار Apple Pay له متطلبات مستقلة، فلا تطبّق عليه أرقام بطاقات اختبار النموذج العادي.

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

اختبار الدفع: ماذا يجب أن تسجّل؟

استخدم بطاقات الاختبار الرسمية مع مفاتيح Test. تحتوي الوثيقة على حالات قبول ورفض وأخطاء تحقق. اختر حالة معروفة بدل إدخال رقم عشوائي ثم اعتبار الفشل خللًا في المتجر.

هذه قائمة قبول مقترحة للمشروع، وليست نتائج اختبارات أجريتها هنا. سجّل رقم الطلب ومعرّف الدفع والوقت والنتيجة، ثم كرر المسار على الهاتف. إذا أغلقت التبويب في توقيت مبكر، راجع الحالة الفعلية أولًا؛ لا تفترض أن العملية اكتملت أو فشلت بناءً على اختفاء الصفحة.

أخطاء شائعة وكيف تضيق دائرة البحث

يمكن تفعيل Debug Log من إعدادات الوسيلة ومراجعة السجل عبر WooCommerce ← Status ← Logs بحسب التوثيق. أعد إنتاج محاولة واحدة معروفة ثم اربطها بمعرّف الطلب. لا تعطل حماية الموقع بالكامل لحل اتصال؛ حدّد الطلب المحجوب والقاعدة المسببة.

الانتقال من Test إلى Live

بعد اكتمال تفعيل حسابك واعتماد الاختبارات، ضع مفاتيح Live في حقولها وأوقف Test Mode. تحقق من إعداد إشعارات بيئة التشغيل، وامسح الكاش المرتبط بالواجهة، ثم راجع ظهور الوسائل على الدومين النهائي. أي تجربة مالية حقيقية تكون مقصودة ومعلومة لصاحب المتجر، مع مراجعة سياسة الاسترداد والرسوم.

سلّم فريق التشغيل ورقة قصيرة توضّح كيف يطابق رقم الطلب بمعرّف الدفع، ومن يتابع الطلبات المعلقة، وكيف يراجع الاسترداد. لا تعتبر تغيير كلمة في حالة الطلب إثباتًا لتحويل الأموال؛ راجع سجل البوابة نفسه.

أسئلة عن ربط ميسر

هل ميسر بديل لتابي وتمارا؟

تختلف طبيعة وسائل الدفع التي يقدمها كل تكامل. يمكنك دراسة ميسر لتحصيل المدفوعات، وتابي أو تمارا لخيارات الدفع المتاحة عبرهما، وفق عقود نشاطك وأهليته. لا توجد ضرورة تقنية عامة لاختيار اسم واحد لكل المتاجر.

كم تكلفة الربط ورسوم العمليات؟

افصل تكلفة تنفيذ الموقع عن رسوم مزود الدفع. اطلب عرضًا حديثًا لحساب نشاطك يتضمن المعاملات والتسوية والاسترداد؛ لا تعتمد على نسبة غير مؤرخة في مقال.

هل تسريع Checkout يعني تفعيل الكاش عليه؟

لا تستخدم كاش صفحات مشتركًا لبيانات الدفع والسلة. شخّص التأخير في السكربتات والطلبات والخادم؛ يوضح دليل تسريع WordPress نقطة البداية.

تحتاج تنفيذ الربط؟ أرسل بلد النشاط والعملة ورابط المتجر ونوع صفحة الدفع ووسائل الدفع المطلوبة عبر صفحة التواصل. هذه المعلومات تحدد نطاق العمل قبل طلب صلاحيات التنفيذ.

حسام حامد

Web Developer

ناقش مشروعك معي