> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waffo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 门店端点

> 创建、更新和管理门店

门店是组织产品、订单和收银台体验的顶层实体。每个商户最多可拥有 **20 个门店**，每个门店有独立的 webhook、通知和收银台主题设置。

## 门店状态值

| 状态          | 说明                  |
| ----------- | ------------------- |
| `active`    | 门店正常运营              |
| `inactive`  | 商户已禁用门店；数据保留但收银台不可用 |
| `suspended` | 平台已暂停门店；商户无法重新激活    |

## 基于角色的访问控制

门店中的每个商户被分配三种角色之一。门店创建者自动获得 `owner` 角色。

| 权限     | `owner` | `admin` | `member` |
| ------ | ------- | ------- | -------- |
| 查看门店详情 | 是       | 是       | 是        |
| 更新门店设置 | 是       | 是       | 否        |
| 删除门店   | 是       | 否       | 否        |
| 创建门店   | --      | --      | --       |

<Note>
  创建门店不受角色限制 -- 任何已认证的商户都可以创建新门店（最多 20 个）。角色仅适用于对已有门店的操作。
</Note>

## 端点

<CardGroup cols={3}>
  <Card title="创建门店" icon="plus" href="/api-reference/endpoints/stores/create-store">
    为已认证的商户创建新门店。
  </Card>

  <Card title="更新门店" icon="pen" href="/api-reference/endpoints/stores/update-store">
    更新门店名称、状态或配置设置。
  </Card>

  <Card title="删除门店" icon="trash" href="/api-reference/endpoints/stores/delete-store">
    软删除门店（仅 owner）。
  </Card>
</CardGroup>