跳转到主要内容
软删除门店。门店数据保留但变为不可访问。仅门店 owner 可执行此操作。 
POST /v1/actions/store/delete-store
认证方式： API Key（需要 owner 角色）

​
请求体

字段类型必需说明
idstring是要删除的门店 ID（Short ID 格式 STO_xxx）

​
请求示例

const { store } = await client.stores.delete({
  id: "STO_2aUyqjCzEIiEcYMKj7TZtw",
});
console.log(store.deletedAt); // => "2026-01-15T12:00:00.000Z"

​
成功响应 (200)

{
  "data": {
    "store": {
      "id": "STO_2aUyqjCzEIiEcYMKj7TZtw",
      "name": "My Digital Store",
      "status": "active",
      "logo": null,
      "supportEmail": null,
      "website": null,
      "slug": "my-digital-store-a1b2c3",
      "prodEnabled": false,
      "webhookSettings": null,
      "notificationSettings": null,
      "checkoutSettings": null,
      "deletedAt": "2026-01-15T12:00:00.000Z",
      "createdAt": "2026-01-15T10:30:00.000Z",
      "updatedAt": "2026-01-15T12:00:00.000Z"
    }
  }
}

​
响应字段

与创建门店响应字段相同，deletedAt 字段已填充。

​
错误响应

状态码错误说明
400Missing required field: id请求体中未提供 id
403Access denied: only owner can delete store商户角色为 admin 或 member
404Store not found门店 ID 不存在或商户不是成员
删除门店是软删除。门店数据保留但变为不可访问。此操作无法通过 API 撤销。