الحصول على خطافات الويب

يمكنك تكوين العناوين لإرسال إشعارات حول إضافة الدفعات في صفحة إعدادات المشروع.

يرجى ملاحظة أنه عند إرسال ويب هوك، يجب إرجاع الاستجابة التالية:

{
  "success": true
}

وإلا فسيستمر النظام في إعادة محاولة إرسال الويب هوك. الحد الأقصى لعدد المحاولات هو 30 مرة.

مثال على خطاف ويب لعملية إضافة دفع:

{
  "amount": "2.395", - قيمة الدفع بالدولار الأمريكي
  "created_at": "2025-03-17T12:57:52.449795Z", - وقت إنشاء الدفع
  "paid_at": "2025-03-17T12:57:19Z",- وقت تنفيذ الدفع
  "status": "completed", - حالة الدفع
  "transactions": {
    "amount": "0.02552778", - قيمة الدفع بالعملة الرقمية
    "amount_usd": "2.395", - قيمة الدفع بالدولار الأمريكي
    "bc_uniq_key": "0", - الرقم التسلسلي في المعاملة، مهم في شبكات مثل BTC، bc_uniq_key + tx_hash يمنح المعاملة تفرداً
    "blockchain": "litecoin", - اسم سلسلة الكتل
    "created_at": "2025-03-17T12:57:52.449795Z",- وقت إنشاء الدفع
    "currency": "LTC", - نوع العملة الرقمية
    "currency_id": "LTC.Litecoin", - معرف العملة الرقمية
    "tx_hash": "2be41b0cad76bc5699c3da5d5a1d390f9fb4038e5bfe49aec3b675f9dd4515fd", - تجزئة المعاملة
    "tx_id": "4bbc91fd-a950-4fd0-83f3-9f1c09a6b54f" - معرف المعاملة لدى التاجر
  },
  "type": "PaymentReceived",  - نوع الإشعار (Webhook)
  "wallet": {
    "id": "9a07b545-f99e-4f51-bf37-a84fcbe4df4d", - المعرف الداخلي للمستخدم
    "store_external_id": "1" - المعرف الخارجي للمستخدم
  }
}

التحقق من التماثل عند استلام Webhook

عند معالجة Webhooks الواردة، يجب ضمان التماثل (Idempotency) لتجنب معالجة نفس الحدث أكثر من مرة. لتحقيق ذلك، يجب استخدام الحقلين التاليين:

tx_hash — تجزئة محتوى الطلب أو الحدث؛
bc_uniq_key — معرف فريد للحدث يوفره مرسل Webhook.

قبل معالجة Webhook، يجب التحقق من أن تركيبة hash و uniq_key لم تتم معالجتها مسبقًا. إذا تم تسجيل مثل هذا الحدث، فيجب تجاهله كنسخة مكررة.