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

# 优惠与促销

> 用优惠券和促销码做促销：公开码、渠道码、一次性码和订阅优惠

## 概览

Waffo Pancake 内置**优惠券**与**促销码**。优惠券定义「优惠多少」：按百分比或固定金额减免，可限定适用商品、总使用次数和到期时间。促销码定义「谁能用」：一张优惠券可以发多个促销码，每个码有自己的买家限制。两者都可以在 **Dashboard → 优惠券** 里创建，也可以通过 API 或 SDK 创建。

优惠适用于**一次性商品、新购订阅与更换方案**。优惠券只属于一个店铺和一个环境，测试模式下创建的码不能在正式模式使用。

***

## 优惠券与促销码

| 规则 | 设置在 | 说明 |
| - | - | - |
| 优惠方式 | 优惠券 | 百分比减免，或按币种减免固定金额 |
| 适用商品 | 优惠券 | 全店通用，或只对部分商品生效 |
| 到期时间 | 优惠券、促销码 | 过期后不能再使用；促销码的到期不能晚于优惠券 |
| 总使用次数 | 优惠券、促销码 | 所有买家合计的使用次数 |
| 限定买家 | 促销码 | 只限指定的买家邮箱 |
| 单买家次数 | 促销码 | 每位买家最多可用几次 |
| 最低消费 | 促销码 | 按币种设定，按优惠前、不含税金额判断 |

码不区分大小写。优惠券详情里按码显示使用次数，可以导出 CSV，也可以单独停用某一个码而不影响其他码。

***

## 买家如何使用

> [card] 收银台输码
>
> 店铺有可用的优惠券时，商品页自动显示输码框，买家输入码即可。

> [card] 带码链接
>
> 在商品链接后加 `?discount_code=XXX`，买家打开即已应用，不用手输。适合广告与邮件投放。

> [card] 服务端应用
>
> 创建 Checkout Session 时直接带上优惠券或促销码。会员价、合作伙伴价等不想展示码的场景，用 `couponId` 应用后买家看不到码、也不能移除。

***

## 常见场景

| 场景 | 怎么配 |
| - | - |
| 新品上市限时促销 | 一张优惠券，公开码，设到期时间和总次数 |
| 达人与渠道合作 | 一张优惠券，每个合作方一个促销码，各设总次数，按码看数据做结算 |
| 邮件订阅或抽奖 | 在优惠券上批量生成一次性码（每批最多 500 个，可带前缀），下载 CSV 合并进邮件 |
| 召回或 VIP 名单 | 促销码限定买家邮箱，码泄露也没关系 |
| 会员价、合作伙伴价 | 服务端按买家资格用 `couponId` 创建 session，不展示码 |
| 订阅前几期优惠或引导年付 | 设置优惠持续期（只首期、前几个周期或整个订阅期），或把优惠券限定在年付方案上 |

每个场景的具体配置和代码示例见[优惠与促销指南](https://docs.waffo.ai/zh/guides/discounts.md)。

***

## 订阅上的优惠

订阅可以设置优惠的**持续期**：只优惠首期、优惠前几个计费周期，或整个订阅期间都生效。免费试用不消耗优惠，优惠从第一个付费周期开始。买家在门户换方案时可以输入新码替换原优惠；不输码则原优惠在可延续的情况下延续。收据、续费和换方案邮件会展示原价、优惠行与预计下次扣款。

***

## 相关链接

* [优惠与促销指南](https://docs.waffo.ai/zh/guides/discounts.md) —— 规则细节、营销场景与 SDK 示例
* [Dashboard 优惠券页](https://docs.waffo.ai/zh/dashboard/discounts.md) —— 创建、批量生成码与查看使用情况
* [优惠券 API](https://docs.waffo.ai/zh/api-reference/endpoints/coupons/overview.md) · [促销码 API](https://docs.waffo.ai/zh/api-reference/endpoints/promotion-codes/overview.md)


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