ربط تمارا بـWooCommerce: الإعداد وCapture والاسترداد

قد يصل طلب تمارا إلى WooCommerce وتبدأ تجهيزه، بينما خطوة التحصيل لم تنفذ بعد. لذلك يجب أن تعرف ماذا تفعل حالة الطلب، ومتى تُرسل الإضافة حدث Capture، قبل أن يعتمد فريقك على الربط.

يشرح هذا الدليل التكامل المباشر عبر إضافة Tamara Checkout: التثبيت، وبيانات Sandbox وLive، والرسائل الترويجية، ودورة الطلب والاختبار. لا تنقل هذه الخطوات حرفيًا إلى تمارا المفعلة من خلال مزود دفع وسيط؛ جهة إدارة العملية والاسترداد قد تختلف. المراجعة بتاريخ 12 أكتوبر 2026 وفق التوثيق الرسمي، دون تنفيذ معاملة على حساب تاجر ضمن المقال.

قبل الإعداد: احسم مسؤولية الطلب

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

راجع نوع Checkout وإضافات تغيير حالاته، خاصة إذا كان لديك ربط مع نظام مخزون أو شحن يحدّث الطلب آليًا. اكتب الحالات الحالية قبل التعديل، وخذ نسخة احتياطية، واستخدم Staging لاختبار أثر الإعدادات بعيدًا عن الطلبات الحقيقية.

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

تثبيت Tamara Checkout

1. افتح «إضافات ← أضف جديدًا» وابحث عن Tamara Checkout وفق دليل التثبيت الرسمي.
2. طابق رابط الإضافة والمطور مع الدليل، ثم ثبتها وفعّلها. ويمكن رفع ZIP الذي يربط إليه المصدر الرسمي.
3. اذهب إلى WooCommerce ← Settings ← Payments وافتح Manage أمام Tamara Gateway.
4. راجع بيانات الاتصال قبل تمكينها أمام العملاء؛ التفعيل وحده لا يكمل الإعداد.

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

بيانات Sandbox وLive: لا تخلط البيئتين

من إعدادات Tamara Gateway اختر Working Mode المناسب. تستخدم Sandbox للاختبار وLive بعد الحصول على بيانات التشغيل وموافقة فريق تمارا. يحدد التوثيق عنوان الاختبار https://api-sandbox.tamara.co وعنوان التشغيل https://api.tamara.co.

أدخل API (Merchant) Token وNotification Token للبيئة نفسها. Public Key مطلوب لرسائل المنتج والسلة وCheckout. راجع كل حقل قبل الحفظ؛ تحذر الوثائق من أن بيانات غير صحيحة قد تؤدي إلى تعطيل الإضافة وإظهار خطأ.

وجود اسم «Public» لا يجعل باقي التوكنات عامة. لا ترسل Merchant Token أو Notification Token داخل رسالة دعم مكشوفة، ولا تضفهما إلى كود الواجهة. وثّق أسماء الإعدادات دون قيم الأسرار.

اعرض رسائل تمارا في المكان المناسب

توضح وثائق WooCommerce لدى تمارا إعداد PDP Widget Position داخل إعدادات الإضافة لتحديد موضع رسالة المنتج، مع إمكانية تخصيص موضع الرسائل في الصفحات المناسبة. اتبع خيارات نسختك بدل تثبيت رسالة نصية لا تتحدث مع السعر.

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

لا تعتبر ظهور Widget إثباتًا لاكتمال تكامل الدفع. اختبر اختيار تمارا في Checkout والانتقال والعودة وحالة الطلب بشكل منفصل. وإذا اختلف العرض بين العربية والإنجليزية، افحص إعدادات اللغة والمحاذاة قبل إضافة CSS عام يؤثر في بقية المتجر.

افهم Authorised وCaptured قبل تغيير الحالات

وفق دليل إدارة الطلبات، يرتبط Processing افتراضيًا بمرحلة Authorised، بينما تؤدي حالة الشحن أو الاكتمال المضبوطة كمحفز إلى Capture. التعيين قابل للتخصيص؛ راجع ما هو مضبوط في متجرك بدل افتراض أن الاسم وحده يثبت إرسال الحدث.

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

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

عمليًا، اختبر هذا المسار مع من سيدير الطلبات يوميًا. قد يعمل الربط تقنيًا ثم يتعطل التشغيل لأن الموظف يستخدم حالة لا تطلق الحدث المتفق عليه. وثيقة تسليم من صفحة واحدة تمنع هذا النوع من الالتباس.

ضبط الأحداث وWebhooks

تتيح الإعدادات المتقدمة Order Statuses Mappings لتحديد انعكاس أحداث تمارا على حالات WooCommerce، وOrder Statuses Trigger لاختيار الحالة التي تستدعي الإلغاء أو Capture. كما يشرح الدليل Enable Webhook للتعامل مع الطلبات المرفوضة والمنتهية.

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

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

اختبار تمارا قبل استقبال العملاء

ابدأ بدليل Testing Guide للسوق المناسب. يوفر دليل السعودية خطوات Sandbox للهاتف والتحقق التجريبي والبطاقة. استخدم بيانات وإجراءات بيئة الاختبار الرسمية، ولا تطلب هوية عميل حقيقية لتنفيذ اختبار تطوير.

هذه معايير قبول مقترحة تُنفذ بالسيناريوهات المتاحة لبيئة حسابك. سجّل رقم الطلب ومعرّف تمارا والوقت والنتيجة، واختبر الهاتف والقسائم والشحن. لا تستخدم عبارة «اختبرنا الدفع» إذا كان ما تم فقط هو فتح صفحة الخدمة.

الإلغاء والاسترداد: تجنب الإجراء المكرر

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

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

متى تنتقل إلى Live؟

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

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

أسئلة عن ربط تمارا

هل Processing تعني أن التسوية اكتملت؟

لا تخلط بين حالة WooCommerce وحالة العملية لدى مزود الدفع. راجع التفويض والتحصيل وفق التعيين المستخدم، ثم تابع التسوية من حساب التاجر.

هل أستخدم خطوات تمارا نفسها مع تابي؟

لا؛ راجع دليل ربط تابي. تشابه تجربة العميل لا يعني تطابق الحقول أو محفزات الحالات.

هل أحتاج تمارا بدل ميسر؟

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

لو محتاج إعداد الربط أو مراجعة طلبات لا تصل إلى Capture، أرسل نوع Checkout وطريقة تحديث حالات الشحن ووصف المشكلة عبر صفحة التواصل. نحدد ما يحتاج مراجعة قبل تعديل دورة الطلب.

حسام حامد

Web Developer

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