استرجاع تابي وتمارا في أودو: جزئي، من الفاتورة، ومن نقطة البيع

نُشر في 17 سبتمبر 2026آخر تحديث 22 أكتوبر 2026مدة القراءة 13 دقيقة

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

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

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

الخلاصة قبل التفاصيل

• بيعة من المتجر الإلكتروني أو بوابة العميل: من سجل الدفعة في أودو، بزر الاسترداد القياسي، وتقدر تكتب المبلغ اللي تبيه.
• بيعة كاونتر يرجعها الكاشير: استرجاع عادي في شاشة نقطة البيع، والإضافة ترسل الاسترجاع للمنصة تلقائياً لما يتزامن الطلب.
• بيعة كاونتر مفوترة والعميل اتصل بعدين: زر «Refund on Tabby» في رأس الفاتورة، يرجّع المتبقي كله بضغطة.
• استرجاع سويته من لوحة تابي أو تمارا: أودو ما يدري عنه أبداً. تسجله بيدك، ولا تعيده من أودو.

الباقي تفاصيل، لكنها تفاصيل تفرق لما تكون الفلوس حقيقية.

ليش الاسترجاع في التقسيط يختلف عن البطاقة

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

ويترتب على هذا شيئين تحتاج تثبتهما عند فريقك:

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

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

المسار الأول: من سجل الدفعة لبيعة المتجر أو البوابة

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

الخطوات

افتح الفاتورة المدفوعة واضغط الزر الذكي الخاص بمعاملة الدفع، أو افتح سجل الدفعة المرتبط بها. في سجل الدفعة فيه زر استرداد (Refund) يظهر لمستخدمي الفوترة طول ما فيه مبلغ يقبل الاسترجاع. تفتح نافذة صغيرة فيها مبلغ الدفعة، المبلغ المسترجع سابقاً، الحد الأقصى المسموح، وخانة المبلغ اللي تبي ترجعه. اتركه على الحد الأقصى لاسترجاع كامل، أو اكتب قيمة القطعة المرتجعة لاسترجاع جزئي. هذا المعالج جزء من أودو نفسه من الإصدار 15 إلى 19.

وش يصير بعد التأكيد

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

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

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

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

كل نداء في هذا المسار يُسجل في سجل الـ API مع إخفاء المفاتيح، فالاسترجاع المرفوض تقرأه كطلب ورد بدل ما تخمّن. طريقة قراءة السجل والأكواد اللي ترجع منه مشروحة في دليل حل مشكلة تابي ما يظهر في صفحة الدفع.

لو نظامك أودو 14

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

المسار الثاني: إرجاع عند الكاونتر

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

وش يسوي الكاشير

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

وش يصير عند المزامنة

الشغل الحقيقي يصير لما طلب الاسترجاع يوصل السيرفر:

1. الإضافة تلقى أسطر الدفع السالبة بطريقة تابي في طلب الاسترجاع.
2. تتبع القطع المرتجعة للطلب الأصلي ولجلسته المحصّلة.
3. ترسل للمنصة استرجاع بالمبلغ الأصغر بين مبلغ الإرجاع والرصيد اللي لسا يقبل الاسترجاع في الجلسة، بمفتاح مبني من رقم طلب الاسترجاع.
4. عند النجاح تضيف المبلغ لإجمالي المسترجع في الجلسة، وتحوّل حالتها إلى «مسترجع» لما يتغطى كامل المبلغ المحصّل، وتكتب ملاحظة في محادثة الجلسة باسم طلب الاسترجاع.

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

لو فشل النداء

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

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

لما يوافق العميل والكاشير يضغط إلغاء

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

التأكد ياخذ دقيقة وقت قفل الجلسة. افتح Tabby Payments، وكل جلسة من اليوم حالتها Captured افتحها وتأكد إن لها طلب نقطة بيع (POS Order)، وإن الطلب فعلاً مدفوع بهذي الطريقة. الجلسة المحصّلة اللي ما يقابلها سطر دفع ترجّعها من زر «Refund on Tabby» اللي عليها، بيد شخص عنده صلاحية الاسترجاع المشروحة تحت.

المسار الثالث: من الفاتورة مباشرة، أو من الجلسة

لو بيعة الكاونتر صدرت لها فاتورة، ما تحتاج تطلع منها. فاتورة العميل فيها زر ذكي «Tabby» يفتح جلسة الدفع المرتبطة، وزر «Refund on Tabby» في رأس الفاتورة. هذا الزر يسترجع المبلغ المتبقي المحصّل لكل جلسة مرتبطة بالفاتورة، بعد رسالة تأكيد. وهو أسرع طريق لما يتصل العميل بعد ما طلع من المحل والبيعة كلها بتنعكس.

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

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

استرجاع صار برا أودو

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

عادتين تحميك من لغز آخر الشهر:

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

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

مين يقدر يضغط الزر

الاسترجاع يحرك فلوس حقيقية، فالأزرار اليدوية محمية بصلاحية مخصصة اسمها «Tabby Refund» تلقاها في قسم «Tabby BNPL» من صلاحيات المستخدم. ما أحد يملكها افتراضياً بعد التثبيت، فامنحها للأشخاص المسموح لهم بالاسترجاع بالذات. والفحص مطبق داخل الدالة نفسها، مو مجرد إخفاء للزر، فما ينفع أحد يتجاوزه بنداء الإجراء عبر RPC.

وهذي الصلاحية تخص أزرار «Refund on Tabby»، يعني مسارات بيعات الفرع. أما استرجاع بيعة المتجر أو البوابة في المسار الأول فهو زر أودو نفسه، ويمشي على صلاحيات الفوترة في أودو، فإذا تبي تضيّق مين يقدر يرجّع بيعة أونلاين، ضيّق مين عنده صلاحية الفوترة.

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

ليش الضغط مرتين ما يسترجع مرتين

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

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

لما الاسترجاع ما يمشي

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

• «تم رفض طلب الاسترداد من قِبل المزوّد.» تظهر على معاملة استرجاع المتجر بهذا النص لو واجهتك بالعربي، وبالإنجليزي «The refund request was rejected by the provider.». ورغم صياغتها، تغطي ثلاث حالات: المنصة رفضت بدون سبب مقروء، أو المفاتيح فشلت في التحقق، أو النداء ما جاه رد أصلاً. سجل الـ API يفرق بينها: network-error في عمود حالة HTTP معناه ما رجع رد، و401 معناه المفاتيح.
• «The provider did not confirm the refund:» وبعدها نص. المنصة ردت ورفضت، والكلام اللي بعد النقطتين هو سببها هي.
• «Tabby refund failed:» أو «Tamara refund failed:» وبعدها السبب. هذي تطلع من زر الفاتورة أو الجلسة، ونفس السبب يتحفظ في الجلسة تحت Errors. ولو فشل استرجاع نقطة البيع التلقائي، النشاط المجدول ينقل نفس الرسالة.

الحالة اللي تستاهل تتمهل فيها هي النداء اللي ما جاه رد، لأن المنصة ممكن نفذته وضاع الرد بس. في زر الجلسة والفاتورة إعادة المحاولة آمنة لأنها بنفس المفتاح. في مسار المتجر لا: الإعادة معاملة استرجاع جديدة بمرجع جديد، والمنصة تشوفها استرجاع ثاني. فقبل ما تعيد استرجاع متجر سطره في السجل مكتوب فيه network-error، دوّر الطلب في لوحة المنصة وتأكد هل المحاولة الأولى مشت. وقراءة السجل سطر سطر مشروحة في دليل أخطاء التثبيت وسجل الـ API.

وأحياناً ما يكون عندك في أودو شيء يُسترجع من الأساس. لو العميل وافق والتحصيل فشل، معاملة المتجر تنتهي بخطأ نصه «صرّح تابي بالدفعة لكن فشل تحصيلها» أو «تعذّر على تمارا تحصيل هذه الدفعة»، وجلسة الكاونتر تبين Capture Failed. أودو ما استلم هالفلوس، فما عنده استرجاع يرسله. شيك على حالة الطلب عند المنصة قبل ما تقول للعميل أي شيء.

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

جرّبه قبل أول إرجاع حقيقي

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

مسار الاسترجاع اللي شفته مرة بعينك هو اللي تقدر تثق فيه والعميل واقف عند الكاونتر.

أسئلة متكررة