التكاملات

ربط بوابات الدفع (مدى وأبل باي) مع أودو للشركات السعودية

كيف تربط بوابة دفع سعودية مع أودو لقبول مدى وفيزا وماستركارد وأبل باي: روابط الدفع، والدفع في المتجر، والمطابقة المحاسبية للتحويلات، ومعالجة الاسترجاعات.

محتويات المقال
  1. ماذا يعني ربط بوابة الدفع بأودو؟
  2. أين يدفع العميل؟ ثلاثة مسارات
  3. ما الذي تعلمته من بناء موديول «ماي فاتورة»؟
  4. المطابقة المحاسبية: من العملية إلى كشف البنك
  5. الاسترجاعات (Refunds)
  6. مشكلات شائعة وحلولها
  7. نصائح قبل الإطلاق
  8. الخلاصة

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

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

ماذا يعني ربط بوابة الدفع بأودو؟

في أودو تُسمّى البوابة «مزوّد دفع» (Payment Provider)، وهو موديول يربط أودو بحسابك في البوابة. عندما يضغط العميل «ادفع»، يُحوَّل إلى صفحة الدفع الخاصة بالبوابة ليختار الطريقة المناسبة: مدى، أو فيزا وماستركارد، أو أبل باي. وبعد الدفع تعود النتيجة إلى أودو، فتُسجَّل عملية الدفع ويُعلَّم الطلب أو الفاتورة كمدفوع.

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

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

أين يدفع العميل؟ ثلاثة مسارات

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

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

ما الذي تعلمته من بناء موديول «ماي فاتورة»؟

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

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

تجد هذا المشروع وغيره في صفحة المشاريع.

المطابقة المحاسبية: من العملية إلى كشف البنك

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

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

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

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

الاسترجاعات (Refunds)

الاسترجاع هو أكثر ما يُهمل في الربط، وهو أكثر ما يسبب فروقات لاحقًا:

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

مشكلات شائعة وحلولها

هذه أكثر المشكلات التي تظهر بعد تشغيل الربط، وأسبابها المعتادة:

المشكلة السبب المعتاد الحل
دفعة ناجحة في البوابة لا تظهر في أودو العميل أغلق الصفحة قبل العودة إشعارات فورية من البوابة وفحص دوري للمعلّق
طلب مؤكَّد دون دفع فعلي الاعتماد على صفحة النجاح وحدها التحقق من حالة الدفع من البوابة نفسها
تحويل البنك أقل من مجموع الدفعات عمولات أو استرجاعات مخصومة منه تسجيل العمولة من فاتورة البوابة وربط الاسترجاعات بتحويلها
رصيد قديم في حساب البوابة الوسيط تحويل لم يُطابق أو استرجاع لم يُسجَّل مراجعة دورية لأعمار الأرصدة في الحساب
دفعة على عميل خطأ مطابقة بالاسم بدل معرّف ثابت المطابقة برقم الطلب أو رقم الجوال

نصائح قبل الإطلاق

  • ابدأ ببيئة الاختبار لدى البوابة، ثم اختبر في البيئة الحية بمبالغ صغيرة لكل طريقة: مدى، والبطاقات الائتمانية، وأبل باي.
  • أبل باي على الويب قد يتطلب توثيق نطاق موقعك لدى البوابة، فأنجز ذلك مبكرًا.
  • احمِ مفاتيح الربط (API Keys): لا تُرسل في رسائل، ولا تُمنح إلا بأقل الصلاحيات اللازمة.
  • راجع يوميًا العمليات المعلّقة وغير المطابقة، فمعالجتها في يومها أسهل كثيرًا.
  • حدّد المسؤوليات: من يتابع الدفعات، ومن يعتمد الاسترجاع، ومن يطابق التحويلات.

الخلاصة

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

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

تحتاج من يطبّق هذا في شركتك؟

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