تطوير المواقع٦ نوفمبر ٢٠٢٦9 دقائق للقراءة

ربط تابي وتمارا بمتجرك الإلكتروني أو تطبيقك: ما الذي يلزم؟

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

كيرلس فايز

مؤسس KF Tech Solutions

يبني أنظمة نقاط البيع والويب والأتمتة للشركات في مصر وخارجها.

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

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

آخر تحديث: 6 نوفمبر 2026

المزوّدان مرخّصان الآن من البنك المركزي السعودي

رخّص البنك المركزي السعودي (ساما) لشركة تمارا للتمويل في التمويل الاستهلاكي وخدمة «اشتر الآن وادفع لاحقًا» في 3 مارس 2025، ولشركة تابي للتمويل في خدمة «اشتر الآن وادفع لاحقًا» في 10 نوفمبر 2025. والإعلانان منشوران على موقع البنك المركزي، وروابطهما في المصادر أدناه.

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

هذا المقال معلومات عامة عن طريقة عمل الربط، مستندة إلى الوثائق البرمجية العامة لكل مزوّد، وليس استشارة مالية أو قانونية.

إضافة جاهزة أم بوابة دفع أم ربط مباشر

هناك ثلاث طرق لعرض تابي أو تمارا على عملائك، ويتوقف اختيار الأنسب على ما بُني عليه متجرك أو تطبيقك.

الطريقة	تناسب	ما يبقى عليك
إضافة المنصة	المتاجر على سلة أو زد أو شوبيفاي أو WooCommerce أو Magento	الإعدادات والاختبار والاسترداد من المنصة أو بوابة المزوّد
بوابة دفع	المتاجر والتطبيقات المخصصة التي تستخدم بوابة دفع بالفعل	واجهة البوابة البرمجية وإشعاراتها وتقرير تسويتها
ربط مباشر	المتاجر المخصصة وتطبيقات الجوال والأسواق الإلكترونية والطلبات المرتبطة بنظام نقاط البيع	كل شيء: الجلسات والتحقق والإشعارات والالتقاط والاسترداد والتسوية

الإضافات الجاهزة. تتضمن وثائق تابي صفحات إعداد لكل من Shopify وWooCommerce وMagento 2 وسلة وزد. إن كان متجرك يعمل على إحداها فابدأ من هناك، وراجع القسم المقابل في وثائق تمارا. ويتناول مقالنا للمقارنة بين سلة وزد وشوبيفاي اختيار المنصة نفسه.

بوابات الدفع. تدرج بعض بوابات الدفع في السعودية خدمة «اشتر الآن وادفع لاحقًا» ضمن وسائل الدفع لديها. فشركة Tap تصف نفسها بأنها «مؤسسة مدفوعات مرخّصة من البنك المركزي السعودي»، وتدرج مدى وApple Pay وتابي وتمارا. وتدرج PayTabs مدى وSTC Pay وApple Pay وتابي وتمارا. وتدرج Telr مدى وApple Pay وتابي. وتمنحك البوابة ربطًا واحدًا وتقرير تسوية واحدًا للبطاقات وخدمة «اشتر الآن وادفع لاحقًا» معًا. وقبل الاعتماد عليها تأكد مما تدعمه في الالتقاط الجزئي والاسترداد لهذه الخدمة. ويقارن دليلنا عن بوابات الدفع في السعودية بين الخيارات.

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

كيف تنتقل الدفعة بين حالاتها

يتعامل المزوّدان مع الدفعة على أنها سلسلة من الحالات، وعلى نظام الطلبات لديك أن يربط كل حالة منها بحالة لديه، حتى لا يُسجَّل أي طلب على أنه مدفوع قبل أن يؤكده المزوّد.

ما حدث	الحالة في تابي	الحالة في تمارا
بدأ العميل الدفع	CREATED	new
أكمل العميل الدفع	AUTHORIZED	approved ثم authorised
غادر العميل أو لم تتم الموافقة عليه	EXPIRED أو REJECTED	expired أو declined
التقطت الطلب	CLOSED	fully_captured أو partially_captured
ألغيت قبل الالتقاط	إلغاء دفعة مفوَّضة	canceled، أو updated للإلغاء الجزئي
استرددت بعد الالتقاط	استرداد مسجَّل على دفعة CLOSED	fully_refunded أو partially_refunded

تختلف الأسماء، لكن المسار واحد: دفع، ثم موافقة، ثم التقاط عند تنفيذ الطلب، ثم استرداد في حدود ما التُقط.

صفحة الدفع والإشعارات

لا تعتمد على إعادة التوجيه وحدها

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

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

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

قد تصل الإشعارات متأخرة أو مكررة أو بغير ترتيبها

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

وعمليًا ينبغي لمعالج الإشعارات لديك أن:

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

وهي القواعد نفسها التي نطبقها في أي ربط، ويتناولها بصورة أعم مقالنا عن ربط الأنظمة التي تعمل بها بالفعل.

الالتقاط والإلغاء والإرجاع الجزئي

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

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

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

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

التسوية والاختبار

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

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

ومن دون ذلك يبدو الالتقاط المنسي دفعة مفقودة، ولا يُكتشف الاسترداد المكرر إلا عندما ينتبه العميل.

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

دور KF Tech Solutions

تبني KF Tech Solutions متاجر إلكترونية مخصصة وتطبيقات جوال والأنظمة الخلفية التي تشغّلها، وتربطها بالخدمات الأخرى عبر واجهاتها البرمجية. وفي خدمة «اشتر الآن وادفع لاحقًا» يعني ذلك جلسة الدفع، والتحقق من الخادم، ومعالج إشعارات يتحمل التكرار، وأوامر الالتقاط والاسترداد في لوحة التحكم، وتقرير التسوية. نحن نعمل مع المنشآت في مصر والخليج؛ راجع صفحة السعودية وخدمة الواجهات البرمجية والأنظمة الخلفية. ولسنا شريكًا لتابي أو تمارا: فأنت توقّع اتفاقية التاجر مع كل مزوّد مباشرة، ويبقى حساب التاجر باسمك.

أسئلة شائعة

هل أحتاج إلى بوابة دفع، أم يمكنني ربط تابي وتمارا مباشرة؟

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

هل يمكنني عرض تابي وتمارا معًا في صفحة الدفع؟

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

هل يمكن للعميل إرجاع جزء من الطلب؟

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

من يحصّل الأقساط من العميل؟

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

ماذا أطلب من المزوّد قبل بدء التطوير؟

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

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