يُمثل توفير وسائل دفع إلكتروني محلية وموثوقة عصب التجارة الرقمية ومنصات الخدمات في المملكة العربية السعودية. وتشير البيانات إلى أن أكثر من 80% من المدفوعات الرقمية في السوق السعودي تتم عبر بطاقات مدى (Mada) وخدمة Apple Pay. في هذا الدليل البرمجي، نشرح كيفية ربط بوابات الدفع الإلكتروني المعتمدة بموقعك، وتكامل واجهات برمجة التطبيقات (APIs)، مع الالتزام بأعلى معايير الأمان وتشفير البيانات.
1. منظومة المدفوعات السعودية ومزودو الخدمة المعتمدون
ترتبط بوابات الدفع في المملكة بنظام “مدفوعاتكم” ومؤسسة النقد والبنك المركزي السعودي (SAMA). ومن أبرز بوابات الدفع المعتمدة:
- ميسر (Moyasar): بوابة دفع محلية متطورة توفر مكتبات برمجية مرنة لربط مدى، فيزا، ماستركارد، و Apple Pay.
- هايبرباي (HyperPay): مزود دفع إقليمي معتمد يقدم حلولاً واسعة للمنصات الكبيرة والتكامل المخصص.
- تاب للمدفوعات (Tap Payments): تدعم العمليات متعددة العملات والربط المباشر مع المنصات المختلفة.
2. المتطلبات التنظيمية والتقنية قبل البدء بالربط
- شهادة امتثال أمان بيانات بطاقات الدفع (PCI-DSS): تتطلب حماية بيانات بطاقات العملاء عدم تخزين أي أرقام بطاقات حساسة على خادم موقعك، والاعتماد على تقنية الترميز الآمن (Tokenization).
- تفعيل بروتوكول التشفير HTTPS و TLS 1.3: إلزامية اتصال مشفر عالي الأمان لحماية قنوات إرسال البيانات المالية.
- سجل تجاري وحساب بنكي تجاري نشط: مطلوب لتوقيع اتفاقية بوابة الدفع واستلام الرموز المفتاحية للـ API (API Keys).
3. خطوات الربط البرمجي لواجهة بوابة الدفع (API Integration)
أ. تهيئة طلب الدفع من جانب الخادم (Server-side Initialization)
يتم إرسال طلب آمن من خادم موقعك إلى بوابة الدفع لإنشاء جلسة دفع وتوليد رمز مشفر فريد (Transaction Token):
// مثال بلغة PHP لإنشاء جلسة دفع عبر API
$payload = [
'amount' => 50000, // المبلغ بالهللات (500 ريال)
'currency' => 'SAR',
'description' => 'فاتورة رقم #1042',
'callback_url' => 'https://yourwebsite.com/payment/callback',
'metadata' => ['order_id' => '1042']
];
$ch = curl_init('https://api.gateway.com/v1/payments');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERPWD, $apiKey . ':');
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
$response = curl_exec($ch);
curl_close($ch);ب. تفعيل تكامل Apple Pay المباشر
لتفعيل الدفع بنقرة واحدة عبر Apple Pay، يجب رفع ملف التحقق من النطاق (Apple Developer Domain Verification) في المسار:
https://yourwebsite.com/.well-known/apple-developer-merchantid-domain-associationثم التحقق من دعم المتصفح لـ Apple Pay عبر واجهة JavaScript:
if (window.ApplePaySession && ApplePaySession.canMakePayments()) {
// إظهار زر الدفع عبر Apple Pay في واجهة المستخدم
document.getElementById('apple-pay-button').style.display = 'block';
}ج. التحقق من صحة المعاملة عبر Webhooks
لضمان عدم اعتماد النتيجة فقط على إعادة توجيه المتصفح (التي قد تنقطع)، يجب إعداد نقطة نهاية (Webhook Endpoint) على خادمك تستقبل إشعار الدفع المشفر، وتتحقق من التوقيع الرقمي (Signature Verification) قبل تحديث حالة الطلب في قاعدة البيانات.
حلول التجارة الإلكترونية مع الخواطر الجزيرة
تقدم الخواطر الجزيرة للحلول الرقمية خدمات متقدمة في تصميم وتطوير مواقع ومتاجر التجارة الإلكترونية، مع ربط موثوق وآمن لكافة بوابات الدفع السعودية (مدى، Apple Pay، سداد، وخدمات الدفع الآجل تابي وتمارا)، مع توفير استضافة سحابية عالية الأمان تضمن الامتثال الكامل للمعايير الرقابية والتقنية في المملكة.