---
url: "https://pay.weixin.qq.com/doc/brand/4018984410.md"
title: "商品券结构及修改说明"
doc_id: 4018984410
---

>更新时间：2026.03.27

## 一、简介

商品券分为单券模式和多次优惠模式。

- 单券模式：用户只能使用一次，使用后券失效。

- 多次优惠模式：用户可以按顺序多次使用，每次核销成功后会发放下一次优惠机会，直到用完为止。


| 结构概念 | 说明 | 关联关系 | 唯一标识 |
| --- | --- | --- | --- |
| 商品券 | 券的规则模板，定义优惠核心属性（商品券的基础信息、商品券类型等），不直接发放给用户，只用于批量生成批次。 | 1个商品券可包含多个批次 | 【商品券ID】 `product_coupon_id` |
| 批次 | 从商品券模板生成的一批可发放券，定义更细节的使用规则和发放规则。<br>“单券”模式通过单个批次向用户发放单张商品券；<br>“多次优惠”模式由多个批次进行组合，构成批次组，以券组的形式一次发放给用户多张商品券。 | 1个批次关联1个商品券，1个批次可发放多个用户商品券 | 【批次ID】 `stock_id`<br>【批次组ID】 `stock_bundle_id`（"多次优惠"模式才存在） |
| 用户商品券 | 用户在批次下实际领取到的券即为用户商品券。<br>“单券”模式下领取的是单个批次下的单张券。<br>“多次优惠”模式下领取的，则是在批次组下领取一个券组，即批次组下的每个批次里都有一张券发放给用户，用户领取的券组内包含多张券。 | 1个批次可发放多个用户商品券，1个用户商品券关联1个用户 | 【用户商品券Code】 `coupon_code`<br>【用户券组ID】 `user_coupon_bundle_id`（"多次优惠"模式才存在） |

## 二、商品券结构

### 2.1、单券

#### 2.1.1、单券模式结构示例图

| 单券模式结构示例图 |
| --- |
| ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/727ca4e3792dc4f322ac01d40608a450.png) |

#### 2.1.2、单券模式结构字段详细详情

| 信息结构 | 字段名 | 全场券 | 单品券 |
| --- | --- | --- | --- |
| 商品券信息 | 【展示信息】 `display_info` | 用于设置商品券在客户端页面的展示信息，主要设置内容包含：<br>- 商品券基础信息：【商品券名称】 `name`<br>  <br>- 图片类信息：【商品券图片】 `image_url`、【商品券背景图】 `background_url`、【商品券详情图列表】 `detail_image_url_list`<br>  <br>- 商品信息：【商品原价】 `original_price` | 用于设置商品券在客户端页面的展示信息，主要设置内容包含：<br>- 商品券基础信息：【商品券名称】 `name`<br>  <br>- 图片类信息：【商品券图片】 `image_url`、【商品券背景图】 `background_url`、【商品券详情图列表】 `detail_image_url_list`<br>  <br>- 商品信息：【商品原价】 `original_price` |
| 商品券信息 | 【展示信息】 `display_info` | 全场券无需设置商品信息：【适用商品组合】 `combo_package_list` | 单品券必须设置商品信息：【适用商品组合】 `combo_package_list` |
| 商品券信息 | 【使用模式】 `usage_mode` | 设置商品券的使用模式，单券取值“ `SINGLE`” | 设置商品券的使用模式，单券取值“ `SINGLE`” |
| 商品券信息 | 【优惠范围】 `scope` | 设置商品券的优惠范围，取值“ `ALL`” | 设置商品券的优惠范围，取值“ `SINGLE`” |
| 商品券信息 | 【商品券类型】 `type` | 设置商品券的优惠类型，可设置两种：<br>-满减券： `NORMAL`<br>-折扣券： `DISCOUNT` | 设置商品券的优惠类型，可设置三种：<br>-满减券： `NORMAL`<br>-折扣券： `DISCOUNT`<br>-兑换券： `EXCHANGE` |
| 商品券信息 | 【单券模式信息】 `single_usage_info` | 设置商品券的优惠力度，主要设置内容包含：<br>- 门槛信息：【门槛金额】 `threshold`<br>  <br>- 减免额度信息：<br>  <br>  -满减券：【固定减免金额】 `discount_amount`<br>  <br>  -折扣券：【固定减免百分比】 `percent_off` | 单品券的使用规则与优惠力度在批次信息中设置 |
| 批次信息 | 【单券使用规则】 `single_usage_rule` | 设置商品券的可核销时间，即券的有效期，只有在有效期内用户才能使用券。<br>可核销时间信息：【券可核销时间】 `coupon_available_period` | 设置商品券的可核销时间，即券的有效期，只有在有效期内用户才能使用券。<br>可核销时间信息：【券可核销时间】 `coupon_available_period` |
| 批次信息 | 【单券使用规则】 `single_usage_rule` | 全场券的使用规则与优惠力度在商品券信息中设置 | 设置商品券的优惠力度，主要设置内容包含：<br>- 门槛信息：【门槛金额】 `threshold`<br>  <br>- 减免额度信息：<br>  <br>  -满减券：【固定减免金额】 `discount_amount`<br>  <br>  -折扣券：【固定减免百分比】 `percent_off`<br>  <br>  -兑换券：【固定兑换价格】 `exchange_price` |
| 批次信息 | 【批次】 `stock` | 设置批次的发放信息与门店信息，主要设置内容包含：<br>- 发放信息：【券Code分配模式】 `coupon_code_mode`、【发放规则】 `stock_send_rule`、【事件通知配置】 `notify_config`<br>  <br>- 门店信息：【可用门店范围】 `store_scope` | 设置批次的发放信息与门店信息，主要设置内容包含：<br>- 发放信息：【券Code分配模式】 `coupon_code_mode`、【发放规则】 `stock_send_rule`、【事件通知配置】 `notify_config`<br>  <br>- 门店信息：【可用门店范围】 `store_scope` |
| 批次信息 | 【券使用规则展示信息】 `usage_rule_display_info` | 用于设置商品券在客户端页面的展示券详情信息，主要设置内容包含：<br>- 券使用方式：【券使用方式列表】 `coupon_usage_method_list`<br>  <br>- 使用券的跳转链接：【小程序跳转路径】 `mini_program_path`、【APP跳转路径】 `app_path`<br>  <br>- 券使用说明：【券使用说明】 `usage_description` | 用于设置商品券在客户端页面的展示券详情信息，主要设置内容包含：<br>- 券使用方式：【券使用方式列表】 `coupon_usage_method_list`<br>  <br>- 使用券的跳转链接：【小程序跳转路径】 `mini_program_path`、【APP跳转路径】 `app_path`<br>  <br>- 券使用说明：【券使用说明】 `usage_description` |
| 批次信息 | 【用户商品券展示信息】 `coupon_display_info` | 用于设置用户商品券在卡包中的展示详情，主要设置内容包含：<br>- 用户商品券展示信息：【用户商品券Code展示模式】 `code_display_mode`、【背景颜色】 `background_color`<br>  <br>- 自定义跳转入口信息：【小程序入口】 `entrance_mini_program`、【公众号入口】 `entrance_official_account`、【视频号入口】 `entrance_finder` | 用于设置用户商品券在卡包中的展示详情，主要设置内容包含：<br>- 用户商品券展示信息：【用户商品券Code展示模式】 `code_display_mode`、【背景颜色】 `background_color`<br>  <br>- 自定义跳转入口信息：【小程序入口】 `entrance_mini_program`、【公众号入口】 `entrance_official_account`、【视频号入口】 `entrance_finder` |
| 用户券信息 | 【用户商品券Code】 `coupon_code` | 记录用户的领券信息，券code是券的唯一标识 | 记录用户的领券信息，券code是券的唯一标识 |

### 2.2、多次优惠

#### 2.2.1、多次优惠模式结构示例图

| 多次优惠模式结构示例图 |
| --- |
| ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/562980bc5250c674ac2b251d2174dcc8.png) |

#### 2.2.2、多次优惠模式结构字段详细详情

| 信息结构 | 字段名 | 全场 | 单品 |
| --- | --- | --- | --- |
| 商品券信息 | 【展示信息】 `display_info` | 用于设置商品券在客户端页面的展示信息，主要设置内容包含：<br>- 商品券基础信息：【商品券名称】 `name`<br>  <br>- 图片类信息：【商品券图片】 `image_url`、【商品券背景图】 `background_url`、【商品券详情图列表】 `detail_image_url_list`<br>  <br>- 商品信息：【商品原价】 `original_price` | 用于设置商品券在客户端页面的展示信息，主要设置内容包含：<br>- 商品券基础信息：【商品券名称】 `name`<br>  <br>- 图片类信息：【商品券图片】 `image_url`、【商品券背景图】 `background_url`、【商品券详情图列表】 `detail_image_url_list`<br>  <br>- 商品信息：【商品原价】 `original_price` |
| 商品券信息 | 【展示信息】 `display_info` | 全场券无需设置商品信息：【适用商品组合】 `combo_package_list` | 单品券必须设置商品信息：【适用商品组合】 `combo_package_list` |
| 商品券信息 | 【使用模式】 `usage_mode` | 设置商品券的使用模式，多次优惠取值“ `PROGRESSIVE_BUNDLE`” | 设置商品券的使用模式，多次优惠取值“ `PROGRESSIVE_BUNDLE`” |
| 商品券信息 | 【优惠范围】 `scope` | 设置商品券的优惠范围，取值“ `ALL`” | 设置商品券的优惠范围，取值“ `SINGLE`” |
| 商品券信息 | 【商品券类型】 `type` | 设置商品券的优惠类型，可设置两种：<br>-满减券： `NORMAL`<br>-折扣券： `DISCOUNT` | 设置商品券的优惠类型，可设置三种：<br>-满减券： `NORMAL`<br>-折扣券： `DISCOUNT`<br>-兑换券： `EXCHANGE` |
| 商品券信息 | 【多次优惠模式信息】 `progressive_bundle_usage_info` | 主要用于设置多次优惠模式的配置信息，主要设置内容包含：<br>- 次数信息：【可使用次数】 `count`<br>  <br>- 使用间隔信息：【多次优惠使用间隔天数】 `interval_days` | 主要用于设置多次优惠模式的配置信息，主要设置内容包含：<br>- 次数信息：【可使用次数】 `count`<br>  <br>- 使用间隔信息：【多次优惠使用间隔天数】 `interval_days` |
| 批次信息 | 【多次优惠批次组使用规则】 `progressive_bundle_usage_rule` | 设置商品券的可核销时间，即券的有效期，只有在有效期内用户才能使用券。<br>可核销时间信息：【券可核销时间】 `coupon_available_period` | 设置商品券的可核销时间，即券的有效期，只有在有效期内用户才能使用券。<br>可核销时间信息：【券可核销时间】 `coupon_available_period` |
| 批次信息 | 【多次优惠批次组使用规则】 `progressive_bundle_usage_rule` | 设置商品券的优惠力度，主要设置内容包含：<br>- 门槛信息：【门槛金额】 `threshold`<br>  <br>- 减免额度信息：<br>  <br>  -满减券：【固定减免金额】 `discount_amount`<br>  <br>  -折扣券：【固定减免百分比】 `percent_off` | 设置商品券的优惠力度，主要设置内容包含：<br>- 门槛信息：【门槛金额】 `threshold`<br>  <br>- 减免额度信息：<br>  <br>  -满减券：【固定减免金额】 `discount_amount`<br>  <br>  -折扣券：【固定减免百分比】 `percent_off`<br>  <br>  -兑换券：【固定兑换价格】 `exchange_price` |
| 批次信息 | 【批次组】 `stock_bundle` | 设置批次组的发放信息与门店信息，主要设置内容包含：<br>- 发放信息：【券Code分配模式】 `coupon_code_mode`、【批次组发放规则】 `stock_send_rule`、【事件通知配置】 `notify_config`<br>  <br>- 门店信息：【可用门店范围】 `store_scope` | 设置批次组的发放信息与门店信息，主要设置内容包含：<br>- 发放信息：【券Code分配模式】 `coupon_code_mode`、【批次组发放规则】 `stock_send_rule`、【事件通知配置】 `notify_config`<br>  <br>- 门店信息：【可用门店范围】 `store_scope` |
| 批次信息 | 【券使用规则展示信息】 `usage_rule_display_info` | 用于设置商品券在客户端页面的展示券详情信息，主要设置内容包含：<br>- 券使用方式：【券使用方式列表】 `coupon_usage_method_list`<br>  <br>- 使用券的跳转链接：【小程序跳转路径】 `mini_program_path`、【APP跳转路径】 `app_path`<br>  <br>- 券使用说明：【券使用说明】 `usage_description` | 用于设置商品券在客户端页面的展示券详情信息，主要设置内容包含：<br>- 券使用方式：【券使用方式列表】 `coupon_usage_method_list`<br>  <br>- 使用券的跳转链接：【小程序跳转路径】 `mini_program_path`、【APP跳转路径】 `app_path`<br>  <br>- 券使用说明：【券使用说明】 `usage_description` |
| 批次信息 | 【用户商品券展示信息】 `coupon_display_info` | 用于设置用户商品券在卡包中的展示详情，主要设置内容包含：<br>- 用户商品券展示信息：【用户商品券Code展示模式】 `code_display_mode`、【背景颜色】 `background_color`<br>  <br>- 自定义跳转入口信息：【小程序入口】 `entrance_mini_program`、【公众号入口】 `entrance_official_account`、【视频号入口】 `entrance_finder` | 用于设置用户商品券在卡包中的展示详情，主要设置内容包含：<br>- 用户商品券展示信息：【用户商品券Code展示模式】 `code_display_mode`、【背景颜色】 `background_color`<br>  <br>- 自定义跳转入口信息：【小程序入口】 `entrance_mini_program`、【公众号入口】 `entrance_official_account`、【视频号入口】 `entrance_finder` |
| 用户券信息 | 【用户商品券Code】 `coupon_code` | 记录用户的领券信息，券code是券的唯一标识 | 记录用户的领券信息，券code是券的唯一标识 |
| 用户券信息 | 【用户券组信息】 `user_product_coupon_bundle_info` | 记录了用户券组信息、券在组内的索引信息，以及使用情况，主要内容包含：<br>- 券组信息：【用户券组ID】 `user_coupon_bundle_id`<br>  <br>- 组内索引：【用户券组内索引】 `user_coupon_bundle_index`<br>  <br>- 使用情况：【总可使用次数】 `total_count`、【已使用次数】 `used_count` | 记录了用户券组信息、券在组内的索引信息，以及使用情况，主要内容包含：<br>- 券组信息：【用户券组ID】 `user_coupon_bundle_id`<br>  <br>- 组内索引：【用户券组内索引】 `user_coupon_bundle_index`<br>  <br>- 使用情况：【总可使用次数】 `total_count`、【已使用次数】 `used_count` |

### 2.3、修改商品券信息、批次信息

成功创建商品券后，若需修改商品券信息、批次信息，可调用接口进行修改，但不是所有字段都支持修改，具体可修改的字段可参考下表：

| 信息结构 | 接口 | 可修改字段 |
| --- | --- | --- |
| 商品券信息 | 修改商品券（[品牌](https://pay.weixin.qq.com/doc/brand/4015736325.md)/[服务商](https://pay.weixin.qq.com/doc/v3/partner/4015781296.md)） | 用于修改商品券信息，可修改字段如下：<br>【展示信息】 `display_info`：<br>- 商品券基础信息：【商品券名称】 `name`<br>  <br>- 图片类信息：【商品券图片】 `image_url`、【商品券背景图】 `background_url`、【商品券详情图列表】 `detail_image_url_list`<br>  <br>- 商品信息：【商品原价】 `original_price`、【适用商品组合】 `combo_package_list` |
| 批次信息 | 单券模式：修改商品券批次（[品牌](https://pay.weixin.qq.com/doc/brand/4015736391.md)/[服务商](https://pay.weixin.qq.com/doc/v3/partner/4015781556.md)）<br>多次优惠模式：修改商品券批次组（[品牌](https://pay.weixin.qq.com/doc/brand/4016279735.md)/[服务商](https://pay.weixin.qq.com/doc/v3/partner/4016280633.md)） | 用于修改单券模式的批次信息，可修改字段如下：<br>1、【券使用规则展示信息】 `usage_rule_display_info`：<br>- 券使用方式：【券使用方式列表】 `coupon_usage_method_list`<br>  <br>- 使用券的跳转链接：【小程序跳转路径】 `mini_program_path`、【APP跳转路径】 `app_path`<br>  <br>- 券使用说明：【券使用说明】 `usage_description`<br>  <br>2、【用户商品券展示信息】 `coupon_display_info`：<br>- 用户商品券展示信息：【用户商品券Code展示模式】 `code_display_mode`、【背景颜色】 `background_color`<br>  <br>- 自定义跳转入口信息：【小程序入口】 `entrance_mini_program`、【公众号入口】 `entrance_official_account`、【视频号入口】 `entrance_finder`<br>  <br>3、发放信息：【事件通知配置】 `notify_config`<br>4、门店信息：【可用门店范围】 `store_scope` |

## 三、各字段在客户端的展示

### 3.1、单券模式展示说明

| 客户端页面示例图 | 对应字段说明 |
| --- | --- |
| ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/3d340f9586854f598a4ac234e14a5de2.png) | 一、“商品券详情”页面的查看路径：<br>- 已领取的券：“摇优惠”功能-我的-待使用优惠-点击查看具体的券<br>  <br>- 未领取的券：“摇优惠”功能-我的-周边的优惠-点击查看具体的券<br>  <br>二、“商品券详情”页面包含的字段内容：<br>1、头部图片为【展示信息】 `display_info` 中的【商品券图片】 `image_url`、【商品券背景图】 `background_url`。<br>2、头部展示的商品券优惠信息为【商品券类型】 `type`、【商品券名称】 `name`、<br>【单券使用规则】 `single_usage_rule` 中设置的门槛和优惠力度。<br>3、“可用门店”的展示情况根据商品券设置的【可用门店范围】 `store_scope` 而定，如果展示，点击可用门店后将跳转到【券可用门店信息】 `coupon_available_store_info` 中设置的跳转地址。<br>4、如果是单品券，还会在“详情”区域展示【展示信息】 `display_info` 中【适用商品组合】 `combo_package_list` 设置的各单品信息。<br>5、“使用须知”中展示的可用时间为微信侧根据【券可核销时间】 `coupon_available_period` 设置的核销时间规则计算出的券有效期；<br>使用方式为【券使用方式列表】 `coupon_usage_method_list`；<br>其他说明为【券使用说明】 `usage_description`<br>6、若用户已领取券，“商品券详情”页面将根据【券使用方式列表】 `coupon_usage_method_list` 提供核销入口；<br>注意：除了“商品券详情”页面能提供核销入口外，商户侧接入核销组件也能实现在商户侧小程序内为用户提供核销入口，核销组件会根据【适用商品组合】 `combo_package_list` 的设置展示各单品信息，以及跳转路径。 |

### 3.2、多次优惠模式展示说明

| 客户端页面示例图 | 对应字段说明 |
| --- | --- |
| ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/77fe5e17211a0abf26de59b1b2835d33.png) | 一、“商品券详情”页面的查看路径：<br>- 已领取的券：“摇优惠”功能-我的-待使用优惠-点击查看具体的券<br>  <br>- 未领取的券：“摇优惠”功能-我的-周边的优惠-点击查看具体的券<br>  <br>二、“商品券详情”页面包含的字段内容：<br>1、头部图片为【展示信息】 `display_info` 中的【商品券图片】 `image_url`、【商品券背景图】 `background_url`。<br>2、头部展示的商品券优惠信息为【商品券类型】 `type`、【商品券名称】 `name`，【多次优惠批次组使用规则】progressive\_bundle\_usage\_rule中设置的首次使用的优惠力度，以及微信侧根据【券可核销时间】 `coupon_available_period` 设置的核销时间规则计算出的券有效期。<br>3、“优惠说明”部分的内容为【多次优惠模式信息】 `progressive_bundle_usage_info` 中设置的【可使用次数】count，以及【多次优惠批次组使用规则】 `progressive_bundle_usage_rule` 中设置的每轮门槛和优惠力度。<br>4、“可用门店”的展示情况根据商品券设置的【可用门店范围】 `store_scope` 而定，如果展示，点击可用门店后将跳转到【券可用门店信息】 `coupon_available_store_info` 中设置的跳转地址。<br>5、如果是单品券，还会在“详情”区域展示【展示信息】 `display_info` 中【适用商品组合】 `combo_package_list` 设置的各单品信息。<br>6、“使用须知”中展示的可用时间为微信侧根据【券可核销时间】 `coupon_available_period` 设置的核销时间规则计算出的券有效期；<br>使用方式为【券使用方式列表】 `coupon_usage_method_list`；<br>其他说明为【券使用说明】 `usage_description`<br>7、若用户已领取券，“商品券详情”页面将根据【券使用方式列表】 `coupon_usage_method_list` 提供核销入口；<br>注意：除了“商品券详情”页面能提供核销入口外，商户侧接入核销组件也能实现在商户侧小程序内为用户提供核销入口，核销组件会根据【适用商品组合】 `combo_package_list` 的设置展示各单品信息，以及跳转路径。 |

## 四、差异对比

### 4.1、「使用模式」差异对比（单券与多次优惠）

| 对比维度 | 单券模式 | 多次优惠模式 |
| --- | --- | --- |
| 商品券结构 | 全场券的优惠力度 `single_usage_info ` 设置在商品券层 | 全场券的优惠力度 `single_usage_info` 设置在批次层 |
| 商品券结构 | 没有批次组 `stock_bundle ` 结构 | 有批次组 `stock_bundle ` 结构 |
| 商户管理商品券 | 批次的有效期是按单个批次的维度计算的 | 批次的有效期是按批次组的维度计算的，即批次组下的每个批次的有效期都是统一的，并非单个批次可以单独设置有效期 |
| 商户管理商品券 | 可失效单个批次 | 无法失效单个批次与批次组 |
| 商户管理商品券 | 用户领一次券，微信侧发送一次回调通知给商户 | 用户领一次券组，微信侧发送券组中第一轮优惠券的回调通知给商户，用户使用第一轮优惠券后，微信侧发送券组中第二轮优惠券信息，以此类推，商户侧会收到多轮回调通知 |
| 用户体验 | 一次领取行为获得一张券 | 一次领取行为获得一个“券包”(用户券组)，包含多张券 |
| 用户体验 | 用户只会领取到一张券，因此只展示这一张券的门槛和优惠力度。 | 因为用户券组包含多张券，因此会展示每张券的门槛和优惠力度。 |

### 4.2、「优惠范围」差异对比（全场与单品）

| 对比维度 | 全场券 | 单品券 |
| --- | --- | --- |
| 商品券结构 | 单券模式下，全场券的优惠力度 `single_usage_info` 设置在商品券层 | 单券模式下，单品券的优惠力度 `single_usage_info` 设置在批次层 |
| 商品券结构 | 全场券无需设置商品信息：【适用商品组合】 `combo_package_list` | 单品券必须设置商品信息：【适用商品组合】 `combo_package_list` |
| 优惠类型 | 无法设置“兑换”类型的优惠，仅支持设置“满减”和“折扣”类型 | “兑换”、“满减”和“折扣”类型的优惠都支持设置 |
| 用户体验 | 由于全场券无需设置【适用商品组合】，因此查看券详情时，没有“详情”区域用于展示商品列表 | 由于单品券会设置【适用商品组合】，因此查看券详情时，有“详情”区域用于展示商品列表 |