ربط بوابة دفع بموقعك أو تطبيقك (مدى، Apple Pay، البطاقات): ماذا يشمل الربط الصحيح وكم يكلف؟

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

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

قبل الربط: ما المطلوب منك أنت

جزء من الربط ليس برمجياً، ولا يستطيع أي مطوّر القيام به نيابة عنك:

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

في هذه الأثناء نبني ونختبر كل شيء على بيئة التجربة التي توفرها البوابة، فلا يتأخر المشروع بانتظار التفعيل.

ثلاث طرق للربط، والفرق بينها

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

ما الذي يشمله الربط الصحيح؟

هذه القائمة هي الفرق بين ربط يعمل في العرض التجريبي وربط يعمل مع آلاف الطلبات:

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

مدى وApple Pay: تفاصيل تُنسى كثيراً

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

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

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

حالات خاصة تغيّر شكل الربط

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

التقسيط: ما نربطه وما لا نربطه

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

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

كم يكلف ربط بوابة الدفع؟

الحالات الأكبر، مثل تقسيم المدفوعات في منصة متعددة البائعين أو الاشتراكات المتكررة، تُسعَّر في عرض مكتوب بعد معرفة البوابة والتفاصيل. ورسوم البوابة على كل عملية تدفعها أنت للبوابة مباشرة، ولا علاقة لنا بها. نعمل على مشاريع React وNext.js وPHP وLaravel وتطبيقات Flutter وReact Native.

متى لا تحتاجنا أصلاً؟

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

الأسئلة الشائعة

هل تفتحون حساب البوابة نيابة عني؟

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

هل يمكن ربط أكثر من بوابة في نفس الموقع؟

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

غيّرنا البوابة، فهل نعيد بناء المتجر؟

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

لماذا يظهر الطلب "غير مدفوع" رغم أن العميل دفع؟

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

هل الدفع داخل التطبيق آمن؟

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

كيف أبدأ؟

أخبرنا أين تريد الدفع (موقع أم تطبيق، وعلى أي تقنية)، وفي أي بلد يدفع عملاؤك، وهل اخترت بوابة. خلال 24 ساعة نرد بالطريقة المناسبة والسعر. أو صف مشروعك في مخطط المشروع.