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

# 优惠券

> 创建优惠券和促销码，按渠道发码，并查看使用情况

## 优惠券管理

优惠券页面用于为店铺设置折扣。**优惠券**定义优惠本身：减多少、适用哪些商品、何时到期、最多能被领取多少次；每张优惠券自带一个**促销码**，买家在收银台输入它来领取优惠。要把同一个优惠按渠道或人群发出去，就给优惠券添加更多促销码，每个码可以有自己的使用条件。折扣在收银台和订阅上的行为见[折扣与促销](https://docs.waffo.ai/zh/guides/discounts.md)。

优惠券只属于一个环境：页面跟随顶部的**测试模式**开关，测试模式下创建的优惠券不能在正式模式使用。准备好后用[复制到正式环境](#copy-to-live)。

![Coupons list](https://mintcdn.com/waffo/fzyQe5Jh5yF_yUiY/images/dashboard/discounts-list.png?fit=max\&auto=format\&n=fzyQe5Jh5yF_yUiY\&q=85\&s=997ad1e53892442a1a6cd14a0f056120)

## 优惠券列表

顶部概览卡展示生效中的优惠券数、全部优惠券的累计兑换、最常用的优惠券，以及额外添加的促销码数量。下方列表包含：

| 列 | 说明 |
| - | - |
| 名称 | 优惠券名称（只有你能看到），以及它的优惠、持续期和限制 |
| 促销码 | 优惠券的默认码。展开一行可查看额外的码 |
| 状态 | 生效中、已用完、已过期、已停用或创建失败，悬停可查看含义 |
| 已用 / 上限 | 优惠券全部码的累计兑换次数与总上限 |
| 到期 | 优惠券的兑换截止日期，或无到期 |
| 商品 | 全部商品，或限定的商品数量 |

用**全部 / 生效中 / 已失效 / 已停用 / 创建失败**标签筛选，或按名称、按促销码搜索。按促销码搜索时，优惠券的额外码也会被匹配。

### 优惠券状态

| 状态 | 含义 |
| - | - |
| 生效中 | 买家现在可以在收银台输入它的任一促销码来领取 |
| 已用完 | 领取次数已达上限，它的码在收银台会被拒绝 |
| 已过期 | 已过兑换截止日期，它的码会被拒绝。日期不能修改，需要延期请新建优惠券 |
| 已停用 | 被你停用，它的码会被拒绝。已经应用到订阅上的折扣会持续到该订阅下一次变更方案 |
| 创建失败 | 优惠券未能创建。它的码已被释放，可以用同一个码重新创建 |

## 创建优惠券

![Create coupon](https://mintcdn.com/waffo/fzyQe5Jh5yF_yUiY/images/dashboard/discounts-create.png?fit=max\&auto=format\&n=fzyQe5Jh5yF_yUiY\&q=85\&s=e28dc699e3ebfceea1892fda047e679b)

**1. 点击「新建优惠券」**

按钮在优惠券页面右上角。

**2. 填写名称**

名称只用于在列表里辨认优惠券，买家只会看到促销码。

**3. 选择商品**

默认适用于全部商品。打开**仅限指定商品**可以挑选适用的商品。

**4. 设置优惠**

按百分比减，或按固定金额减；固定金额需要为所选商品定价的每种币种各填一个金额。

**5. 设置持续期**

仅对订阅有效：只优惠首次付款、优惠前 N 个计费周期，或每次付款都优惠。

**6. 设置促销码和限制**

系统已为你生成一个码，可以保留或改成自己的。可选填到期日期、总兑换上限，以及额外的促销码。

**7. 创建**

右侧摘要会显示这张优惠券的效果。点击**创建优惠券**。

> [!WARNING]
>
> 创建后只能修改名称。如需调整促销码、优惠、适用商品、到期时间或兑换上限，请新建优惠券。

### 优惠券字段

| 字段 | 必填 | 说明 |
| - | - | - |
| 名称 | 是 | 内部名称，不会展示给买家 |
| 商品 | 否 | 默认全部商品，或指定若干商品。未发布到当前环境的商品不能选 |
| 类型 | 是 | 百分比或固定金额 |
| 折扣百分比 | 百分比时必填 | 大于 0 且不超过 100，最多 2 位小数 |
| 减免金额 | 固定金额时必填 | 每种币种一个金额，币种跟随商品定价。未列出的币种不享受优惠，不做汇率换算 |
| 持续期 | 是 | 仅首次（只优惠首次付款）、多个计费周期，或永久。一次性商品始终只优惠一次 |
| 促销码 | 是 | 3–32 位字母、数字或 `-`，不区分大小写。不能与本店其他有效码重复 |
| 到期日期 | 否 | 当天（你的时区）结束前可兑换。优惠券到期后，已应用到订阅上的折扣也随之结束 |
| 兑换上限 | 否 | 优惠券总共能被领取多少次，全部促销码共用这个上限 |

> [!NOTE]
>
> 付费试用期会消耗折扣：「仅首次」的优惠券在试用期就用掉了，多周期的优惠券把试用期算作第一个周期。免费试用不消耗折扣。

### 创建时添加促销码

打开**添加更多促销码**，可以在创建时就为同一张优惠券发额外的码：最多 20 个单独的码，各自带条件；或者按前缀批量生成一批。每个额外的码领取的都是同一张优惠券、同样的优惠，它的次数和到期不能超过优惠券本身。创建后也可以在优惠券详情里继续添加。

## 优惠券详情

点击列表中的一行打开详情。面板展示优惠、默认促销码、持续期、兑换次数与上限、到期时间、适用商品，以及它的全部促销码。

![Coupon details](https://mintcdn.com/waffo/fzyQe5Jh5yF_yUiY/images/dashboard/discounts-detail.png?fit=max\&auto=format\&n=fzyQe5Jh5yF_yUiY\&q=85\&s=073f24c5e9fa5a0e15b7d36eb4f4a19f)

在这里可以：

* **重命名**优惠券
* **添加促销码**：单个或批量（见下文）
* **导出 CSV**：导出全部促销码
* **停用**优惠券或其中某个促销码
* **复制到正式环境**：把测试模式的优惠券复制过去

### 促销码

买家在收银台输入优惠券的任一个码，领取的都是这张优惠券。促销码只是在优惠券之上附加自己的条件：

| 条件 | 说明 |
| - | - |
| 仅限指定买家使用 | 买家邮箱，用逗号或换行分隔 |
| 该码最多可用 N 次 | 不能超过优惠券的上限 |
| 每位买家最多可用 N 次 | 每位买家的累计使用次数 |
| 该码的到期日期 | 不能晚于优惠券的到期 |
| 最低订单金额 | 按币种设置，以折扣前、税前金额计。其他币种无最低要求 |

促销码可按**全部 / 生效中 / 已停用**筛选或按码搜索。促销码可以单独停用；停用不可恢复，该码之后可被新的促销码重复使用。

> [!NOTE]
>
> 已停用、已过期或创建失败的优惠券不能再添加促销码。

### 批量生成促销码

在**添加促销码**里切换到**批量生成**，一次最多生成 500 个码，可选前缀（最多 12 位），所有码使用同一组条件，例如给邮件订阅者发一人一码。生成完成后可以一键复制全部或下载 CSV；之后也随时可以在优惠券详情里再次导出。

![Generated promotion codes](https://mintcdn.com/waffo/fzyQe5Jh5yF_yUiY/images/dashboard/discounts-generated.png?fit=max\&auto=format\&n=fzyQe5Jh5yF_yUiY\&q=85\&s=810ffc9166b0e92141b693a93c6c1458)

### 停用优惠券

停用不可恢复：优惠券及其全部促销码对新订单失效，它们的码会被释放以供重复使用。已经应用到订阅上的折扣会持续到该订阅下一次变更方案，见[折扣与促销](https://docs.waffo.ai/zh/guides/discounts.md#when-the-discount-ends)。

## 复制到正式环境

店铺通过审核后，测试模式下创建的优惠券可以在详情里复制到正式环境。复制出来的是一张设置相同的新优惠券，兑换次数从 0 开始。可以选择一并复制它生效中且未过期的促销码，条件保持一致。

* 尚未发布到正式环境的商品不会包含在副本里；如果优惠券的商品都没发布，请先发布商品。
* 如果优惠券已经过期，正式环境的副本不设到期，过期的促销码也不会复制。
* 如果某个码在正式环境已被占用，复制会中止：先在正式环境停用它，或不复制促销码。

## 下一步

> **[折扣与促销](https://docs.waffo.ai/zh/guides/discounts.md)**
>
> 码在收银台如何校验，订阅如何享受折扣

> **[优惠券接口](https://docs.waffo.ai/zh/api-reference/endpoints/coupons/overview.md)**
>
> 从服务端创建优惠券和促销码


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.