إعداد مستمع الويب هوك (Webhook Listener)
عند إتمام عملية دفع مطابقة لمبلغ الفاتورة بنجاح، يرسل الخادم طلب HTTP POST محمل ببيانات العملية إلى خادمك. يجب فحص مفتاح الـ API للتحقق من هوية المرسل.
// Node.js Express Webhook Handler
app.post('/api/racore-webhook', express.json(), (req, res) => {
const { amount, sender, api_key, id } = req.body;
// 1. التحقق من مفتاح الـ API الأمني
if (api_key !== process.env.RACORE_API_KEY) {
return res.status(401).send('فشل المصادقة');
}
// 2. تحديث حالة الطلب في قاعدة بياناتك
console.log(`تم استلام ${amount} ج.م من ${sender} برقم معاملة ${id}`);
res.status(200).json({ status: 'success', message: 'تم التحديث' });
});عناصر وهيكل الـ JSON للويب هوك
| الحقل | النوع | الشرح |
|---|---|---|
| id | String (UUID) | معرف المعاملة الفريد المولد بالشبكة. |
| amount | Float | قيمة التحويل المالي (مثال: 150.00). |
| sender | String | اسم الشخص الراسل من إشعار الموبايل. |
| api_key | String | مفتاح الـ API الخاص ببوابتك لتوثيق المصدر. |
أقسام التوثيق
- • إعداد مستمع الويب هوك
- • معايير الأمان والحقن البرمجي
- • تخصيص واجهة الـ Widget بالـ CSS
- • الربط التلقائي مع شوبيفاي (Shopify)
- • إرسال البيانات المرتجعة لأيزي أوردر
تحتاج مساعدة فنية؟
يتواجد خبراء الدعم الفني لدينا على مدار الساعة لمساعدتك في الربط وتخصيص الكود.
تواصل مع خبير