Webhook — order.updated

Chi tiết và payload mẫu của sự kiện webhook `order.updated`.

Xem Markdown

Sự kiện order.updated được gửi khi trạng thái hoặc nội dung đơn hàng thay đổi. Payload gửi tới URL webhook của bạn bằng HTTP POST kèm header chữ ký X-SaleAI-Signature (HMAC-SHA256).

Thông tin sự kiện

Thuộc tínhGiá trị
Tên sự kiệnorder.updated
Kích hoạt khiCập nhật đơn hàng
Base URLhttps://sale-ai.hitechcloud.vn/webhook
Header chữ kýX-SaleAI-Signature

Cấu trúc payload

Payload order.updated
{
  "id": "evt_9f0a1b2c",
  "event": "order.updated",
  "created_at": "2026-10-31T10:35:00+07:00",
  "data": {
    "id": "order_55667788",
    "bot_id": "bot_7c1a9f2e",
    "subscriber_id": "sub_2a9b8c7d",
    "items": [
      {
        "product_id": "prod_a1f2e3d4",
        "name": "Ao thun basic",
        "quantity": 2,
        "unit_price": 199000
      }
    ],
    "subtotal": 398000,
    "shipping_fee": 30000,
    "total": 428000,
    "currency": "VND",
    "status": "confirmed",
    "customer": {
      "name": "Nguyen Van A",
      "phone": "0901234567",
      "address": "12 Nguyen Hue, Q1, HCM"
    },
    "created_at": "2026-10-31T10:30:00+07:00"
  }
}
Khử trùng lặp theo id sự kiện (evt_...) và xác thực X-SaleAI-Signature trước khi xử lý. Sự kiện được gửi theo cơ chế at-least-once; hãy phản hồi 200 trong vòng 5 giây.