Webhooks الصادرة

const crypto = require("crypto");

function verifyWijhaSignature({ secret, timestamp, rawBody, signature }) {
  const expected = crypto
    .createHmac("sha256", secret)
    .update(`${timestamp}.${rawBody}`)
    .digest("hex");
  return crypto.timingSafeEqual(
    Buffer.from(expected, "utf8"),
    Buffer.from(signature, "utf8"),
  );
}

// Express example — keep the raw body for HMAC verification
app.post("/webhooks/wijha", express.raw({ type: "application/json" }), (req, res) => {
  const timestamp = req.get("X-Wijha-Timestamp");
  const signature = req.get("X-Wijha-Signature");
  const rawBody = req.body.toString("utf8");
  if (!verifyWijhaSignature({
    secret: process.env.WIJHA_WEBHOOK_SECRET,
    timestamp,
    rawBody,
    signature,
  })) {
    return res.status(401).send("invalid signature");
  }
  const event = JSON.parse(rawBody);
  // handle event.eventType + event.data / event.changes
  res.status(200).send("ok");
});

{
  "id": "del_01JABCXYZ",
  "event": "OrderCreated",
  "eventType": "OrderCreated",
  "storeId": "str_01JSTORE",
  "occurredAt": "2026-10-08T17:12:04.128Z",
  "data": {
    "order": {
      "id": "ord_01JABC",
      "storeId": "str_01JSTORE",
      "number": "10042",
      "channel": "portal",
      "status": "pending",
      "customerId": "cus_01JDEF",
      "customerName": "Ahmed Hassan",
      "customerPhone": "+201012345678",
      "shippingAddress": {
        "city": "Cairo",
        "line1": "12 Nile St",
        "phone": "+201012345678"
      },
      "lineItems": [
        {
          "productId": "prd_01J",
          "variantId": "var_01J",
          "sku": "TEE-BLK-M",
          "title": "Cotton tee",
          "qty": 2,
          "price": 225
        }
      ],
      "payment": { "method": "cod", "codAmount": 495, "currency": "EGP" },
      "totals": {
        "subtotal": 450,
        "shipping": 45,
        "total": 495,
        "currency": "EGP"
      },
      "createdAt": "2026-10-08T17:12:04.000Z"
    },
    "customer": {
      "id": "cus_01JDEF",
      "name": "Ahmed Hassan",
      "phone": "+201012345678",
      "email": "ahmed@example.com"
    }
  },
  "changes": {
    "aggregateType": "order",
    "aggregateId": "ord_01JABC"
  }
}

{
  "id": "del_01JABCXYZ",
  "event": "OrderCreated",
  "eventType": "OrderCreated",
  "storeId": "str_01JSTORE",
  "occurredAt": "2026-10-08T17:12:04.128Z",
  "data": {
    "order": {
      "id": "ord_01JABC",
      "storeId": "str_01JSTORE",
      "number": "10042",
      "channel": "portal",
      "status": "pending",
      "customerId": "cus_01JDEF",
      "customerName": "Ahmed Hassan",
      "customerPhone": "+201012345678",
      "shippingAddress": {
        "city": "Cairo",
        "line1": "12 Nile St",
        "phone": "+201012345678"
      },
      "lineItems": [
        {
          "productId": "prd_01J",
          "variantId": "var_01J",
          "sku": "TEE-BLK-M",
          "title": "Cotton tee",
          "qty": 2,
          "price": 225
        }
      ],
      "payment": { "method": "cod", "codAmount": 495, "currency": "EGP" },
      "totals": {
        "subtotal": 450,
        "shipping": 45,
        "total": 495,
        "currency": "EGP"
      },
      "createdAt": "2026-10-08T17:12:04.000Z"
    },
    "customer": {
      "id": "cus_01JDEF",
      "name": "Ahmed Hassan",
      "phone": "+201012345678",
      "email": "ahmed@example.com"
    }
  },
  "changes": {
    "aggregateType": "order",
    "aggregateId": "ord_01JABC"
  }
}

{
  "id": "del_01JPROD",
  "event": "ProductUpdated",
  "eventType": "ProductUpdated",
  "storeId": "str_01JSTORE",
  "occurredAt": "2026-10-08T16:40:00.000Z",
  "data": {
    "product": {
      "id": "prd_01J",
      "title": "Cotton tee",
      "status": "active",
      "price": 225,
      "currency": "EGP",
      "sku": "TEE-BLK-M"
    }
  },
  "changes": {
    "aggregateType": "product",
    "aggregateId": "prd_01J",
    "action": "updated"
  }
}

{
  "id": "del_01JCUS",
  "event": "CustomerCreated",
  "eventType": "CustomerCreated",
  "storeId": "str_01JSTORE",
  "occurredAt": "2026-10-08T15:05:22.000Z",
  "data": {
    "customer": {
      "id": "cus_01JDEF",
      "name": "Ahmed Hassan",
      "phone": "+201012345678",
      "email": "ahmed@example.com",
      "createdAt": "2026-10-08T15:05:22.000Z"
    }
  },
  "changes": {
    "aggregateType": "customer",
    "aggregateId": "cus_01JDEF"
  }
}

{
  "id": "del_01JSHIP",
  "event": "ShipmentCreated",
  "eventType": "ShipmentCreated",
  "storeId": "str_01JSTORE",
  "occurredAt": "2026-10-08T18:20:11.000Z",
  "data": {
    "shipment": {
      "id": "shp_01J",
      "orderId": "ord_01JABC",
      "trackingNumber": "WJH123456789",
      "status": "booked",
      "carrier": "mega"
    },
    "order": {
      "id": "ord_01JABC",
      "number": "10042",
      "status": "waiting_for_pickup"
    }
  },
  "changes": {
    "aggregateType": "shipment",
    "aggregateId": "shp_01J",
    "orderId": "ord_01JABC"
  }
}

HTTP/1.1 200 OK
Content-Type: text/plain

ok