EN

Webhooks

الإشعارات الفورية (Webhooks)

يتيح نظام الـ Webhooks (أو IPN) إشعار خادمك فوراً عند تغيّر حالة الدفع، مما يضمن تحديث الطلبات حتى إن أغلق العميل المتصفّح.

الإعداد

  1. انتقل إلى لوحة تحكم التاجر.
  2. افتح قسم بيانات اعتماد API.
  3. أدخل 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 فوراً عند استلام الإشعار لتأكيد الاستلام.