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

# 产品

> 创建和管理您的产品目录

## 产品管理

产品页面是您管理整个产品目录的地方。创建一次性购买商品或订阅产品。

<Frame>
  <img src="https://mintcdn.com/waffo/5dRlk76Jm-9Zm6Tj/images/dashboard/products-list.png?fit=max&auto=format&n=5dRlk76Jm-9Zm6Tj&q=85&s=2068cb755f3bad4349d93aadbaa7a94f" alt="Products List" width="1440" height="900" data-path="images/dashboard/products-list.png" />
</Frame>

## 产品列表

您的产品以表格形式展示：

| 列名   | 描述             |
| ---- | -------------- |
| 名称   | 产品名称和图片缩略图     |
| 价格   | 价格、货币和计费周期     |
| 状态   | 已启用或已停用        |
| 订阅者  | 活跃订阅数量（针对订阅产品） |
| 创建时间 | 创建日期           |
| 操作   | 编辑、复制链接、切换状态   |

## 创建产品

<Frame>
  <img src="https://mintcdn.com/waffo/5dRlk76Jm-9Zm6Tj/images/dashboard/products-create.png?fit=max&auto=format&n=5dRlk76Jm-9Zm6Tj&q=85&s=afb107e0fe3b6c245f273109473fca24" alt="Create Product" width="1440" height="900" data-path="images/dashboard/products-create.png" />
</Frame>

<Steps>
  <Step title="点击'创建产品'">
    在产品页面右上角找到该按钮。
  </Step>

  <Step title="输入基本信息">
    **必填字段：**

    * 产品名称
    * 价格
    * 货币
    * 定价类型（一次性或订阅）
  </Step>

  <Step title="添加详情（可选）">
    * 产品描述（支持 Markdown）
    * 产品图片
    * 税费设置
  </Step>

  <Step title="配置订阅设置">
    仅适用于订阅产品：

    * 计费周期
    * 试用期（可选）
  </Step>

  <Step title="保存产品">
    点击"创建"发布您的产品。
  </Step>
</Steps>

## 产品字段

### 基本信息

| 字段 | 必填 | 描述                 |
| -- | -- | ------------------ |
| 名称 | 是  | 显示名称（向客户展示）        |
| 描述 | 否  | Markdown 格式的产品详情   |
| 图片 | 否  | 产品图片（建议：400x400像素） |

### 定价

| 字段   | 选项                        | 描述             |
| ---- | ------------------------- | -------------- |
| 价格   | 数字                        | 产品价格（以最小货币单位计） |
| 货币   | USD、EUR、GBP、CNY、JPY、HKD 等 | 交易货币           |
| 定价类型 | 一次性、订阅                    | 支付模式           |
| 税费类别 | SaaS、数字商品、软件、电子书等         | 税费计算规则         |
| 税费行为 | 含税、不含税                    | 价格是否包含税费       |

### 价格限制

每种币种都有可设置的最低和最高价格，超出范围的价格在保存商品时会被拒绝。

| 币种  |       最低 |            最高 |
| --- | -------: | ------------: |
| USD |   \$1.00 |    \$7,500.00 |
| EUR |    €1.00 |     €7,400.00 |
| GBP |    £1.00 |     £6,400.00 |
| JPY |     ¥100 |    ¥1,250,000 |
| HKD | HK\$8.00 | HK\$61,000.00 |

<Note>
  CNY 可以在 dashboard 的分析视图中作为展示币种使用，但目前不支持作为商品定价币种。
</Note>

### 订阅设置

仅适用于订阅产品：

| 字段   | 选项           | 描述          |
| ---- | ------------ | ----------- |
| 周期   | 每周、每月、每季度、每年 | 计费频率        |
| 启用试用 | 是/否          | 提供免费试用      |
| 试用天数 | 数字           | 试用时长（默认：7天） |

### 税费配置

| 字段   | 选项        | 描述       |
| ---- | --------- | -------- |
| 税费类别 | SaaS、数字商品 | 税费计算规则   |
| 税费行为 | 含税、不含税    | 价格是否包含税费 |

## 产品状态

<CardGroup cols={2}>
  <Card title="已启用" icon="check">
    * 产品已上线可购买
    * 支付链接有效
    * 在收银台时显示
  </Card>

  <Card title="已停用" icon="pause">
    * 产品已隐藏
    * 支付链接返回错误
    * 现有订阅继续有效
  </Card>
</CardGroup>

要切换状态，使用产品行中的开关或编辑产品。

## 编辑产品

1. 点击产品行或编辑图标
2. 修改任意字段
3. 点击"保存更改"

<Warning>
  更改订阅产品的价格只会影响新订阅者。现有订阅者保持其原始价格。
</Warning>

## 产品购买链接

每个产品都拥有一个永不过期的固定购买链接：

```
https://checkout.waffo.ai/{store-slug}/{product-slug}
```

测试模式：

```
https://checkout.waffo.ai/{store-slug}/{product-slug}/test
```

**获取您的链接：**

* 点击任何产品上的"复制链接"按钮
* 在更高级的场景下，可通过 API 创建带自定义参数的 Checkout Session（动态链接，TTL 为 7 天）

**测试 vs 正式：**

* 在控制台顶部切换测试模式即可预览测试链接
* 测试链接使用 `/test` 后缀

## 最佳实践

<AccordionGroup>
  <Accordion title="产品命名">
    * 使用清晰、描述性的名称
    * 为订阅产品包含计费周期（例如，"专业版 - 月付"）
    * 避免使用特殊字符
  </Accordion>

  <Accordion title="描述">
    * 列出主要功能
    * 使用项目符号提高可读性
    * 包含客户能获得什么
    * 提及支持或保证
  </Accordion>

  <Accordion title="图片">
    * 使用高质量图片（最小 400x400 像素）
    * PNG 或 JPG 格式
    * 文件大小保持在 2MB 以内
    * 产品之间保持一致的风格
  </Accordion>

  <Accordion title="定价策略">
    * 研究竞争对手定价
    * 考虑地区购买力
    * 提供年付折扣（通常 15-20% 优惠）
    * 价格取整以简化
  </Accordion>
</AccordionGroup>

## 批量操作

选择多个产品可以：

* 批量启用/停用
* 导出产品数据
* 删除（需确认）
