مرجع الأحداث

كل نوع حدث يمكن لـ 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 بتسليم جزئي.