تجربة تابي وتمارا في أودو قبل الإطلاق: وش تفحص
وش يفحص زر اختبار الاتصال فعلاً، ووش يثبت طلب التجربة ووش ما يثبته، وخطة تجربة كاملة لتابي وتمارا في أودو قبل ما تفتح الدفع للعملاء.
تضغط زر «اختبار الاتصال» ويطلع لك إشعار أخضر، فتحس إنك خلصت. الحقيقة إنك توك بديت. الإشعار الأخضر معناه إن مفتاح واحد انقبل عند سيرفر واحد، بس. ما يقول لك هل العميل يقدر يدفع فعلاً، ولا هل أودو بيأكد الطلب، ولا هل الفلوس اللي تنسحب وقت "التجربة" فلوس حقيقية.
هالمقال عن هالمسافة بين الزر الأخضر والإطلاق. نفترض إنك ركّبت الإضافة وحطيت المفاتيح زي ما في دليل ربط تابي بأودو خطوة بخطوة ودليل إعداد تمارا في أودو، والسؤال هنا أضيق: وش لازم تشوفه بعينك قبل ما يشوف العميل زر التقسيط؟ وكل اللي تحت مبني على طريقة عمل إضافة تابي وتمارا لأودو نفسها، مو على كلام عام.
التجربة والإنتاج يتحددون في ثلاث أماكن
أغلب الناس يتخيلون مفتاح واحد يقلب المتجر من تجربة لإنتاج. الواقع إنها ثلاث مفاتيح، وكل واحد مستقل عن الثاني:
| المكان | وش اللي يحدد تجربة أو إنتاج |
|---|---|
| تابي في المتجر الإلكتروني | المفاتيح نفسها. مفاتيح التجربة تبدأ بـ pk_test_ وsk_test_، ومفاتيح الإنتاج بـ pk_live_ وsk_live_. |
| تمارا في المتجر الإلكتروني | حالة المزود. «وضع الاختبار» يكلم سيرفر التجربة عند تمارا، و«مفعّل» يكلم السيرفر الحقيقي. |
| الاثنين في نقطة البيع | قسم Tabby BNPL في الإعدادات، وله مفاتيحه الخاصة وخانة Tamara Sandbox لحالها. الكاشير ما يقرأ سجل مزود الموقع أبداً. |
فخ تابي اللي يطيح فيه كثير
في تابي، حقل الحالة ما يختار السيرفر. الإضافة ترسل كل طلبات تابي للعنوان المكتوب في حقل Tabby API URL مهما كانت الحالة، وتابي نفسها تعرف إذا الطلب تجربة ولا حقيقي من المفتاح. يعني لو مزود تابي على «وضع الاختبار» وفيه مفتاح سري حقيقي، فكل عملية تسويها عملية حقيقية وفلوسها حقيقية. والعكس أخطر: مزود «مفعّل» وباقي فيه مفاتيح التجربة ممكن يعلّم طلبات إنها مدفوعة وما أحد دفع شي.
طيب وش فايدة وضع الاختبار لتابي؟ من أودو 16 وطالع، يلغي نشر المزود، وأودو ما يعرض المزود غير المنشور إلا للموظفين المسجلين دخول. يعني يخفي الزر عن العملاء، لكنه ما يخلي الدفع وهمي. قبل أي جلسة تجربة، شيك على أول حروف المفتاحين.
وش يفحص زر اختبار الاتصال بالضبط
الزر اللي تحت بيانات الاعتماد في كل مزود يسوي طلب واحد موثّق ويعرض لك الرد:
- تابي: يطلب قائمة آخر الدفعات بالمفتاح السري. الأخضر معناه إن المفتاح صالح على السيرفر المكتوب في حقل Tabby API URL. والأحمر اللي يتكلم عن فشل المصادقة معناه مفتاح غلط، أو مفتاح من البيئة الثانية، أو مفتاح صادر للسعودية وموجّه على
api.tabby.aiوهو يحتاجapi.tabby.sa. - تمارا: يسأل عن طلب مستحيل يكون موجود. الرمز الصحيح يرجع له رد «غير موجود»، وهذا يعتبر نجاح. والرمز الغلط، أو رمز البيئة الثانية، ينرفض.
والأشياء اللي الزر ما يلمسها أكثر:
- المفتاح العام لتابي، وهذا يستخدمه بس شريط التقسيط تحت السعر في صفحة المنتج.
- رمز التاجر في تابي (Merchant Code)، لأنه ما ينرسل إلا لما تنشئ عملية دفع فعلية. يعني رمز تاجر غلط يعدّي اختبار الاتصال عادي ويفشل عند الدفع.
- رمز الإشعارات في تمارا.
- هل المزود منشور، وهل له يومية، وهل يناسب عملة قائمة الأسعار.
- هل تابي وتمارا يقدرون يوصلون لمتجرك عشان يرجعون العميل ويرسلون الإشعارات.
وفي الإعدادات، تحت Tabby BNPL، فيه زر Test Tabby connection يسوي نفس الفحص لمفاتيح نقطة البيع. أما رمز تمارا حق الكاشير فما له زر، واختباره الوحيد عملية تجربة وحدة على الكاشير.
وش يثبت لك طلب التجربة
طلب التجربة يمشي المسار كامل: الإضافة تبني عملية الدفع من طلبك الحقيقي، والبوابة تقبلها أو ترفضها، والعميل يروح لصفحة الدفع ويرجع، وبعدها أودو يسأل البوابة مباشرة وش صار قبل ما يحصّل المبلغ ويعلّم العملية إنها تمت. رحلة الرجوع هذي هي المكان اللي تنكسر فيه أغلب الربطات الضعيفة، وتفاصيلها في مقال التحقق من الدفع من جهة السيرفر.
فلو طلب التجربة مشى نظيف، أنت متأكد من أربع أشياء: البوابة تقبل بيانات طلبك، والرجوع لمتجرك شغال، والتحصيل ينجح، وأودو يأكد أمر البيع ويسجل الدفعة على يومية المزود.
ووش ما يقدر يثبته
- إن مفاتيح الإنتاج شغالة. هذي بيانات اعتماد ثانية تماماً، وما يثبتها إلا اختبار الاتصال بعد التبديل وطلب حقيقي واحد.
- مين ينقبل من العملاء. الموافقات في التجربة تجي من هويات تجريبية. الموافقة الحقيقية تعتمد على العميل وعلى فحوصات تابي وتمارا نفسها، وما فيه إعداد في أودو يغيّرها.
- الفلوس. دفعات التجربة ما تتسوى أبداً، والعمولة والتحويلات ما تبان إلا مع أول تسوية حقيقية، ومن هناك يبدأ دليل تسوية تحويلات تابي وتمارا في أودو.
- الإشعارات، لو تجرب على جهاز داخلي. اللابتوب أو السيرفر اللي وراه تسجيل دخول ما يوصله نداء البوابة. الطلب بيتأكد برضو لما يرجع المتصفح، لأن الرجوع لحاله يكفي، بس حالة العميل اللي ما يرجع أبد ما جربتها.
خطة تجربة تخلص في عصرية
خلك مسجل دخول كموظف عشان تشوف المزودات غير المنشورة، وافتح Tabby/Tamara API Log في تبويب ثاني، تلقاه في القائمة جنب مزودي الدفع. وسوّ كل حالة مرة لكل مزود ناوي تقدمه:
- المسار الطبيعي. طلب عادي فيه منتج وشحن، وكوبون خصم لو تستخدمها. تأكد إن الطلب انأكد، والعملية حالتها «تم»، والمبلغ نفس اللي في بوابة التاجر بالهللة.
- الإلغاء. ابدأ طلب وألغِه من صفحة الدفع. الطلب لازم يبقى غير مدفوع.
- الرفض. استخدم الهويات التجريبية اللي في توثيق البوابة نفسها عشان تجبرها ترفض. أودو لازم يسجل الرفض ويخلي الطلب غير مدفوع.
- التبويب المقفول. وافق، وسكّر التبويب قبل ما يفتح متجرك. لو موقع التجربة مكشوف على الإنترنت، الإشعار لازم يأكد الطلب لحاله. ولو مو مكشوف، اكتب إن هالحالة ما انجربت.
- تمارا بدون جوال. احذف رقم الجوال من عنوان العميل التجريبي. الإضافة لازم توقف قبل ما يوصل أي شي لتمارا وتطلب الرقم.
- عملة غلط. حوّل لقائمة أسعار بعملة غير الريال السعودي والدرهم الإماراتي والدينار الكويتي والدينار البحريني والريال القطري والريال العماني. الزرين لازم يختفون. ولو اختفى زر وأنت ما تتوقع، قائمة فحص المزود المختفي من صفحة الدفع تمشي معك على كل فلتر.
- استرجاع جزئي. استرجع جزء من أول طلب من داخل أودو، وتأكد إنه ظهر في بوابة التاجر.
- عملية وحدة على الكاشير لكل مزود، لو تستخدم نقطة البيع.
كيف تقرأ السجل وأنت تجرب
كل طلب يطلع من الموقع ينحفظ في السجل مع الطلب والرد ورمز HTTP، والمفاتيح مخفية. في طلب إنشاء الدفع بتشوف يا سطور منتجاتك، يا سطر واحد باسم مرجع الطلب. الاثنين طبيعيين: لو مجموع السطور ما طابق المبلغ المستحق بالضبط، بسبب الشحن أو الخصم مثلاً، الإضافة ترسل سطر واحد بالمبلغ كامل، لأن البوابتين ترفضون السلة اللي مجموعها ما يطابق الإجمالي.
وفي آخر الجلسة فلتر على الأخطاء فقط. القائمة الفاضية هي النتيجة اللي تبيها. عمليات الكاشير ما تنسجل هنا، كل وحدة حالتها وخطأها في سجلها الخاص تحت نقطة البيع ثم Tabby Payments.
طلبات التجربة تترك سجلات حقيقية
دفعة التجربة وهمية عند البوابة بس. في أودو هي عملية مكتملة زيها زي غيرها: أمر البيع ينأكد، والدفعة تنرحّل على يومية المزود، وإذا فيه فاتورة مسودة مربوطة بالدفع تنرحّل هي بعد. فلو جربت على قاعدة بياناتك الحقيقية، لازم تنظف هالسجلات بعدين، والأحسن إنك ما تجرب عليها من الأساس.
وفي المتجر الشغال فيه شي ثاني يشوفه العميل: شريط التقسيط تحت السعر يطلع أول ما يطلع المزود من حالة «معطّل»، حتى لو كان على وضع الاختبار. لو يهمك، شيل علامة عرض الشريط في المزود لين تطلق.
التجربة على نسخة من قاعدة البيانات
نسخة التجربة (Staging) هي المكان الصح لكل هذا، بس انتبه لشيئين.
لما أودو يحيّد نسخة من القاعدة، الخطوة القياسية تعطّل كل مزود كان «مفعّل» وتخلي المفاتيح في حقولها. فلو رجعت واحد منهم لوضع الاختبار عشان تجرب تابي، رجعت لنفس الفخ: مفاتيح حقيقية وفلوس حقيقية. حط مفاتيح التجربة أول.
وإعدادات نقطة البيع ما تتحيّد أبداً. تنتقل مع النسخة زي ما هي، يعني الكاشير في نسخة التجربة ماسك مفتاح تابي الحقيقي ورمز تمارا الحقيقي، وخانة Sandbox على وضعها في الإنتاج. غيّرها قبل ما أحد يسوي عملية تجربة.
الانتقال للإنتاج بالترتيب
- بدّل كل بيانات الاعتماد: مفتاحين تابي، ورمز تمارا، ومفاتيح نقطة البيع في الإعدادات.
- حوّل كل مزود لـ«مفعّل» وتأكد إنه صار منشور.
- شيل علامة Tamara Sandbox حق الكاشير.
- اضغط اختبار الاتصال في كل مزود، و Test Tabby connection في الإعدادات.
- افتح نافذة خاصة وتأكد إن الأزرار تطلع للزائر.
- ادفع طلب حقيقي صغير بكل مزود، واسترجع جزء منه، وطابق الاثنين مع بوابة التاجر.
لو الخطوة الأخيرة مشت نظيفة، مبروك، أنت على الهواء. ولو لا، السجل فيه الجواب، ودليل الاسترجاع في تابي وتمارا يوضح وش تفحص لو الاسترجاع هو اللي تعطّل.
أسئلة متكررة
هل وضع الاختبار في أودو يخلي دفعات تابي وهمية؟
لا. في تابي المفتاح هو اللي يحدد، مو حالة المزود. مزود على وضع الاختبار وفيه مفتاح سري يبدأ بـ sk_live_ يسوي عمليات حقيقية بفلوس حقيقية. وضع الاختبار يخفي الزر عن العملاء بس. أما تمارا فالحالة هي اللي تختار سيرفر التجربة أو الإنتاج.
اختبار الاتصال أخضر، ليش الدفع يفشل عند العميل؟
لأن الزر يفحص المفتاح السري أو رمز تمارا بس. رمز التاجر في تابي، ورقم جوال العميل لتمارا، وعملة قائمة الأسعار، ومطابقة المبلغ، كلها ما تنفحص إلا مع عملية دفع فعلية. افتح Tabby/Tamara API Log وشوف آخر طلب فيه خطأ، الرد فيه سبب الرفض.
أقدر أجرب على متجري الشغال؟
تقدر، لأن وضع الاختبار من أودو 16 وطالع يلغي نشر المزود فما يشوفه إلا الموظفين. بس طلبات التجربة تأكد أوامر البيع وترحّل دفعات حقيقية في أودو، وشريط التقسيط تحت السعر يطلع للكل. نسخة تجربة من القاعدة أنظف.
أحتاج رابط عام عشان أجرب؟
لطلب التجربة العادي لا، لأن أودو يتحقق من الدفع لما يرجع المتصفح. تحتاجه بس عشان تجرب حالة العميل اللي يوافق ويسكّر التبويب، لأن إشعار البوابة لازم يوصل لمتجرك من الإنترنت.
نسخة التجربة من قاعدة البيانات آمنة للتجربة على طول؟
مو على طول. التحييد يعطّل مزودات الدفع المفعّلة لكنه يخلي المفاتيح الحقيقية فيها، وما يلمس إعدادات نقطة البيع أبداً. بدّل المفاتيح في المزودات وفي قسم Tabby BNPL بالإعدادات قبل أي عملية تجربة.