> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Coupon QR Code

> 创建一个用于折扣优惠券的 QR 码。

## 适用场景

优惠券页面展示单一优惠内容——折扣、买一送一、促销活动——配有产品图片、您的品牌信息、优惠说明、一个行动号召按钮（例如 "Order Now"），以及一个专门的 **Coupon Details** 区块，展示可复制的优惠码、有效期和使用条款。它面向印刷材料设计——传单、包装、店内标识——在这些场景中，扫描代码应展示一个可兑换的优惠，而不是一个通用落地页。

<Note>
  与本页每个类别一样，"Coupon QR code" 并不是一个单独的创建路径——它是 **Build a Page** 流程，按 Coupon 标签筛选后进入。
</Note>

## 查找优惠券模板并进入编辑器

<Steps>
  <Step title="打开 Create QR Code 并选择 Build a Page">
    从 **QR Codes → Create QR Code**（`/qr/create`）进入，点击 **Build a Page** 卡片，打开基于区块的 Page Builder 模板画廊。
  </Step>

  <Step title="按 Coupon 筛选画廊">
    在 **Choose a template**（`/qr/new`）页面，点击 **Coupon** 标签。验证时恰好有 2 个模板：**Retail Discount** 和 **Food Deal**。

    <Frame caption="按 Coupon 标签筛选后的模板画廊">
      <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/coupon/gallery-filtered.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=25845563ba4dbc36856405ae620aabc3" alt="按 Coupon 标签筛选的模板画廊，展示 Retail Discount 和 Food Deal 模板，以及 Start Blank 选项" width="1440" height="900" data-path="images/v2/qr-codes/create/coupon/gallery-filtered.png" />
    </Frame>
  </Step>

  <Step title="预览并选择一个模板">
    点击卡片会打开一个预览面板，展示模板名称、简短的风格描述、其类别标签，以及一个 **Use this template** 按钮。本次验证使用了 **Food Deal** 模板——描述为 "Playful and rounded — a buy-one-get-one coupon for a restaurant or cafe"（活泼圆润的风格——一张适用于餐厅或咖啡馆的买一送一优惠券），并标记为 **Coupon**。其预览展示了一个可兑换代码（"PIZZABOGO"），带有复制图标、有效日期，以及使用次数上限（"Valid for 200 uses"）。
  </Step>

  <Step title="进入 Page Builder">
    选择后会打开 `/qr/new/landing?template=coupon-food-deal` 处的编辑器。此模板自带 5 个区块：**Image Gallery**、**Company Branding**、**Description**、一个 **Button**（例如 "Order Now"），以及 **Coupon Details**——均可在左侧区块面板中编辑。

    <Frame caption="打开 Food Deal 优惠券模板后的 Page Builder 画布">
      <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/coupon/builder-canvas.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=93fcbada1680523fb1c08986eb3ee21a" alt="Page Builder 画布，展示 Food Deal 优惠券模板，左侧面板中列出 Image Gallery、Company Branding、Description、Button 和 Coupon Details 区块" width="1440" height="900" data-path="images/v2/qr-codes/create/coupon/builder-canvas.png" />
    </Frame>

    <Check>
      能够到达这个画布即可确认流程有效——无需发布即可验证。在 **Coupon Details** 区块中编辑优惠文案、可兑换代码和有效期，页面准备好后从顶部栏使用 **Publish**。
    </Check>
  </Step>
</Steps>

## 通过 API 创建

若要通过 API 而非界面创建优惠券风格的 QR 码，请使用类别 ID `17`（标记为 **Coupon**）——完整的请求结构请参见 [Create QR Code](/v1/api-reference/endpoint/qr_manager/create)，完整的 ID 到标签映射请参见 [Category List](/v1/api-reference/references/category-list)。

## 相关内容

* [Page Builder 概览](/zh/page-builder/overview) —— 该模板会打开的、基于区块的编辑器。
* [Templates](/zh/page-builder/templates) —— 在画廊中浏览、筛选并保存您自己的模板。
* [Product QR Code](/zh/qr-codes/create/product) —— 类似的零售用例，展示产品而非可兑换优惠。
* [文件夹、标签与批量操作](/zh/qr-codes/manage/folders-tags-bulk-operations) —— 发布后整理该 QR 码。