ابدأ بمدى وApple Pay، ثم أضف تابي وتمارا إذا كانت منتجاتك وسياستك مؤهلة للدفع الآجل. نفّذ الربط عبر بوابة تدعم الوسائل المطلوبة، لكن لا تؤكد الطلب من صفحة الرجوع وحدها: تحقّق من الخادم وwebhook، اختبر الدفع والاسترداد والفشل بعمليات حقيقية منخفضة القيمة، واترك الرسوم حسب اتفاقك مع كل مزود.
لماذا يحتاج المتجر السعودي أكثر من زر بطاقة؟
يفشل الدفع عندما لا يجد العميل وسيلته المعتادة أو عندما تطلب منه الصفحة كتابة بيانات كان يستطيع اعتمادها من هاتفه. لذلك لا تُعامل مدى والمحافظ والدفع الآجل كزينة في صفحة السداد. كل وسيلة تحل عائقاً مختلفاً: مدى تغطي بطاقة الخصم المحلية، وApple Pay يقلل خطوات الإدخال على جهاز مؤهل، وتابي وتمارا يقسمان قيمة الشراء للعملاء المقبولين.
توضح النشرة الإحصائية للبنك المركزي السعودي أن معاملات التجارة الإلكترونية ببطاقات مدى بلغت نحو 1.77 مليار عملية في 2025. الرقم يجعل دعم مدى قراراً تجارياً أساسياً لمتجر يخدم السعودية، لا إضافة مؤجلة إلى ما بعد الإطلاق.
أما أثر الدفع الآجل على التحويل فلا ينبغي تحويله إلى وعد ثابت. قد يقلل عبء الدفع الفوري ويرفع إتمام السلال الأعلى قيمة، لكنه قد لا يناسب سلعة منخفضة السعر أو هامشاً ضيقاً. قِس القبول وإتمام الشراء ومتوسط السلة وصافي الربح بعد تكلفة المزود والمرتجعات.
مقارنة وسائل الدفع ومتطلبات تفعيلها
تختلف البوابات والعقود والمنتجات المدعومة بمرور الوقت. يوضح الجدول مساراً عملياً للتحقق، لا قائمة اعتماد دائمة:
وسيلة الدفع | أثرها المتوقع على إتمام الشراء | متطلبات التفعيل | بوابات أو مسارات تتوفر عبرها |
مدى | يزيل رفض عميل يعتمد بطاقة الخصم المحلية | كيان وحساب تجاري، موافقة مزود، ريال سعودي، 3DS وإعداد بوابة | Moyasar وTap وHyperPay وأشباهها بعد تأكيد المنتج |
Apple Pay | يقلل إدخال البطاقة على الأجهزة والمتصفحات المدعومة | مزود داعم، HTTPS، تحقق النطاق، إعداد merchant/certificates حسب نموذج المزود | Moyasar وTap وAmazon Payment Services وأشباهها |
تابي | يقلل عبء الدفع الفوري للعميل المؤهل وقد يدعم السلال الأعلى | قبول تجاري، مفاتيح اختبار وإنتاج، بيانات طلب وعميل، webhooks | تكامل مباشر أو إضافة معتمدة، ويتوفر أيضاً عبر منتجات مثل Tap حسب العقد |
تمارا | يقدم تقسيماً أو دفعاً لاحقاً وفق قرار الأهلية لدى المزود | حساب تاجر مقبول، tokens، جلسة checkout، capture/refund وwebhooks | تكامل مباشر أو إضافة معتمدة، ويتوفر عبر منتجات مثل Tap حسب العقد |
لا تفترض أن ظهور شعار على موقع البوابة يعني تفعيله تلقائياً لحسابك. قد يتطلب كل مصدر دفع عقداً منفصلاً، ونوع نشاط مقبولاً، وحدود سلة أو دولاً وعملات معينة. احصل على موافقة مكتوبة وبيانات sandbox قبل تقدير موعد الإطلاق.
ربط مدى: التدفق الذي يجب أن يعمل
تستقبل البوابة طلب إنشاء عملية بقيمة الريال السعودي ورقم طلب فريد وعناوين الرجوع والإشعار. وقد تعرض نموذجاً مستضافاً أو مكوناً داخل صفحة المتجر. بعد اعتماد العميل، تعيد البوابة حالة أولية، ثم يجب على خادم المتجر استرجاع العملية من API أو تأكيد إشعار موثق قبل نقل الطلب إلى “مدفوع”.
تذكر وثائق Moyasar دعم مدى وVisa وMastercard وApple Pay على الويب، بينما توضح وثائق Tap لمدى أن العملة هي SAR وأن مدى يظهر في الحلول المستضافة عند تفعيله. استخدم توثيق النسخة التي تعاقدت عليها؛ لا تنقل حقولاً من مزود إلى آخر.
أخطاء مدى المتكررة تشمل إرسال مبلغ عشري بتنسيق خاطئ، وتكرار الطلب بعد تحديث الصفحة، واعتبار redirect دليلاً نهائياً، وعدم مطابقة مبلغ البوابة مع مبلغ السلة. استخدم idempotency إن وفره المزود، وثبّت مرجعاً فريداً، وسجل الاستجابة من دون تخزين بيانات بطاقة حساسة.
تفعيل Apple Pay على الويب
أسهل مسار غالباً هو استخدام SDK أو صفحة دفع لدى مزود يدعم Apple Pay في السعودية. وتدرج Apple مزودين متاحين للسعودية من بينهم Moyasar وTap وAmazon Payment Services (Payfort) وCheckout.com وSalla. يبقى التفعيل خاضعاً لعقد المزود وحساب التاجر.
في الربط المباشر، تتطلب وثائق Apple Pay على الويب موقعاً عبر HTTPS، ومعرّف تاجر وشهادات والتحقق من النطاق. كما تنبه Apple إلى إضافة شبكة mada للمتاجر السعودية التي تدعم بطاقات الخصم، وإلا قد تتعذر بعض البطاقات السعودية عند استخدام رمز الدولة SA.
اختبر ظهور الزر على جهاز مدعوم وعدم ظهوره حين لا تتوافر الخدمة. اختبر التحقق من النطاق، ومبلغ الضريبة والشحن في ورقة الدفع، والإلغاء، والرفض، وتجدد الشهادات. لا تعرض زراً لا يعمل على كل صفحات النطاق الفرعي المطلوب.
إذا أردت تنفيذاً يبدأ من 990 ر.س لبوابة واحدة ووسيلتي دفع ضمن متجر جاهز، اطلب من فريق CloudTopia تقييماً عبر واتساب. السعر المقترح لا يشمل رسوم المزود أو حساباته، ويتغير عند وجود اشتراكات أو marketplace أو ربط ERP.
تركيب تابي: الجلسة ليست طلباً مدفوعاً
يبدأ التكامل بعد قبول حساب التاجر ومنح مفاتيح البيئة. يرسل الخادم بيانات السلة والعميل والعناوين والمرجع، ثم ينشئ جلسة ويوجه العميل إلى صفحة تابي. عند الرجوع، لا تجعل نجاح الرابط وحده يطلق الشحن؛ استعلم عن العملية واعتمد webhook الموثق.
توضح وثائق webhooks لدى تابي أن الإشعارات غير متزامنة، وقد تصل بترتيب مختلف أو تتكرر. لذلك يجب أن تكون المعالجة idempotent: الحدث نفسه لا ينشئ طلباً ثانياً ولا يخصم المخزون مرتين. تحقق من المصادقة، أعد استجابة سريعة، ثم عالج الحدث في طابور داخلي.
اعرض رسائل تابي الترويجية وفق إرشادات العلامة، لكن لا تعرض خياراً لبلد أو عملة أو قيمة غير مدعومة لحسابك. خزّن معرف الدفع بجوار رقم الطلب، واربط الالتقاط بالشحن، والاسترداد بالمرتجع. افصل بين “مرفوض من تابي” و“خطأ تقني” حتى يعرف الدعم ماذا يقول للعميل.
تركيب تمارا: حالات الطلب أولاً
توفر تمارا sandbox وبيانات اعتماد منفصلة قبل الإنتاج. وفق المرجع الرسمي لبدء API، يحصل التاجر على API token وNotification token ومفتاح عام للواجهات الترويجية. تحفظ الأسرار في الخادم أو مدير أسرار، ولا توضع في JavaScript المكشوف.
يعيد إنشاء checkout معرفات مثل order_id ورابط الدفع. بعد موافقة العميل تأتي مرحلة التفويض، ثم يرسل المتجر capture عند الشحن أو التنفيذ حسب التدفق. وتوضح وثيقة الدفع الإلكتروني لتمارا أن الإلغاء يختلف عن الالتقاط، وأن الاسترداد يأتي بعد الالتقاط؛ لذلك يجب أن تعكس لوحة الطلبات هذه الحالات بدقة.
الخطأ الشائع هو اعتبار approved مساوياً لكل المراحل، أو التقاط المبلغ قبل تلبية الطلب، أو عدم تحديث تمارا عند الإلغاء الجزئي. اختبر الكميات والخصومات والضريبة والشحن، واحفظ جميع معرفات capture وrefund للمطابقة المالية.
هندسة واحدة لأربع وسائل
لا تكتب منطقاً منفصلاً عشوائياً داخل صفحة checkout. ابنِ طبقة دفع تحول حالات كل مزود إلى حالات داخلية واضحة مثل pending, authorised, paid, failed, cancelled, partially_refunded وrefunded. احتفظ بالحمولة الخام المسموح بها لأغراض التشخيص، مع إخفاء الأسرار والبيانات الحساسة.
نفّذ المسار بهذا الترتيب:
- أنشئ الطلب داخلياً بحالة انتظار ومرجع لا يتكرر.
- أنشئ جلسة الدفع على الخادم بالمبلغ المحسوب من قاعدة البيانات.
- وجّه العميل إلى الواجهة أو افتح الوسيلة المدعومة.
- استقبل الرجوع لعرض النتيجة من دون اعتمادها وحدها.
- استقبل webhook وتحقق من توقيعه ومن معرف العملية.
- استعلم من API عند الشك وطابق المبلغ والعملة والمرجع.
- حدّث الطلب مرة واحدة وشغّل المخزون والفاتورة والتنبيه.
- سجّل الالتقاط والإلغاء والاسترداد والمطابقة المالية لاحقاً.
هذا التصميم يسمح بتبديل بوابة أو إضافة وسيلة من دون إعادة بناء الطلبات والمخزون من الصفر.
الاختبار الذي يسبق التشغيل الفعلي
اختبار sandbox ضروري لكنه لا يكشف كل إعدادات الإنتاج. بعد موافقة التاجر وتفعيل المفاتيح الحية، نفّذ عمليات منخفضة القيمة ببطاقة مدى حقيقية مؤهلة وApple Pay وجهاز مدعوم، ثم نفّذ إلغاءً واسترداداً كاملاً وجزئياً حيث يسمح المزود. استخدم حسابات اختبار رسمية لبيئات تابي وتمارا، ثم تحقق من الإنتاج وفق تعليمات كل فريق.
اختبر أيضاً انقطاع الشبكة بعد الدفع، وتحديث صفحة الرجوع، ووصول webhook مرتين، ووصوله قبل رجوع العميل، وتغير قيمة السلة، ونفاد المخزون، وفشل الفاتورة بعد نجاح الدفع. يجب أن يبقى المال والطلب قابلين للمطابقة في كل سيناريو.
تسلّم CloudTopia الربط بعد اختباره بعمليات حقيقية متفق عليها، مع سجل حالات ونتائج واسترداد، لا بمجرد ظهور الشعارات. ويحصل العميل على الكود المصدري بموجب العقد، وواجهة عربية RTL أصلية، وتسعير بالريال السعودي؛ وهذه أسباب عملية لاختيارها عند مقارنة منفذ الربط.
مؤشرات يجب مراقبتها بعد الإطلاق
راقب نسبة بدء الدفع إلى نجاحه لكل وسيلة، وأسباب الرفض التقنية، وزمن webhook، والطلبات المعلقة، والاستردادات، والفروق بين تقارير المتجر وتسوية المزود. لا تجمع كل حالات “غير ناجح” في رقم واحد؛ الإلغاء من العميل يختلف عن timeout وعن رفض المخاطر.
راجع أسبوعياً في البداية:
- راقب معدل الإتمام لكل وسيلة وجهاز ومتصفح.
- راقب الطلبات المعلقة التي لا تصل إلى حالة نهائية.
- راقب تكرار webhooks ومحاولات المعالجة الفاشلة.
- راقب فروق المبلغ والعملة والضريبة والتسوية.
- راقب انتهاء شهادات Apple Pay ومفاتيح البيئات.
يجب أن يطابق تقرير التسوية معرف المزود بمرجع الطلب والفاتورة والاسترداد. من دون هذه الصلة، قد تبدو المبيعات صحيحة في لوحة المتجر بينما يختلف المبلغ المحول فعلياً.
الأسئلة الشائعة
كيف أضيف مدى لمتجري؟
اختر بوابة تدعم مدى لحساب تاجر سعودي، وأكمل التحقق والعقد والحساب البنكي، ثم اربط SDK أو صفحة الدفع بمفاتيح الاختبار. أرسل المبلغ بالريال ومرجعاً فريداً، وتحقق من النتيجة على الخادم وwebhook. اختبر النجاح والرفض والتكرار والاسترداد فعلياً قبل تفعيل الإنتاج.
هل تابي وتمارا ترفع المبيعات فعلاً؟
قد تقللان عبء الدفع الفوري وتساعدان على إتمام سلال أعلى لدى العملاء المؤهلين، لكن الأثر ليس مضموناً لكل متجر. قس التحويل ومتوسط السلة وهامش الربح والمرتجعات قبل وبعد التفعيل، وافصل النتائج حسب الوسيلة. احسب رسوم المزود وفق عقدك بدلاً من مقارنة الإيراد الإجمالي وحده.
ما شروط تفعيل Apple Pay؟
تحتاج بوابة أو مزوداً يدعم Apple Pay في السعودية، وحساب تاجر مقبولاً، وموقعاً آمناً عبر HTTPS. بحسب نموذج الربط قد تحتاج merchant ID وشهادات والتحقق من كل نطاق يعرض الزر. أضف شبكة مدى للبطاقات المحلية، واختبر جهازاً ومتصفحاً مدعومين وتجدد الشهادات.
هل أحتاج حساباً بنكياً تجارياً؟
يطلب مزودو الدفع عادة حساباً بنكياً تجارياً مطابقاً للكيان كي يحولوا التسويات، إلى جانب السجل أو الترخيص وبيانات المالك وسياسات المتجر. قد تختلف التفاصيل حسب النشاط والبوابة وخدمة الدفع الآجل. اطلب قائمة onboarding رسمية ولا تستخدم حساباً شخصياً بديلاً من دون موافقة مكتوبة.
اجعل أول عملية حقيقية جزءاً من التسليم
لا تعتمد الربط لأنه نجح في شاشة تجريبية. وثّق عملية حية منخفضة القيمة، وظهورها في الطلب والتسوية، ثم اختبر الاسترداد. للحصول على تنفيذ اقتصادي مع سجل اختبار وتسليم للكود، راسل فريق CloudTopia مباشرة على واتساب.
اقرأ أيضاً
هل تحتاج إلى موقع ويب، لوحة معلومات، أو نظام أعمال مثل هذا؟
كلاود توبيا تساعدك في تحويل فكرتك إلى حل رقمي قابل للتوسع.
شارك هذا المقال
كُتب بواسطة
Mohamad Shahm | محمد شـهم
أسس محمد شهم شركة كلاود توبيا بعد مدة طويلة من بناء منصات الويب، وأنظمة التجارة الإلكترونية، للأفراد والشركات. محمد شهم يكتب أيضًا مقالات عن القرارات الهندسية والتجارية وراء إطلاق برمجيات يستخدمها الناس فعلاً.
