توثيق الويب هوكس

Wingezz webhooks let your system receive real-time HTTP notifications when order events happen in your account. Register a URL for each event type; we send a signed request with order data.

1. أضف رابط webhook واختر الإجراء (مثل order-create).
2. انسخ مفتاح التوقيع المعروض مرة واحدة — واحفظه بأمان على سيرفرك.
3. When the event occurs, Wingezz sends JSON to your URL with HMAC headers.
4. تحقق من التوقيع، ثم عالج بيانات الأوردر.
5. Return HTTP 2xx quickly; use Webhook Logs to debug deliveries.

ترويسات الطلب

Compute HMAC-SHA256 of the raw request body with your signing secret, then base64-encode the result. Compare with the X-Wingezz-Hmac-Sha256 header using a timing-safe comparison.

// PHP example
$secret = 'your_webhook_signing_secret';
$rawBody = file_get_contents('php://input');
$expected = base64_encode(hash_hmac('sha256', $rawBody, $secret, true));
$provided = $_SERVER['HTTP_X_WINGEZZ_HMAC_SHA256'] ?? '';
if (!hash_equals($expected, $provided)) {
    http_response_code(401);
    exit('Invalid signature');
}

If you do not configure a custom body mapping, the full default payload is sent:

{
  "event": "order-create",
  "sent_at": "2026-09-02T10:30:00+03:00",
  "order": {
    "id": 12345,
    "serial_no": "WNG-12345",
    "reference_no": "REF-001",
    "type": "Delivery",
    "status": "جديد",
    "status_en": "New",
    "customer_name": "Ahmed",
    "customer_phone": "201012345678",
    "govern": "Cairo",
    "area": "Nasr City",
    "cost": 150,
    "deliver_cost": 30,
    "source": "api",
    "created_at": "2026-09-02T10:00:00+03:00"
  }
}

You can define your own JSON keys and map them to order fields. Foreign keys are resolved to human-readable values (status name instead of status ID, governorate name instead of govern_id, etc.). Internal IDs and sensitive fields are never exposed.

You can also add custom HTTP headers (e.g. Authorization or X-Api-Key) from the webhook settings page. Wingezz signing headers are always set automatically and cannot be overridden.

Manage webhooks from your Wingezz dashboard under Webhooks, or from your trader profile settings.