تكوين إشعارات الويب (Webhook Configuration)

الموقع:الإعدادات ← المدفوعات ← Webhook

تسمح Webhooks لـ QuantaPay بإعلام الخادم الخاص بك في الوقت الفعلي عند إتمام عملية الدفع.

الحقول

الإعداد

1. أدخل عنوان URL لنقطة نهاية webhook الخاصة بك (على سبيل المثال،https://yoursite.com/webhook/quantapay)
2. يتم إنشاءمفتاح Webhook السريتلقائيًا. انقر فوق زر التحديث لإعادة الإنشاء إذا لزم الأمر.
3. احفظ الإعدادات.

كيف يعمل

عند إتمام عملية الدفع (الحالةC)، ترسل QuantaPay طلب HTTP POST إلى عنوان URL الخاص بـ Webhook الخاص بك مع:

• نص JSON يحتوي على{ "key": "your-secret", "transaction": { ... } }
• تحقق من أن حقلkeyيطابق مفتاح Webhook السري الخاص بك لتأكيد الأصالة

للحصول على تنسيق حمولة webhook الكامل، وكود التحقق من التوقيع، وأفضل الممارسات، راجعمرجع API: Webhooks.

الاختبار

لاختبار webhook الخاص بك:

1. قم بإنشاء جلسة دفع تجريبية عبر API
2. أكمل دفعة صغيرة
3. تحقق من سجلات الخادم الخاص بك بحثًا عن webhook الوارد

نصيحة: استخدم خدمة مثلwebhook.siteأثناء التطوير لفحص حمولات webhook الواردة.