Skip to main content
更新现有门店的名称、状态或配置设置。仅请求体中包含的字段会被更新;省略的字段保持不变。
认证方式: API Key(需要 owner 或 admin 角色)
本端点不管理 Webhook 配置。请求体中如出现 webhookSettings 字段会被静默忽略,响应顶层附 warnings 数组;其它字段照常更新并返回 200。Webhook 配置请使用 add-webhookupdate-webhookremove-webhook,列表查询走 GraphQL Store.storeWebhooks

请求体

通知设置

分两类,写入权限不同: 商户可写(✅ 通过本端点接受): 平台管理(🔒 商户 API 只读;由 PANCAKE 平台管理):
notificationSettings 入参中包含任何平台管理字段(email*,或历史遗留的 notifyPayoutCompleted / notifyPayoutFailed——提现结果邮件必达,无开关键),服务端会静默丢弃这些字段,并在 200 响应的 warnings[] 中列出被丢弃的 key。如需修改 customer 邮件 toggle,请联系 PANCAKE 平台。

收银台设置

收银台主题设置(适用于 lightdark):

部分更新语义

两个 settings 对象均支持部分更新,每个子字段有三种传值语义: 将整个对象设为 null(如 "notificationSettings": null)会清除该设置组的所有字段。

请求示例

成功响应 (200)

响应字段

创建门店响应字段 相同。 验证流程管理(🔒 本端点只读;仅在响应中回显):
supportEmailwebsite 无法通过本端点设置。它们分别在商户完成客服邮箱验证、产品域名验证后,由验证流程自动写入(仅对已开启生产的门店生效,即 prodEnabled: true)。请求体中携带这两个字段时返回 200,门店数据不变,且不会附带 warnings 条目 —— 字段被静默丢弃。

webhookSettings 兼容性警告

请求体中如出现 webhookSettings 字段,该字段会被静默忽略,响应顶层会包含一个 warnings 数组。data.store 对象不受影响。

错误响应

重试策略:4xx 一律不要重试 — 修正请求后重发。5xx 指数退避重试(起步 5s,最多 3 次)。