مرجع الأحداث
كل نوع حدث يمكن لـ Webhook الاشتراك فيه.
كل عملية تسليم تحمل ترويسة X-SamaPrime-Signature — بالشكل t=<unix_seconds>,v1=<hex hmac> — محسوبة كـ HMAC-SHA256(سر الـ Webhook الخاص بك، "{timestamp}.{raw_body}"). الطابع الزمني مدمج ضمن المحتوى الموقَّع نفسه، لا مرفقاً بجانبه فقط، حتى لا يمكن إعادة استخدام زوج توقيع/نص تم التقاطه بطابع زمني مختلف — تحقق منه بمقارنة آمنة زمنياً ونافذة تسامح معقولة (5 دقائق مثلاً).
ترويسة X-SamaPrime-Event تطابق حقل "type" في الحمولة نفسها، فتستطيع التوجيه دون تحليل النص أولاً.
| event | الوصف |
|---|---|
| order.completed | اكتمل طلب SMS أو SMM بنجاح. |
| order.failed | فشل طلب وتم رد المبلغ. |
| wallet.deposited | تم إضافة إيداع من العملات الرقمية إلى المحفظة. |
| card.transaction | عملية إنفاق أو رفض على بطاقة صادرة. |
| smm.order.completed | اكتمل طلب SMM بتسليم كامل. |
| smm.order.partial | اكتمل طلب SMM بتسليم جزئي. |