إضافة مدى وApple Pay وSTC Pay إلى متجر أو تطبيق سعودي تتم عبر بوابة دفع، لا بالتعاقد مع كل شبكة على حدة. تختار بوابة تدعم الطرق الثلاث لحسابك التجاري، ثم تجهّز ثلاثة أشياء: مدى كشبكة بطاقات، وApple Pay بمعرّف تاجر وشهادة خاصة به، وSTC Pay كطريقة دفع مستقلة. وأغلب الأعطال يوم الإطلاق سببها إعداد Apple Pay، أو التعامل مع بطاقات مدى كأنها فيزا أو ماستركارد عادية.
يشرح هذا الدليل ما تحتاجه كل طريقة، وترتيب إعدادها، وكيف تختبرها قبل التشغيل. وإن كنت ما زلت تختار المزوّد، فابدأ بـمقارنة بوابات الدفع في السعودية.
ماذا تحتاج قبل البدء؟
- حساب تاجر لدى بوابة دفع تدعم مدى وApple Pay وSTC Pay لنوع نشاطك. دعم البوابة للطريقة على موقعها لا يعني تفعيلها على حسابك، فتأكد من الطرق المفعّلة لك فعلًا.
- سجل تجاري سعودي والمستندات التي تطلبها البوابة أثناء التسجيل.
- حساب مطوّر لدى Apple إذا كنت ستقدّم Apple Pay داخل تطبيق iOS أو على موقعك.
- اتصال HTTPS على كل نطاق يعرض نموذج دفع.
كيف تعمل مدى في الدفع الإلكتروني؟
مدى هي شبكة بطاقات الخصم الوطنية في السعودية، ويحملها أغلب المتسوقين المحليين. وهناك تفصيلتان تهمّان المطوّر:
- التعرّف على البطاقة. كثير من بطاقات مدى مشتركة مع فيزا أو ماستركارد. تتعرّف البوابة على بطاقة مدى من نطاق أرقامها وتمررها عبر شبكة مدى. لذلك استخدم نموذج البطاقة أو حزمة التطوير الخاصة بالبوابة حتى يتم هذا التوجيه صحيحًا؛ فالنموذج المخصص الذي لا يعرف إلا «فيزا» و«ماستركارد» قد يرسل بطاقة مدى في المسار الخطأ.
- التحقق. تمر مدفوعات البطاقات عبر الإنترنت عادة بتحقق 3-D Secure، إذ يطلب البنك من العميل تأكيد العملية برمز لمرة واحدة. ويجب أن يتعامل الدفع في موقعك مع هذه الخطوة ويعيد العميل إلى الصفحة الصحيحة سواء نجحت العملية أم فشلت.
كيف تجهّز Apple Pay؟
Apple Pay هي الخطوة الأطول، لأن Apple وبوابتك ونطاقك يجب أن تتفق جميعًا.
داخل تطبيق iOS:
- أنشئ معرّف تاجر (Merchant ID) في حساب المطوّر لدى Apple.
- أنشئ شهادة معالجة الدفع لهذا المعرّف. أغلب البوابات تعطيك طلب توقيع شهادة (CSR) ترفعه، حتى تتمكن البوابة من فك تشفير بيانات الدفع.
- فعّل خاصية Apple Pay في التطبيق واستخدم حزمة iOS الخاصة بالبوابة.
- أضف مدى إلى قائمة الشبكات المدعومة. فـApple تنص على أن معاملات الخصم المحلية في السعودية يجب أن تمر عبر شبكة مدى، وعلى التاجر الذي يقبل بطاقات الخصم إضافتها.
على موقع إلكتروني:
- سجّل كل نطاق يظهر فيه زر Apple Pay ووثّقه. تتحقق Apple من ملف توثيق في مسار ثابت داخل `/.well-known/` على النطاق، عبر HTTPS.
- اعرض الزر فقط على الأجهزة والمتصفحات التي تدعم Apple Pay.
- اختبر على النطاق الحقيقي؛ فـApple لا تتحقق من النطاق في بيئة الاختبار، لذلك قد تعمل الصفحة في الاختبار ثم تفشل في التشغيل الفعلي إذا كان الملف مفقودًا.
ملاحظة عملية: إذا استخدمت بوابتين على النطاق نفسه، فقد تحتاج كل منهما ملف توثيق خاصًا بها في المسار نفسه، فيتعارضان. خطط لبوابة Apple Pay واحدة لكل نطاق.
كيف تضيف STC Pay؟
تُضاف STC Pay (وهي الآن جزء من STC Bank) كطريقة دفع مستقلة عبر البوابات التي تدعمها. في المسار المعتاد يُدخل العميل رقم الجوال المرتبط بمحفظته، ثم يوافق على الدفع برمز لمرة واحدة أو من تطبيق STC. اسأل بوابتك هل STC Pay مفعّلة على حسابك، وهل تعمل على الموقع أو داخل التطبيق أو كليهما.
بأي ترتيب تجهّز الطرق؟
| الخطوة | الطريقة | سبب الترتيب |
|---|---|---|
| 1 | البطاقات ومدى | أساس صفحة الدفع، وأغلب العملاء يدفعون بها |
| 2 | Apple Pay | تحتاج إعداد البطاقات أولًا، ثم شهادة Apple وتوثيق النطاق |
| 3 | STC Pay والمحافظ الأخرى | موافقات منفصلة؛ أضفها بعد استقرار البطاقات |
| 4 | اشترِ الآن وادفع لاحقًا | تابي أو تمارا، للسلات الأعلى قيمة |
كيف تختبر قبل الإطلاق؟
- جرّب كل طريقة في بيئة الاختبار لدى البوابة ببطاقاتها ومحافظها التجريبية.
- اختبر حالات الفشل لا النجاح فقط: بطاقة مرفوضة، وإلغاء تحقق 3-D Secure، وإغلاق المتصفح أثناء الدفع.
- تأكد أن نظامك يستقبل إشعار البوابة (Webhook) ويعلّم الطلب كمدفوع حتى لو لم يعد العميل إلى موقعك.
- اختبر الاسترداد الكامل والجزئي من لوحة التحكم.
- بعد التشغيل، نفّذ عملية حقيقية صغيرة بكل طريقة ثم استردها.
أخطاء شائعة
- التعامل مع مدى كفيزا أو ماستركارد في نموذج بطاقة مخصص.
- نسيان توثيق نطاق أو نطاق فرعي جديد لـApple Pay.
- اعتماد صفحة العودة لتأكيد الدفع بدل إشعار الخادم.
- ترك مفاتيح الاختبار في نسخة التشغيل الفعلي.
ماذا نقدّم؟
نربط بوابات الدفع بالمتاجر والتطبيقات وأنظمة الحجز، بما فيها مدى وApple Pay وSTC Pay والتقسيط، ونختبر كل مسار قبل الإطلاق. اطّلع على خدمة ربط بوابات الدفع، أو تواصل معنا لمناقشة مشروعك.