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

لماذا دعم مدى غير قابل للتفاوض في تطبيقك

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

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

كيف يعمل تكامل مدى تقنيًا داخل التطبيق

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

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

بوابة الدفع	دعم مدى	ملاحظة
HyperPay	نعم	مستخدمة بكثرة في متاجر سلة وزد
PayTabs	نعم	تدعم أيضًا تمارا وتابي ضمن نفس اللوحة
Moyasar	نعم	واجهة برمجية مرنة للمتاجر المخصصة
Tap Payments	نعم	تغطية خليجية أوسع من مدى وحدها

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

التوثيق الإضافي 3D Secure

معظم عمليات مدى تمر بخطوة تحقق إضافية تُعرف بـ 3D Secure، وتظهر للعميل كرسالة نصية أو إشعار من تطبيق البنك لتأكيد العملية. داخل تطبيق الجوال، يجب أن تفتح هذه الخطوة في نافذة ويب مدمجة (WebView) سلسة، لا في متصفح خارجي يقطع تجربة المستخدم ويزيد احتمال التخلي عن الشراء.

الحفظ الآمن للبطاقة عبر Tokenization

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

أخطاء شائعة تُفشل عمليات الدفع بمدى

• فتح صفحة 3D Secure في متصفح خارجي بدل WebView داخلي، ما يجعل عودة العميل للتطبيق بعد الدفع غير مضمونة.
• عدم معالجة رسائل الرفض بوضوح (رصيد غير كافٍ، تجاوز حد العملية اليومي) وترك العميل بشاشة خطأ عامة.
• عدم اختبار الدفع على شبكات إنترنت بطيئة، رغم أن جلسة 3D Secure تنتهي صلاحيتها خلال دقائق معدودة.
• إهمال دعم مدى أثير (الدفع اللاتلامسي NFC) عند وجود ميزة دفع داخل نقاط بيع فعلية مرتبطة بالتطبيق.

قائمة تحقق قبل إطلاق الدفع بمدى في تطبيقك

قبل نشر التطبيق على المتاجر، تأكد من:

• اختبار عملية دفع كاملة ببطاقة مدى حقيقية وليس بطاقة تجريبية فقط.
• التأكد من ظهور شعار مدى بوضوح في صفحة الدفع كخيار مستقل لا مدمج ضمن “بطاقة بنكية” عامة.
• مراجعة نص رسائل الرفض والتأكد من أنها بالعربية ومفهومة للعميل.
• التأكد من أن حفظ البطاقة (Tokenization) يعمل بشكل متوافق مع سياسات حماية بيانات العملاء.

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

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

تجربة الدفع بمدى على الجوال تختلف عن الحاسوب

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

استقبال رمز التحقق تلقائيًا

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

اختلاف سلوك 3D Secure بين iOS وAndroid

واجهة تأكيد الدفع البنكي قد تظهر بشكل مختلف قليلًا بين نظامي التشغيل، وبعض البنوك السعودية تستخدم تطبيقًا منفصلاً لتأكيد العملية بدل رسالة نصية عادية. لذلك يجب اختبار العملية كاملة على جهاز iOS حقيقي وجهاز Android حقيقي، لا الاكتفاء بمحاكي واحد فقط، لأن سلوك التحويل بين التطبيقات (Deep Linking) يختلف باختلاف النظام.

مدى في تطبيقات سلة وزد مقابل التطبيقات المخصصة

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

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

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

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

هل يمكن قبول مدى مباشرة دون بوابة دفع؟

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

ما الفرق بين مدى وmada Atheer؟

مدى هي شبكة البطاقات نفسها للدفع بالإدخال أو الإنترنت، بينما مدى أثير ميزة الدفع اللاتلامسي (NFC) المستخدمة غالبًا في نقاط البيع الفعلية وليس عادة في الدفع داخل التطبيقات عبر الإنترنت.

هل تختلف تجربة الدفع بمدى بين متجر سلة أو زد والتطبيق؟

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

هل مدى تدعم الدفع الدولي داخل التطبيق؟

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