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.
商店设置包含所有商店级别的配置项。通过侧边栏 Settings（设置） 进入。
共有四个选项卡：
| 选项卡 | 说明 |
|---|
| General（通用） | 商店资料、品牌和验证 |
| Checkout（结账） | 结账页面外观 |
| Notifications（通知） | 发送给您和消费者的邮件通知 |
| Webhooks | Webhook 端点和事件订阅 |
General（通用）
商店资料
| 字段 | 说明 |
|---|
| Store Name（商店名称） | 商店的显示名称（同时更新公开商店 URL） |
| Store Slug（商店标识） | URL 标识符，根据商店名称自动生成 |
| Store Logo（商店 Logo） | 方形图片，建议至少 200×200px |
| Support Email（支持邮箱） | 显示在收据上的客户联系邮箱 |
| Website（网站） | 您的产品网站地址 |
| Checkout Return URL（结账返回地址） | 结账成功或失败后的跳转地址 |
商店审核
完成商店验证以启用实时收款。状态说明：
| 状态 | 说明 |
|---|
| 未开始 | 尚未发起验证 |
| 进行中 | 部分填写，尚未提交 |
| 审核中 | 已提交，通常需要 1–3 个工作日 |
| 已验证 | 审核通过，实时收款已启用 |
| 验证失败 | 未通过审核，请更新后重新提交 |
新建商店
每个商户账户最多可创建 20 个商店。在顶部导航栏点击当前商店名称，选择 Create New Store（新建商店），按照引导完成创建。
不同商店之间完全独立，拥有独立的商品、消费者、订单和设置。
删除商店
永久删除此商店。此操作不可撤销，所有商品及关联数据将被清除。
Checkout（结账）
自定义结账页面外观，支持浅色和深色双主题。
品牌设置
- Logo — 显示在结账页头部，与通用设置中的商店 Logo 同步。
| 配置项 | 说明 |
|---|
| 主色（Primary） | 按钮和高亮颜色 |
| 背景色（Background） | 页面背景色 |
| 卡片色（Card） | 卡片和面板背景色 |
| 文字色（Text） | 主要文字颜色 |
- 圆角（Border Radius） — 按钮、卡片和输入框的圆角大小
双主题（浅色 & 深色）
开启双主题后可分别为浅色和深色模式配置颜色。消费者将看到与其系统偏好匹配的主题，也可设置默认主题。
使用从网站导入功能，自动从您的网站 URL 提取品牌颜色。
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 投递记录，包括状态（成功/待处理/失败）、响应内容和重试次数。使用发送测试事件触发一次测试投递。
