ربط بوابة دفع في متجر مبرمج خصيصاً

نعم، يمكن ربط مدى وآبل باي وفيزا وماستركارد بأي متجر مبرمج خصيصاً عبر الواجهة البرمجية (API) لبوابة دفع سعودية — بلا نقل المتجر ولا إعادة بنائه. البوابات الثلاث الأكثر استخداماً هي ميسر وتاب وباي تابس، ورسومها متقاربة عند ١٫٧٥٪ + ١ ريال على مدى، وتتفاوت بين ٢٫٢٪ و٢٫٧٥٪ + ١ ريال على البطاقات الائتمانية. والعمل البرمجي نفسه يستغرق عادة من يومين إلى خمسة أيام.

١ · كيف يعمل الربط فعلياً

كثيرون يتخيلون أن «ربط بوابة الدفع» قطعة كود تُلصق في الصفحة. الحقيقة أنه حوار من ثلاث خطوات بين متجرك وخوادم البوابة:

الخطوة الثالثة هي التي يُخطئ فيها أغلب المطوّرين، وسنعود إليها بالتفصيل.

٢ · البوابات الثلاث — مقارنة

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

٣ · الرسوم: من يدفع ماذا لمن

هذه أكثر نقطة تُسبّب سوء فهم بين التاجر والمطوّر. التكلفة ثلاث طبقات منفصلة تماماً:

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

٤ · خطوات الربط بالترتيب

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

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

٥ · آبل باي — الخطوة المنسية

آبل باي ليس مجرد خيار تُفعّله من لوحة البوابة. يتطلب ثلاثة أمور على سيرفرك أنت:

• التحقق من ملكية النطاق — رفع ملف تحقق في مسار محدد يبدأ بـ.well-known، ويجب أن يُقدَّم بنوع محتوى نصي صحيح
• شهادة SSL سارية — وأن تعمل الصفحة على HTTPS، فآبل باي لا يظهر إطلاقاً على HTTP
• النطاق نفسه الذي يُعرض فيه الزر — إن تحققت من example.com ثم عرضت الزر على www.example.com فلن يعمل

٦ · الـwebhook: حيث تضيع الطلبات

الـwebhook رابط في متجرك تستدعيه البوابة لتخبرك بنتيجة كل عملية. أربع قواعد تجعله موثوقاً:

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

٧ · خمسة أخطاء تُفشل العمليات

الخطأ الثاني تحديداً يستحق انتباهاً: بعض البوابات تستقبل المبلغ بأصغر وحدة — أي أن ٤٩٠ ريالاً تُرسل كـ49000 هللة. إرسالها كـ490 يعني خصم أربعة ريالات وتسعين هللة. اقرأ وثيقة البوابة في هذه النقطة حرفياً، واختبرها بعملية حقيقية صغيرة قبل الإطلاق.

٨ · كم يكلف الربط ومن ينفّذه

لا توجد تسعيرة ثابتة، لأن التكلفة تتبع حالة الكود لا عدد البوابات. ما يحدد السعر:

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

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

أسئلة شائعة