优惠券

创建折扣码，供客户在结账时使用。支持百分比或固定金额折扣、限时或限量使用、一次性或循环优惠。

优惠券在你的应用的 Admin > Commerce > Products 下的 Coupons 区域，以及已发布应用管理面板的 Cupones 标签页中进行管理。

优惠券字段说明

字段	说明
code	客户在结账时输入的促销码（例如 LAUNCH20）
percent_off 或 amount_off	二选一，不可同时设置。百分比范围为 1–100；金额以最小货币单位（分）表示。
currency	使用 amount_off 时必填（三字母 ISO 货币代码）。创建时接受并转发给 Stripe，但此后不会被 API 存储或返回。
duration	once（仅第一次付款）、repeating（持续 duration_in_months 个月）或 forever
duration_in_months	当 duration 为 repeating 时必填
max_redemptions	所有客户的总兑换上限
redeem_by	到期日期，超过该日期后优惠券将失效
name	展示给客户的显示名称
active	启用/停用开关，无需删除即可控制优惠券状态

创建优惠券

在 Coupons 子标签页中，点击 Add coupon 并填写相关字段。以下是几种常见配置：

目标	设置
永久享受八折优惠	percent_off: 20，duration 设为 forever
减免 $10，单次使用，30 天后到期	amount_off: 1000，currency 设为 USD，duration 设为 once，max redemptions 设为 1，redeem-by 设为 30 天后
订阅前 3 个月享受五折优惠	percent_off: 50，duration 设为 repeating，duration in months 设为 3

也可以直接询问 AI："Create a LAUNCH20 coupon for 20% off forever."

在结账时使用优惠券

客户可通过以下两种方式使用优惠码：

• 在 Stripe 结账页面 — 促销码输入框会自动显示，客户可直接在此输入代码，无需你做任何额外配置。
• 在你自己的购物车中 — 在购物车中添加促销码输入框，并将客户输入的内容作为 couponCode 传入结账调用。服务端会验证代码并根据你的商务数据计算折扣（而非使用浏览器传来的金额），将折扣记录在订单上，并附加对应的 Stripe 优惠券以确保扣款金额正确。

询问 AI："Add a promo code field to the cart and apply it at checkout."

查看、更新、停用

Coupons 子标签页会列出所有优惠券，并显示每张券已兑换次数与上限的对比，方便你一目了然地追踪活动效果。编辑功能有意做了限制（详见下文），但你可以随时将任意优惠券切换为停用状态而无需删除，该操作会立即使其在结账时失效。

注意事项与限制

• 优惠码和折扣金额不可更改。 你可以更新显示 name 并切换 active 状态，但不能修改 percent_off、amount_off 或 code 本身。如需更改条款，请创建新的优惠券。
• times_redeemed 会自动递增且为只读——可用于追踪活动效果。
• 优惠券按客户生效，而非按订单——如果优惠券设置为 forever，且某客户完成了订阅，则每次续费都将享受该折扣。