الويب هوك

ترسل NMA Pay تحديثات لحظية عبر طلبات HTTP POST إلى الرابط المسجَّل لديك. اعتمد على الحقلين status و type معاً لتحديد ما إذا كانت العملية قيد التنفيذ أو مكتملة أو فاشلة.

الحالات الوسيطة

الحالات الوسيطة تعني أن العملية لم تُحسم بعد. لا تعتبر الدفع ناجحاً أو فاشلاً قبل استلام التحديث النهائي.

{
  "transactionId": "c3ece452-564a-4d29-97c2-25aba8b3f0eb",
  "orderId": "8179228",
  "amount": 100.0,
  "currencyCode": "682",
  "cardScheme": "MasterCard",
  "status": "Redirect",
  "channel": "Payment Gateway",
  "type": "Purchase",
  "createdAt": "2026-04-02T13:58:04.404837",
  "merchantId": "7da313e4-5424-4527-befc-53d81c977b1f",
  "pgDetails": { "reason": null }
}

التعامل الآمن

• أعد استجابة 200 خلال بضع ثوانٍ، وعالج المنطق بشكل غير متزامن.
• تعامل مع التكرار: قد يصل نفس الحدث أكثر من مرة — استخدم transactionId كمفتاح إفراد.
• تحقّق دائماً من المبلغ والعملة مقابل طلبك قبل تسليم المنتج.
• استخدم سجل الويب هوك في لوحة التحكم لإعادة إرسال الأحداث الفاشلة.