Webhooks
الإشعارات الفورية (Webhooks)
يتيح نظام الـ Webhooks (أو IPN) إشعار خادمك فوراً عند تغيّر حالة الدفع، مما يضمن تحديث الطلبات حتى إن أغلق العميل المتصفّح.
الإعداد
- انتقل إلى لوحة تحكم التاجر.
- افتح قسم بيانات اعتماد API.
- أدخل Webhook URL واحصل على Webhook Secret.
التحقق الأمني
لضمان أن الإشعار قادم من Sela، نرسل توقيعاً رقمياً في ترويسة X-Sela-Signature. يجب عليك التحقق من هذا التوقيع.
مثال للتحقق (PHP)
$payload = file_get_contents('php://input');
$receivedSignature = $_SERVER['HTTP_X_SELA_SIGNATURE'];
$webhookSecret = 'your_webhook_secret_here';
// احسب التوقيع المتوقّع باستخدام HMAC SHA256
$calculatedSignature = hash_hmac('sha256', $payload, $webhookSecret);
if (hash_equals($calculatedSignature, $receivedSignature)) {
// ✅ التوقيع صالح
// عالج الطلب وحدّث حالة الطلب في قاعدة بياناتك
} else {
// ❌ التوقيع غير صالح
// تجاهل الطلب
}
هيكل البيانات (Payload)
ستستقبل طلب POST يحتوي على JSON بالصيغة التالية:
{
"event": "payment.success",
"type": "QR_PAY",
"transaction_id": "ABC123XYZ789",
"token": "ABC123XYZ789",
"trx_ref": "REF_456789",
"status": "success",
"gateway": "MOAMALAT",
"amount": 100.00,
"currency": "LYD",
"timestamp": "2024-01-12 14:30:00"
}
الأحداث
- payment.success: تم استلام الدفع بنجاح
[!IMPORTANT] يجب أن يستجيب خادمك بالرمز 200 OK فوراً عند استلام الإشعار لتأكيد الاستلام.