وبهوکها — اعلانهای آنی رویدادهای پرداخت
اپلیکیشن شما بهصورت آنی
از پرداختها مطلع میشود
نیراپی لحظهای که یک رویداد پرداخت رخ میدهد، اعلانهای HTTP POST بهصورت لحظهای به سرور شما ارسال میکند. بدون polling، بدون تأخیر — فقط وبهوکهای آنی و قابل اطمینان همراه با تلاش مجدد خودکار در صورت خطا و راستیآزمایی امضای HMAC برای حفظ امنیت یکپارچهسازی شما.

هر آنچه در یک سیستم وبهوک
زیرساخت وبهوک در سطح محیط اصلی، مستقیماً درون نیراپی ساخته شده — بدون نیاز به سرویسهای شخص ثالث.
تحویل لحظهای
رویدادها در عرض چند میلیثانیه پس از تأیید پرداخت در زنجیره به endpoint شما ارسال میشوند. نیازی به polling نیست.
راستیآزمایی امضای HMAC
هر payload وبهوک با HMAC-SHA256 امضا میشود. امضا را در سرور خود راستیآزمایی کنید تا از اصالت آن مطمئن شوید.
تلاش مجدد خودکار
اگر سرور شما بهطور موقت در دسترس نباشد، نیراپی با backoff نمایی تحویل را دوباره تلاش میکند — هیچ رویدادی از دست نمیرود.
پیکربندی بهازای هر درگاه
برای هر درگاه پرداخت یک URL وبهوک جداگانه پیکربندی کنید. ایزولاسیون کامل بین محصولات و مشتریان شما.
انواع متعدد رویداد
در رویدادهای payment_confirmed، payment_expired، withdrawal_completed و بیشتر مشترک شوید — فقط آنچه نیاز دارید.
لاگهای تحویل
تاریخچه کامل تحویل وبهوک با بدنه درخواست، کد پاسخ و timestamp — اشکالزدایی آسان از داشبورد شما.
وبهوکها چگونه کار میکنند
چهار گام ساده از پرداخت تا اطلاعرسانی به سرور شما — همگی در کمتر از یک ثانیه.
URL وبهوک خود را تنظیم کنید
در تنظیمات درگاه خود، endpoint HTTPS سرور خود را که نیراپی باید رویدادها را به آن ارسال کند وارد کنید.
مشتری پرداخت را انجام میدهد
یک مشتری پرداخت رمزارز را از طریق درگاه نیراپی شما تکمیل میکند.
نیراپی رویداد را ارسال میکند
نیراپی فوراً یک payload JSON امضاشده به URL شما POST میکند که رویداد پرداخت را توصیف میکند.
سرور شما پاسخ میدهد
امضای HMAC را راستیآزمایی کنید، رویداد را پردازش کنید (مثلاً سفارش را پردازش کنید) و HTTP 200 برگردانید.
راستیآزمایی یک وبهوک در چند ثانیه
// 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همین امروز دریافت رویدادهای وبهوک را آغاز کنید
URL وبهوک خود را در چند دقیقه راهاندازی کنید. اعلانهای لحظهای، تلاش مجدد خودکار و راستیآزمایی HMAC — همگی بدون هزینه اضافی.
تمامی حقوق ۱۴۰۴ نیراپی محفوظ است.
