Webhooks — إشعارات أحداث دفع فورية
تطبيقك يعرف فوراً
متى تحدث المدفوعات
ترسل NiraPay إشعارات HTTP POST في الوقت الفعلي إلى خادمك في اللحظة التي يحدث فيها حدث دفع. لا اقتراع، لا تأخيرات، فقط webhooks فورية وموثوقة مع إعادة محاولة تلقائية عند الفشل والتحقق من توقيع HMAC للحفاظ على أمان تكاملك.

كل ما تحتاجه في نظام Webhook
بنية تحتية webhook بدرجة الإنتاج مبنية مباشرة في NiraPay، لا حاجة لخدمات طرف ثالث.
تسليم في الوقت الفعلي
تُدفع الأحداث إلى نقطة النهاية الخاصة بك خلال أجزاء من الثانية من تأكيد الدفع على السلسلة. لا حاجة للاقتراع.
التحقق من توقيع HMAC
كل حمولة webhook موقعة بـ HMAC-SHA256. تحقق من التوقيع على خادمك لضمان الأصالة.
إعادة محاولة تلقائية
إذا كان خادمك غير متاح مؤقتاً، تعيد NiraPay المحاولة بتراجع أُسي، لا أحداث مفقودة.
تكوين لكل بوابة
كوّن عنوان webhook منفصل لكل بوابة دفع. عزل كامل بين منتجاتك وعملائك.
أنواع أحداث متعددة
اشترك في payment_confirmed وpayment_expired وwithdrawal_completed والمزيد، فقط ما تحتاجه.
سجلات التسليم
سجل تسليم webhook كامل مع نص الطلب ورمز الاستجابة والطابع الزمني، تصحيح أخطاء سهل من لوحة التحكم.
كيف تعمل Webhooks
أربع خطوات بسيطة من الدفع إلى إشعار خادمك، كل ذلك في أقل من ثانية.
اضبط عنوان webhook الخاص بك
في إعدادات بوابتك، أدخل نقطة نهاية HTTPS على خادمك حيث ينبغي على NiraPay إرسال الأحداث.
العميل يقوم بدفعة
يكمل العميل دفعة عملات مشفرة عبر بوابة NiraPay الخاصة بك.
NiraPay ترسل الحدث
تقوم NiraPay فوراً بـ POST لحمولة JSON موقعة إلى عنوان URL الخاص بك تصف حدث الدفع.
خادمك يستجيب
تحقق من توقيع HMAC، عالج الحدث (مثلاً تنفيذ الطلب)، وأعد HTTP 200.
تحقق من webhook في ثوانٍ
// Node.js — Verify NiraPay webhook signature
import crypto from 'crypto';
app.post('/webhook', (req, res) => {
const signature = req.headers['x-nirapay-signature'];
const payload = JSON.stringify(req.body);
const expected = crypto
.createHmac('sha256', process.env.NIRAPAY_WEBHOOK_SECRET)
.update(payload)
.digest('hex');
if (signature !== expected) {
return res.status(401).send('Invalid signature');
}
const { event, data } = req.body;
if (event === 'payment_confirmed') {
// fulfil the order
fulfillOrder(data.order_id);
}
res.status(200).send('OK');
});
NiraPayابدأ باستقبال أحداث Webhook اليوم
أعد عنوان webhook الخاص بك في دقائق. إشعارات في الوقت الفعلي، إعادة محاولة تلقائية، والتحقق من HMAC، كل ذلك مضمّن بدون تكلفة إضافية.
٢٠٢٥ NiraPay. جميع الحقوق محفوظة.
