جدول إعادة محاولة أسي من 6 مراحل
تؤدي الاستجابات غير 2xx إلى تفعيل إعادة محاولة تلقائية عند 30s → 2m → 10m → 1h → 6h → 24h، بالإضافة إلى إعادة الإرسال اليدوية بنقرة واحدة من داخل سجلات ويب هوك التاجر.
أحداث ويب هوك موحّدة لمدفوعات العملات الرقمية وهندسة تسليمها.
أتمت تنفيذ الطلبات وترقيات مقاعد SaaS وشحن أرصدة اللاعبين وإصدار تراخيص البرمجيات بمعيار ES256 عبر إشعارات موقّعة وغير متكررة بتقنية HMAC-SHA256 ويب هوك عبر جميع شبكات البلوكتشين الـ 12 المدعومة.
اختر نوع الحدث (9 أحداث قياسية)
ترويسات HTTP وحمولة حدث JSON
التحقق ثابت الزمن من HMAC-SHA256 (بـ 6 لغات)
معرّف event_id الفريد لعدم التكرار
خزّن event_id كمفتاح قاعدة بيانات UNIQUE قبل إضافة الأرصدة أو تسليم المنتجات الرقمية حتى لا تؤدي إعادة المحاولة إلى تكرار التنفيذ أبدًا.
مثبّت بـ TLS ومحصّن ضد SSRF
تفرض XPayr بروتوكول HTTPS الصارم، وحل عناوين IP العامة المثبّتة عبر DNS، وخيار CURLOPT_FOLLOWLOCATION=false، وترويسات طابع زمني بنافذة حماية من إعادة التشغيل مدتها 5 دقائق.
الأسئلة الشائعة حول الويب هوك والاستدعاءات
كيف أتحقق من أن الويب هوك صادر فعلاً من XPayr؟
احسب HMAC-SHA256 على نص طلب HTTP الخام غير المُحلَّل بالكامل باستخدام سر نقطة النهاية whsec_، وقارن البصمة السداسية عشرية بترويسة X-XPayr-Signature عبر دالة ثابتة الزمن مثل crypto.timingSafeEqual (في Node.js) أو hmac.compare_digest (في Python) أو hash_equals (في PHP).
ما الفرق بين payment.completed وpayment.underpaid_accepted؟
ينطلق الحدث payment.completed عندما يساوي التحويل على السلسلة مبلغ الفاتورة المحدد أو يتجاوزه. وينطلق payment.underpaid_accepted عندما تصل عملية سحب عبر رمز QR المباشر من المنصات ضمن حد تسامح XPayr البالغ 1% (بحد أقصى $0.50)، مع إظهار كلٍّ من requested_amount وreceived_amount ليبقى دفترك المحاسبي دقيقًا حتى آخر سنت.
كيف تتعامل XPayr مع توقف نقطة النهاية أو استجابات 5xx؟
أي استجابة خارج نطاق HTTP 200–299 (أو أبطأ من 10 ثوانٍ) تدخل طابور إعادة المحاولة الأسي في XPayr (30s، 2m، 10m، 1h، 6h، 24h) مع الحفاظ على نفس قيمة event_id تمامًا حتى يمنع جدول عدم التكرار (idempotency) الإضافة المزدوجة للرصيد.
ما قواعد أمان عناوين URL المطبّقة على نقاط نهاية ويب هوك التجار؟
يجب أن تستخدم وجهات الويب هوك الإنتاجية بروتوكول HTTPS عبر عناوين DNS/IP عامة قابلة للتوجيه مع شهادات TLS صالحة. وتحظر XPayr بروتوكول HTTP غير المشفّر ونطاقات RFC1918 الخاصة/الارتدادية وعناوين IP للبيانات الوصفية السحابية وعمليات إعادة التوجيه HTTP لمنع هجمات SSRF.