التعريف المختصر
متجرك لا يتحدث مع البنوك مباشرة، ولا يجب أن يحفظ أرقام البطاقات أصلًا. بوابة الدفع تقف في المنتصف: صفحة أو نموذج آمن يكتب فيه العميل بياناته، وخادم يتواصل مع الشبكات، ولوحة تحكم ترى فيها العمليات والاستردادات والتحويلات.
شرح مبسط
هذا ما يحدث في ثوانٍ حين يضغط العميل «ادفع» ببطاقة مدى:
إنشاء العملية
خادم متجرك يطلب من البوابة إنشاء عملية بمبلغ محدد، مستخدمًا المفتاح السري.
إدخال البيانات
العميل يكتب بيانات البطاقة في نموذج البوابة لا في نموذج متجرك، فلا تمر الأرقام على خادمك.
التحقق
يصل العميل رمز تحقق من بنكه (3D Secure) ليؤكد أنه صاحب البطاقة.
الموافقة
البنك المصدر يوافق أو يرفض، والبوابة تعيد النتيجة إلى متجرك.
الإشعار
البوابة ترسل إلى خادمك إشعارًا تلقائيًا (Webhook) بحالة العملية، وهو المصدر الموثوق لتأكيد الطلب.
code POST /api/payments/webhook { "id": "pay_8f21", "status": "paid", "amount": 34500, "currency": "SAR" }التسوية
بعد أيام عمل يحددها العقد، يُحول المبلغ ناقص الرسوم إلى حسابك البنكي.
لاحظ أن المبلغ في المثال 34500 وليس 345: كثير من البوابات تحسب بالهللة، أي أصغر وحدة للعملة. خطأ في هذه النقطة يجعل العميل يدفع جزءًا من مئة من السعر أو مئة ضعفه.
عند المقارنة بين البوابات اسأل عن: طرق الدفع المدعومة، ورسوم كل طريقة (رسوم مدى تختلف عادةً عن البطاقات الدولية)، ومدة التسوية، ووجود وضع اختبار، وجودة لوحة الاستردادات.
مثال من السوق السعودي
متجر عبايات إلكتروني في الدمام يبيع لعميلات داخل المملكة. أغلب العميلات يدفعن بمدى أو Apple Pay من الجوال، وبعضهن يفضلن التقسيط. اختار المتجر بوابة مرخصة تدعم مدى و Apple Pay، وأضاف خيار «اشترِ الآن وادفع لاحقًا» عبر مزود منفصل. قبل الإطلاق جرب كل السيناريوهات في وضع الاختبار: دفع ناجح، بطاقة مرفوضة، عميلة أغلقت الصفحة قبل رمز التحقق، واسترداد جزئي لعباءة مرتجعة. وجعل تأكيد الطلب يعتمد على إشعار البوابة لا على وصول العميلة لصفحة «شكرًا»، لأن بعضهن يغلقن التطبيق مباشرة بعد الدفع. التفاصيل العملية لربط مدى في دليل ربط مدى، ومقارنة البوابات في بوابات الدفع السعودية.
كيف يظهر في أوترا
في أوترا توصل مشروعك بخدمة دفع عبر مفتاحها: تضيف المفتاح في «البيانات السرية»، وتطلب الربط بالمحادثة، فيبقى المفتاح محميًا خارج المحادثة والكود. ومن الأسماء الجاهزة STRIPE_SECRET_KEY. وإن أردت أن تشرح لك أوترا صفحة في لوحة بوابة الدفع وأنت مسجل الدخول فيها، تستطيع أن تريها لها عبر «فقاعة أوترا»، وكل خطوة تنتظر موافقتك، وحقول كلمات المرور لا تُقرأ.
اربط متجري ببوابة دفع تدعم مدى و Apple Pay في وضع الاختبار أولًا، واجعل تأكيد الطلب يعتمد على إشعار البوابة، واطلب مني المفاتيح عبر النموذج الآمن.
مصطلحات ذات صلة
- API: الطريقة التي يتحدث بها متجرك مع البوابة.
- المتغيرات السرية: حيث يُحفظ المفتاح السري للبوابة.
- SSL: شرط لأي صفحة فيها دفع.
- الفاتورة الإلكترونية: ما يجب إصداره بعد كل عملية بيع ناجحة.