بقلم فريق مرحبا — آخر تحديث: 29 أغسطس 2026
ربط بوابة دفع الكتروني هو الخطوة التي تحول موقعك من واجهة عرض إلى متجر يستقبل أموالاً فعلية، ولهذا تتعامل معها البوابات البنكية بجدية: مستندات نظامية، مراجعة للموقع، ثم مفاتيح تقنية واختبارات قبل أول ريال. في هذا الدليل نمشي معك من الصفر بالترتيب الصحيح: ماذا تجهز قبل التقديم، أي بوابة تختار من البوابات العاملة في السعودية، وكيف تنفذ الربط تقنياً حتى أول عملية شراء ناجحة.
نقطة مهمة قبل البداية: هذا المقال للإعداد الأول من الصفر. أما لو كانت بوابتك مربوطة أصلاً ثم توقفت عن قبول المدفوعات، فمشكلتك تشخيص أعطال وليست إعداداً، وقد أفردنا لها دليلاً مستقلاً عن المتجر الذي لا يقبل الدفع الإلكتروني يفحص الأسباب واحداً واحداً.
ما المتطلبات قبل ربط بوابة دفع الكتروني في موقعك؟
البوابات لا تفعّل حساب تاجر لمجرد أنك طلبت. هي ملزمة نظامياً بالتحقق من هوية النشاط، ولذلك تحتاج ثلاثة أركان جاهزة قبل تعبئة أي نموذج تقديم:
أولاً، إثبات نظامي للنشاط: سجل تجاري ساري من وزارة التجارة، أو وثيقة عمل حر معتمدة لبعض الأنشطة الفردية. اسم النشاط في السجل يجب أن يطابق طبيعة ما تبيعه فعلاً في الموقع، لأن أي تعارض بينهما سبب مباشر لرفض الطلب أو تجميده. تفاصيل الجانب النظامي كاملة تجدها في دليلنا عن شروط إنشاء متجر إلكتروني في السعودية.
ثانياً، حساب بنكي تجاري: البوابة تحوّل مستحقاتك إلى حساب باسم المنشأة نفسها، لا إلى حسابك الشخصي. افتح الحساب التجاري قبل التقديم، لأن هذه أكثر نقطة يتعثر عندها أصحاب المشاريع الجدد.
ثالثاً، موقع جاهز بسياسات واضحة: فريق المراجعة في البوابة سيزور موقعك قبل الموافقة. يبحثون عن صفحات منشورة وواضحة: سياسة الاسترجاع والاستبدال، سياسة الخصوصية، الشروط والأحكام، وبيانات تواصل حقيقية. موقع بلا هذه الصفحات يعني تعليق التفعيل حتى استكمالها. ولو كنت ما زلت في مرحلة بناء المتجر نفسه، فابدأ من الأساس الصحيح مع دليل تصميم متجر إلكتروني ثم ارجع لهذه الخطوات.
هذا الجدول يلخص الرحلة كاملة، وما تحتاجه في كل خطوة، والخطأ الذي نراه يتكرر عند العملاء:
| الخطوة | ما تحتاجه | الخطأ الشائع |
|---|---|---|
| تجهيز المتطلبات النظامية | سجل تجاري ساري وحساب بنكي تجاري باسم المنشأة | التقديم بحساب بنكي شخصي فيُرفض الطلب |
| تجهيز الموقع وسياساته | صفحات استرجاع وخصوصية وشروط وبيانات تواصل منشورة | موقع بلا سياسات، فيتعلق التفعيل عند المراجعة |
| فتح حساب التاجر لدى البوابة | نموذج التقديم والمستندات ورابط موقعك | وصف نشاط مختلف عن نشاط السجل التجاري |
| استلام مفاتيح API | مفاتيح تجريبية ومفاتيح مباشرة من لوحة التاجر | وضع المفاتيح السرية في كود الواجهة الأمامية |
| تفعيل شهادة SSL | شهادة سارية وتحويل الموقع كاملاً إلى https | صفحة دفع تعمل على http فترفضها البوابة |
| الربط في البيئة التجريبية | بطاقات اختبار من توثيق البوابة الرسمي | الاكتفاء باختبار حالة النجاح وإهمال الفشل والإلغاء |
| الانتقال للبيئة المباشرة | استبدال المفاتيح وعملية شراء حقيقية صغيرة | الإطلاق بلا تجربة استرجاع مبلغ فعلية |
ما أشهر بوابات الدفع الإلكتروني العاملة في السعودية؟
السوق السعودي فيه عدة بوابات مرخصة ومجربة، وكلها تدعم الطرق الأساسية التي يتوقعها العميل المحلي: مدى، والبطاقات الائتمانية، وApple Pay. أبرز الأسماء التي نتعامل معها في مشاريع عملائنا:
- ميسر Moyasar: بوابة سعودية بتوثيق تقني عربي واضح، وتكامل مباشر مع مدى وApple Pay، وخيار شائع للمتاجر المبرمجة خصيصاً.
- تاب Tap Payments: بوابة خليجية منتشرة، تناسب من يخطط للبيع في أكثر من دولة خليجية بحساب واحد.
- باي تابس PayTabs: من أقدم البوابات العاملة في المنطقة، بجاهزية عالية للربط مع المنصات والأنظمة المختلفة.
- هايبر باي HyperPay: بوابة قوية في قطاع الشركات والمشاريع الكبيرة، وتدعم تشكيلة واسعة من طرق الدفع.
- جيديا Geidea: مزود سعودي يجمع بين الدفع الإلكتروني وأجهزة نقاط البيع، ويناسب من يبيع أونلاين وفي فرع فعلي معاً.
- خدمات أمازون للدفع Amazon Payment Services: الاسم الحالي لبايفورت سابقاً، وحاضرة بقوة في مشاريع المؤسسات.
انتبه لفرقين مهمين: مدى وApple Pay ليست بوابات مستقلة بل طرق دفع تصلك عبر البوابة التي تختارها، بينما تمارا وتابي خدمات تقسيط تُضاف بجانب البوابة لا بديلاً عنها. أما الرسوم ونسب العمولات فتتغير وتختلف حسب النشاط وحجم المبيعات، لذلك لا نكتب أرقاماً هنا: خذها دائماً من الموقع الرسمي لكل بوابة أو من عرض السعر الذي يصلك بعد التقديم، وقارن بنفسك.
كيف تختار بينها؟ قارن على أربعة محاور: دعم طرق الدفع التي يستخدمها جمهورك فعلاً وعلى رأسها مدى، جودة التوثيق التقني وسهولة الربط مع تقنية موقعك، سرعة تحويل المستحقات لحسابك البنكي، وسرعة استجابة الدعم الفني وقت المشاكل. ولو كان متجرك على منصة جاهزة مثل سلة أو زد فالبوابات تأتي شبه مدمجة من لوحة التحكم، أما المتجر المبرمج خصيصاً فيمنحك حرية اختيار أي بوابة والتحكم الكامل في تجربة الدفع، وهذا تحديداً ما نبنيه لعملائنا.
تبي بوابة دفع مربوطة صح من أول مرة؟ فريق مرحبا يبرمج المتاجر ويربط بواباتها منذ 2012، بكود تملكه بالكامل.
كيف تنفذ خطوات الربط العملية من حساب التاجر حتى الإطلاق؟
الخطوة 1: افتح حساب التاجر. قدّم عبر موقع البوابة الرسمي بالمستندات التي جهزتها: السجل التجاري، بيانات الحساب البنكي التجاري، ورابط موقعك المكتمل. اكتب وصف النشاط بدقة ومطابقاً للسجل، فالمراجعة البشرية تلتقط أي تعارض. بعد الموافقة تستلم دخولاً للوحة التاجر الخاصة بك.
الخطوة 2: استلم مفاتيح API وتعامل معها كأسرار. ستجد في اللوحة نوعين من المفاتيح: مفاتيح تجريبية للاختبار ومفاتيح مباشرة للأموال الحقيقية، ولكل نوع مفتاح معلن يظهر في المتصفح ومفتاح سري يبقى في السيرفر فقط. القاعدة الذهبية: المفتاح السري لا يوضع أبداً في كود الواجهة الأمامية ولا يُرفع لمستودع كود عام، لأن تسريبه يعني قدرة الغير على تنفيذ عمليات باسم متجرك.
الخطوة 3: أمّن الموقع بشهادة SSL. البوابات ترفض العمل على صفحات غير مشفرة، والمتصفحات تحذر زوارك منها أصلاً. فعّل الشهادة من استضافتك، وحوّل كل صفحات الموقع إلى https بتحويل دائم، وتأكد ألا يبقى أي محتوى محملاً عبر http داخل صفحة الدفع.
الخطوة 4: اربط واختبر في البيئة التجريبية. نفذ الربط بالمفاتيح التجريبية أولاً، واستخدم بطاقات الاختبار المنشورة في توثيق البوابة نفسها. لا تختبر النجاح فقط: جرّب بطاقة مرفوضة، ورصيداً غير كافٍ، وإغلاق صفحة الدفع في منتصف العملية، وتحقق أن التحقق الإضافي 3D Secure يظهر ويكتمل. تأكد كذلك أن إشعارات التأكيد الخلفية webhooks تصل لسيرفرك وتحدّث حالة الطلب تلقائياً، لأن الاعتماد على صفحة الشكر وحدها يضيع طلبات مدفوعة عند انقطاع اتصال العميل.
الخطوة 5: انتقل للبيئة المباشرة واختبر بمال حقيقي. استبدل المفاتيح التجريبية بالمباشرة في إعدادات السيرفر، ثم نفذ بنفسك عملية شراء حقيقية بأصغر مبلغ ممكن: ادفع بمدى وببطاقة ائتمانية وبApple Pay إن كنت تدعمها، وتأكد أن المبلغ ظهر في لوحة التاجر وأن الطلب تسجل في متجرك، ثم نفذ استرجاعاً فعلياً لنفس العملية وراقب وصول المبلغ. راجع أيضاً وصول المستحقات لحسابك البنكي في أول دورة تسوية.
قبل إعلان الإطلاق راجع قائمة أخيرة: الدفع يعمل من الجوال ومن الكمبيوتر، رسائل الفشل تظهر للعميل بالعربية بشكل مفهوم، فاتورة أو تأكيد يصل للعميل بعد الدفع، والمفاتيح التجريبية أزيلت نهائياً من الموقع الفعلي. وبعد الإطلاق راقب أول أسبوع يومياً، فأغلب المشاكل تظهر فيه. ولو مرّت الأيام ثم توقفت البوابة فجأة عن قبول الدفع، فارجع لدليل التشخيص المخصص لهذه الحالة بدل إعادة الربط من الصفر.
أسئلة شائعة عن ربط بوابة الدفع الإلكتروني
هل أقدر أربط بوابة دفع إلكتروني بدون سجل تجاري؟
البوابات العاملة في السعودية تطلب إثباتاً نظامياً للنشاط قبل التفعيل. بعض البوابات تقبل وثيقة العمل الحر المعتمدة للأنشطة الفردية بدل السجل التجاري، والتفاصيل تختلف من بوابة لأخرى. الأفضل استخراج السجل أو الوثيقة أولاً ثم التقديم، لأن الطلب بلا إثبات نظامي يُرفض غالباً.
ما المدة المتوقعة لتفعيل حساب التاجر؟
تختلف من بوابة لأخرى وتتأثر باكتمال ملفك: مستندات واضحة وموقع جاهز بسياسات منشورة يعني مراجعة أسرع، وأي نقص يعني جولات مراسلات إضافية. عملياً تتراوح بين أيام قليلة وأسابيع. أسرع طريق للتفعيل هو تجهيز كل المتطلبات قبل التقديم لا بعده.
ما الفرق بين البيئة التجريبية والبيئة المباشرة؟
البيئة التجريبية Sandbox نسخة كاملة من نظام البوابة لكن بأموال وهمية وبطاقات اختبار، والغرض منها تجربة الربط وكل الحالات بلا أي مخاطرة مالية. البيئة المباشرة Live هي التشغيل الفعلي بأموال حقيقية ومفاتيح مختلفة. القاعدة: لا تنتقل للمباشرة إلا بعد نجاح كل الاختبارات في التجريبية، ثم اختبر مرة أخيرة بعملية حقيقية صغيرة.
هل شهادة SSL إلزامية لربط بوابة الدفع؟
نعم، إلزامية عملياً. البوابات ترفض معالجة الدفع على صفحات غير مشفرة، والمتصفحات تعرض تحذير موقع غير آمن ينفّر العميل قبل أن يصل للدفع أصلاً. فعّل الشهادة من استضافتك وحوّل الموقع كاملاً إلى https قبل بدء الربط، وتأكد أن صفحة الدفع تحديداً خالية من أي محتوى محمّل عبر http.
هل الأفضل ربط بوابة واحدة أم أكثر؟
ابدأ ببوابة واحدة تدعم مدى والبطاقات وApple Pay، فهذا يغطي الغالبية العظمى من عملاء السوق السعودي ويبقي الصيانة والمحاسبة بسيطة. إضافة بوابة ثانية تصبح منطقية لاحقاً لحاجة محددة، مثل تفعيل التقسيط عبر تمارا أو تابي بجانب البوابة الأساسية، أو التوسع لدولة تحتاج مزوداً مختلفاً.
هل مدى وApple Pay بوابات دفع مستقلة؟
لا. مدى شبكة المدفوعات السعودية وApple Pay طريقة دفع من أجهزة آبل، وكلاهما يصل لمتجرك عبر بوابة الدفع التي تتعاقد معها. لذلك عند المفاضلة بين البوابات تأكد أن البوابة تدعم الطريقتين، لأن غياب مدى تحديداً يفقدك شريحة كبيرة من المشترين السعوديين.
ماذا أفعل لو توقفت بوابة الدفع عن العمل بعد الربط؟
هذه مشكلة تشخيص لا إعداد. ابدأ بفحص ثلاث نقاط: حالة حساب التاجر في لوحة البوابة فقد يكون معلقاً، صلاحية شهادة SSL فانتهاؤها يوقف الدفع فوراً، ثم سجلات الأخطاء في موقعك. وقد خصصنا مقالاً كاملاً لتشخيص حالة المتجر الذي لا يقبل الدفع الإلكتروني يمشي معك خطوة بخطوة حتى تحديد السبب.
كم تكلفة متجر إلكتروني خاص مع بوابة دفع مربوطة؟
في مرحبا يبدأ المتجر الخاص المبرمج خصيصاً من 30,000 ريال ويصل إلى 200,000 ريال حسب حجم المشروع ومتطلباته، وربط بوابة الدفع واختبارها جزء أساسي من التسليم، مع ملكية كاملة للكود. أما رسوم البوابة نفسها وعمولاتها على العمليات فهي علاقة مستقلة بينك وبين البوابة، وأرقامها الدقيقة تؤخذ من موقعها الرسمي.
