وجود تابي في صفحة المنتج لا يعني أن العميل يستطيع استخدامها عند الدفع. قد تكون الرسالة الترويجية مفعلة وحدها، أو لا تتطابق دولة الشحن مع العملة، أو لم يكتمل إعداد حساب التاجر.
لربط تابي بـWooCommerce تحتاج إضافة Tabby Checkout، ومفاتيح حسابك، وتفعيل وسيلة الدفع، ثم مراجعة البلد والعملة ومسار الاختبار المناسب. يركز هذا المقال على الإضافة الرسمية، مع توضيح ما يحتاج فحصًا داخل متجرك. تمت مراجعة الوثائق في 12 أكتوبر 2026، ولم تُنفذ معاملة على حساب تاجر ضمن إعداد المقال.
هل تابي مناسبة لمتجرك قبل أن تبدأ الربط؟
راجع أهلية النشاط وتفعيل حساب التاجر مع تابي أولًا. تثبيت الإضافة ليس موافقة على النشاط أو على كل طلب عميل. كذلك لا تضع نصًا ثابتًا يعد بعدد أقساط أو قبول مضمون لكل شخص؛ اعرض الرسائل الرسمية التي تتوافق مع حسابك والسوق الذي تستهدفه.
جهّز وصفًا لرحلة الشراء: البلد، العملة، نوع المنتج، طريقة الشحن، وهل تبيع إلى أكثر من دولة. في المتجر متعدد العملات، سعر العرض ليس وحده المهم؛ المطلوب اتساق العملة عند إتمام الطلب والمبلغ الذي يستقبله التكامل.
- خذ نسخة احتياطية وحدد بيئة لا تستقبل طلبات حقيقية لتجربة التعديلات.
- سجّل إصدارات WordPress وWooCommerce والقالب وإضافة تابي.
- حدد هل Checkout مبني بـBlocks أو الواجهة التقليدية أو تخصيص خارجي.
- اختبر السلة والعنوان والشحن قبل إدخال وسيلة الدفع الجديدة.
تعرض صفحة الإضافة وقت المراجعة الإصدار 5.16.1. اختلاف الإصدار قد يغير شكل الإعدادات؛ افتح سجل التغييرات إذا اختلفت الواجهة التي تراها عن الدليل.
تثبيت Tabby Checkout وإدخال المفاتيح
احصل على Tabby Checkout من المطور tabbyai. يمكنك تثبيتها من دليل الإضافات أو رفع ملف ZIP الرسمي من «إضافات ← أضف جديدًا ← رفع إضافة»، ثم تفعيلها.
بحسب دليل WooCommerce لدى تابي، تدخل Public API Key وSecret API Key في WooCommerce ← Settings ← Tabby API، ثم تفعّل وسيلة تابي من تبويب Payments. راجع أيضًا Allowed Countries، واجعل Plugin mode على Payment gateway إذا كنت تريد استقبال الدفع.
وضع Promo only يعرض رسائل المنتج والسلة دون إضافة تابي كوسيلة في Checkout. راجع تطابق الدولة والعملة؛ يذكر الدليل السعودية مع SAR والإمارات مع AED. لا تفترض أن اختيار العملة وحده يضيف دعم سوق غير متاح لحسابك.
احتفظ بالمفتاح السري داخل إعدادات التكامل. إذا احتجت إرسال لقطة شاشة للدعم، أخفِ المفاتيح وبيانات العملاء. يُفضّل أن يحتوي توثيق الإعداد على أسماء الحقول وحالة تفعيلها دون نسخ أسرار الحساب.
Test وLive: اختر اختبارًا يناسب المفاتيح
توضح صفحة Testing Credentials أن بيانات الاختبار تعمل مع مفاتيح Test فقط؛ لا تكتمل بها عملية نجاح على مفاتيح Live. بعض التكاملات تتلقى مفاتيح تجريبية وبعضها يبدأ بمفاتيح تشغيل وفق إعداد الحساب. تأكد من المسار الذي وفرته لك تابي.
دليل إضافة WooCommerce يعرض فحصًا على مفاتيح Production: الوصول إلى صفحة تابي ببيانات اختبار ثم العودة للمتجر، دون إكمال دفعة تجريبية. هذا يفحص الانتقال والعودة، وليس إثباتًا لتحصيل عملية كاملة. اطلب مفاتيح Test من فريق تابي إذا احتجت اختبار النجاح التجريبي الكامل.
في بيئة Test، استخدم البريد والهاتف وحالات القبول والرفض من صفحة بيانات الاختبار الرسمية حسب البلد. تجنب استبدالها ببيانات عميل حقيقي أثناء الاختبار.
راجع رحلة العميل، لا شاشة النجاح فقط
جهّز جدول قبول للمشروع وسجّل نتيجة كل مسار. الغرض أن تعرف ما الذي جرى التحقق منه فعلًا؛ نجاح التحويل إلى الخدمة لا يغطي الفشل والعودة وحالة الطلب.
| حالة المراجعة | ما الذي تبحث عنه؟ |
|---|---|
| ظهور الرسالة الترويجية | مكان واضح وسعر يتحدث مع تغير المنتج أو السلة |
| الانتقال من Checkout | المبلغ والعملة والعنوان صحيحون، وصفحة تابي تفتح |
| العودة دون إكمال | المتجر يسمح باستكمال الشراء ولا يعرض نجاحًا غير صحيح |
| طلب مع قسيمة وشحن | الإجمالي المعتمد يطابق إجمالي الطلب لدى التكامل |
| هاتف بشاشة صغيرة | الحقول والأزرار ورسائل الحالة واضحة ويمكن استخدامها |
اختبر تغيير المنتج المتغير والكمية والعنوان، ثم راقب إن كانت رسالة الدفع تتحدث. لا تكتفِ بصفحة مخزنة أو بحساب المدير؛ افتح جلسة زائر أيضًا. هذه مراجعات مقترحة لتجربة المتجر، وليست إعلانًا بأن الإضافة اجتازت الاختبار على كل قالب.
الفرق بين تأكيد العميل والتحصيل Capture
يوضح توثيق تابي أن إعادة توجيه العميل إلى رابط النجاح لا تكفي لإثبات حالة الدفع. التحقق الفعلي يكون من جهة الخادم، وتأتي مرحلة Capture بعد التفويض. المقصود هنا فهم دورة العملية عند مراجعة الإضافة؛ لا تحتاج إلى بناء تكامل API جديد فوقها لمجرد اتباع هذا الشرح.
في المراجعة التشغيلية، طابق الطلب مع عملية تابي، وتحقق من المبلغ المحصل، لا من عنوان صفحة الشكر وحده. يذكر توثيق المعالجة أن العمليات المحصلة هي التي تدخل التسوية. إذا بقيت العملية مفوضة دون تحصيل متوقع، راجع السجل وفريق الدعم قبل تكرار أي إجراء يدوي.
الاسترداد أيضًا يحتاج مطابقة بين سجل المتجر وسجل الخدمة. لا تعتبر تغيير حالة طلب محلي دليلًا كافيًا على تنفيذ Refund. وثّق مع الفريق المسار المعتمد في نسخة الإضافة وحسابك، ومن يملك صلاحية استخدامه.
لماذا لا تظهر تابي في Checkout؟
ابدأ بمراجعة الإعدادات السابقة: تفعيل وسيلة الدفع، وضع Payment gateway، Allowed Countries، واتساق البلد والعملة. إذا كانت صحيحة، سجّل أين تختفي الوسيلة: قبل ملء العنوان أم بعده؟ على كل المنتجات أم منتج محدد؟ للزائر أم للحساب المسجل؟
افتح Console وNetwork لتحديد الخطأ الظاهر بدل تعديل CSS عشوائيًا. جرّب عزل تخصيصات Checkout والكاش على نسخة Staging، وراجع التوافق مع نوع صفحة الدفع. الخطأ المرئي قد يكون في الواجهة، بينما الاستجابة من التكامل تحمل سببًا مختلفًا.
إذا كانت الخدمة لا توافق على شراء معيّن، فلا تحاول تجاوز القرار بإخفاء الرسالة أو تعديل بيانات العميل. اعرض طريقة دفع بديلة واضحة. نجاح الربط لا يعني أن كل معاملة ستُقبل.
ما الذي تسلّمه لفريق تشغيل المتجر؟
اجعل التسليم قابلًا للاستخدام: اسم الإضافة وإصدارها، نوع المفاتيح المفعلة، الدول والعملات التي راجعتها، ونتائج الاختبارات. أضف طريقة مطابقة الطلب بالعملية، والخطوات المتفق عليها عند تأخر الحالة أو طلب الاسترداد.
مع أي مشكلة، جهّز رقم الطلب ومعرّف العملية ووقت حدوثها ووصف إعادة إنتاجها. لقطة عامة لعبارة «لا يعمل» لا تساعد بقدر سجل واضح. احتفظ بنسخة من الإعدادات غير الحساسة لتعرف ما تغير بعد تحديث أو تعديل جديد.
أسئلة قبل إطلاق تابي
هل أستطيع الجمع بين تابي وميسر؟
يمكن دراسة أكثر من وسيلة لتغطية احتياجات مختلفة، بعد مراجعة أهلية الحساب والتوافق وتجربة Checkout. راجع دليل ربط ميسر، ثم اختبر ترتيب الوسائل ورسائلها معًا داخل المتجر.
هل تابي وتمارا لهما خطوات الإعداد نفسها؟
لا. لكل خدمة مفاتيح وإعدادات ودورة معالجة موثقة. اقرأ دليل تمارا ومرحلة Capture بدل نقل إعدادات خدمة إلى الأخرى.
هل إضافة الشعار ترفع التحويل تلقائيًا؟
لا توجد نتيجة مضمونة لكل متجر. بعد التشغيل، قِس بدء الدفع واكتماله والأخطاء لكل وسيلة، وقارن فترات وسيناريوهات متشابهة. وجود اختيار إضافي يفيد حين يعمل بوضوح ويلائم عملاءك.
لربط تابي أو مراجعة مشكلة في صفحة الدفع، أرسل رابط المتجر والبلد والعملة ونوع Checkout عبر صفحة التواصل، مع وصف المرحلة التي يتوقف عندها العميل.
المصادر والمراجعة
المعلومات وخطوات الإعداد تعكس الوثائق التالية وقت المراجعة. قوائم الاختبار إرشادات للتطبيق، ولا تعني تنفيذ اختبارات على متجر أو حساب دفع فعلي. راجع توثيق نسختك قبل التنفيذ.
- Tabby: تركيب وإعداد إضافة WooCommerce
- Tabby Checkout: الإضافة الرسمية
- Tabby: مفاتيح وبيانات الاختبار
- Tabby: التحقق من الدفع والتحصيل
- Tabby: قائمة اختبار التكامل
- Tabby: المتطلبات التقنية
