> ## 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.

# 商店设置

> 配置商店资料、收银台外观、通知和 Webhook；以及新建和删除商店

## 概览

商店设置包含所有商店级别的配置项。通过侧边栏 **Settings（设置）** 进入。

共有四个选项卡：

| 选项卡                   | 说明              |
| --------------------- | --------------- |
| **General（通用）**       | 商店资料、品牌和验证      |
| **Checkout（收银台）**     | 收银台页面外观         |
| **Notifications（通知）** | 发送给您和消费者的邮件通知   |
| **Webhooks**          | Webhook 端点和事件订阅 |

***

## General（通用）

### 商店资料

| 字段                               | 说明                    |
| -------------------------------- | --------------------- |
| **Store Name（商店名称）**             | 商店的显示名称（同时更新公开商店 URL） |
| **Store Slug（商店标识）**             | URL 标识符，根据商店名称自动生成    |
| **Store Logo（商店 Logo）**          | 方形图片，建议至少 200×200px   |
| **Support Email（支持邮箱）**          | 显示在收据上的客户联系邮箱         |
| **Website（网站）**                  | 您的产品网站地址              |
| **Checkout Return URL（收银台返回地址）** | 收银台成功或失败后的跳转地址        |

<Note>
  修改商店名称会自动同步更新公开商店 URL。
</Note>

### 商店审核

完成商店验证以启用实时收款。状态说明：

| 状态       | 说明                |
| -------- | ----------------- |
| **未开始**  | 尚未发起验证            |
| **进行中**  | 部分填写，尚未提交         |
| **审核中**  | 已提交，通常需要 1–3 个工作日 |
| **已验证**  | 审核通过，实时收款已启用      |
| **验证失败** | 未通过审核，请更新后重新提交    |

详细流程请见[业务详情](/zh/settings/business-details)。

### 新建商店

每个商户账户最多可创建 **20 个商店**。在顶部导航栏点击当前商店名称，选择 **Create New Store（新建商店）**，按照引导完成创建。

不同商店之间完全独立，拥有独立的商品、消费者、订单和设置。

### 删除商店

永久删除此商店。此操作不可撤销，所有商品及关联数据将被清除。

<Warning>
  删除商店前，必须先删除所有商品。
</Warning>

***

## Checkout（收银台）

自定义收银台页面外观，支持浅色和深色双主题。

### 品牌设置

* **Logo** — 显示在收银台页头部，与通用设置中的商店 Logo 同步。

### 颜色

| 配置项                 | 说明       |
| ------------------- | -------- |
| **主色（Primary）**     | 按钮和高亮颜色  |
| **背景色（Background）** | 页面背景色    |
| **卡片色（Card）**       | 卡片和面板背景色 |
| **文字色（Text）**       | 主要文字颜色   |

### 样式

* **圆角（Border Radius）** — 按钮、卡片和输入框的圆角大小

### 双主题（浅色 & 深色）

开启双主题后可分别为浅色和深色模式配置颜色。消费者将看到与其系统偏好匹配的主题，也可设置默认主题。

<Tip>
  使用**从网站导入**功能，自动从您的网站 URL 提取品牌颜色。
</Tip>

***

## Notifications（通知）

### 消费者邮件

配置 Waffo Pancake 向消费者发送的邮件：

| 邮件     | 触发时机             |
| ------ | ---------------- |
| 订单确认   | 消费者完成一次性购买       |
| 订阅确认   | 消费者开始新订阅         |
| 订阅续费   | 订阅自动续费           |
| 订阅变更   | 消费者切换到其他订阅方案     |
| 订阅取消   | 消费者取消订阅          |
| 订阅恢复   | 消费者重新激活已取消的订阅    |
| 订阅终止   | 已取消的订阅在周期结束后永久失效 |
| 订阅逾期   | 订阅付款失败           |
| 即将扣款提醒 | 在下次扣款或试用期结束前发送   |

### 您的通知

配置哪些事件向您发送通知：

| 通知             | 触发时机      |
| -------------- | --------- |
| 新订单            | 有新订单产生    |
| 新订阅            | 有新订阅开始    |
| 订阅取消           | 有订阅被取消    |
| 退款申请           | 有退款被申请或处理 |
| 争议（Chargeback） | 收到争议请求    |
| 提款完成           | 提款完成      |

***

## Webhooks

配置 Webhook 端点以接收实时事件通知。

### 端点

可分别为**测试**和**生产**环境配置独立的 Webhook 端点。

| 字段                     | 说明                           |
| ---------------------- | ---------------------------- |
| **Endpoint URL（端点地址）** | 接收 Webhook POST 请求的 HTTPS 地址 |
| **Public Key（公钥）**     | 用于验证 Webhook 签名的真实性          |

### 事件类型

选择需要推送到端点的事件：

| 分组     | 事件                                                                                                                                                                                  |
| ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **订单** | `order.completed`                                                                                                                                                                   |
| **订阅** | `subscription.activated`、`subscription.payment_succeeded`、`subscription.updated`、`subscription.canceling`、`subscription.uncanceled`、`subscription.canceled`、`subscription.past_due` |
| **退款** | `refund.succeeded`、`refund.failed`                                                                                                                                                  |

### 事件日志

查看最近的 Webhook 投递记录，包括状态（成功/待处理/失败）、响应内容和重试次数。使用**发送测试事件**触发一次测试投递。

<Note>
  投递失败后最多重试 3 次，采用指数退避策略。
</Note>