# 店铺更新

**Webhook** shop/update

店铺信息更新时触发。

需要 `shop` [访问权限](/zh-CN/docs/app/building-blocks/authentication/access-scopes)。最低支持版本：`202007`。

## 请求头

- `X-Shoplazza-Topic` string

  触发本次推送的事件，例如 orders/create

  **示例：** `orders/create`
- `X-Shoplazza-Hmac-Sha256` string

  请求体的 HMAC-SHA256 签名（base64 编码），使用应用的 Client Secret 生成，用于验证请求来自 Shoplazza
- `X-Shoplazza-Shop-Domain` string

  产生该事件的店铺域名

  **示例：** `example.myshoplaza.com`
- `X-Shoplazza-Api-Version` string

  序列化 payload 使用的 API 版本

  **示例：** `2025-06`
- `X-Shoplazza-Deduplication-ID` string

  本次推送的去重 ID，同一事件重发时保持不变，用于幂等去重

## 请求体

**数据结构 | 示例**

- `shop` object

  - `id` string

    店铺 ID
  - `store_id` string

    店铺 ID
  - `name` string

    名称
  - `company_name` string

    公司名称
  - `url` string

    店铺的完整 URL
  - `email` string

    电子邮件地址
  - `service_email` string

    客服邮箱
  - `financial_email` string

    财务邮箱
  - `phone` string

    电话号码
  - `phone_area` string

    电话区域
  - `phone_area_code` string

    店铺联系电话的区号
  - `phone_region` string

    电话所属地区
  - `address` string

    主要地址行
  - `city` string

    城市
  - `province_code` string

    省份代码
  - `country_code` string

    国家代码（如 CN）
  - `zip` string

    邮政编码
  - `currency` string

    货币代码
  - `money_format` string

    货币格式模板
  - `symbol` string

    店铺的货币符号。若未设置则返回 nil
  - `symbol_left` string

    货币符号（显示在金额左侧的形态）
  - `symbol_right` string

    货币符号（显示在金额右侧的形态）
  - `locale` string

    店铺中已发布的 locales（语言）
  - `time_zone` string

    时区
  - `hour` integer

    时区偏移小时数
  - `has_to_sqs` boolean

    内部标记，应用无需关注
  - `created_at` string

    创建时间，ISO-8601 格式
  - `updated_at` string

    最后更新时间，ISO-8601 格式
  - `icon` object

    店铺图标

    - `src` string

      图标的源地址
    - `path` string

      图标路径
    - `alt` string

      图标的替代文本

```json
{
  "shop": {
    "id": "string",
    "store_id": "string",
    "name": "string",
    "company_name": "string",
    "url": "string",
    "email": "string",
    "service_email": "string",
    "financial_email": "string",
    "phone": "string",
    "phone_area": "string",
    "phone_area_code": "string",
    "phone_region": "string",
    "address": "string",
    "city": "string",
    "province_code": "string",
    "country_code": "string",
    "zip": "string",
    "currency": "string",
    "money_format": "string",
    "symbol": "string",
    "symbol_left": "string",
    "symbol_right": "string",
    "locale": "string",
    "time_zone": "string",
    "hour": 0,
    "has_to_sqs": true,
    "created_at": "string",
    "updated_at": "string",
    "icon": {
      "src": "string",
      "path": "string",
      "alt": "string"
    }
  }
}
```