# 更新优惠券内容
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南。
接口英文名:updatecoupon
通过该接口可对优惠券内容进行更新。
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/coupon/update?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用。
# 第三方调用
本接口支持第三方平台代微信小店商家调用。第三方服务商调用模式介绍
该接口所属的权限集 id 为:132
服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代微信小店商家进行调用,具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String Parameters
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 接口调用凭证,可使用 access_token(微信小店商家)、authorizer_access_token(服务商代调用) |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 示例 | 说明 | 枚举 |
|---|---|---|---|---|---|
| coupon_id | string | 是 | 123456789 | 优惠券 ID | - |
| type | number | 是 | 优惠券类型 | 枚举值 | |
| name | string | 是 | 优惠券名称,最长 10 个中文字符 | - | |
| promote_info | object | 是 | 推广信息 | - | |
| discount_info | object | 否 | 优惠信息 | - | |
| receive_info | object | 是 | 领取信息 | - | |
| valid_info | object | 是 | 有效期信息 | - | |
| ext_info | object | 否 | 扩展信息 | - |
# Body.promote_info Object Payload
推广信息
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| promote_type | number | 是 | 推广类型。1=小店内推广,9=会员券,10=会员开卡礼券 |
# Body.discount_info Object Payload
优惠信息
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| discount_condition | object | 否 | 优惠门槛 |
| discount_num | number | 否 | 折扣数,5000=5折,范围 1000~10000,必须是 100 的整数倍,不可低于 2 折 |
| discount_fee | number | 否 | 优惠减免金额,单位为分,不可超过200元,同时如果是商品券,适用商品优惠后不可低于原价2折,如果是店铺满减券,不可低于价格门槛的2折。 |
# Body.receive_info Object Payload
领取信息
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| start_time | number | 是 | 领用开始时间(秒级时间戳) |
| end_time | number | 是 | 领用结束时间(秒级时间戳) |
| limit_num_one_person | number | 是 | 单人限领张数 |
| total_num | number | 是 | 领用总数 |
# Body.valid_info Object Payload
有效期信息
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| valid_type | number | 是 | 有效期类型。1=指定时间范围,2=生效天数 |
| valid_day_num | number | 否 | 有效期天数,valid_type=2 时必填 |
| start_time | number | 否 | 有效期开始时间(秒级时间戳),valid_type=1 时必填 |
| end_time | number | 否 | 有效期结束时间(秒级时间戳),valid_type=1 时必填 |
# Body.ext_info Object Payload
扩展信息
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| jump_product_id | string | 否 | 商品折扣券领取后跳转的商品 id |
| notes | string | 否 | 备注信息 |
# Body.discount_info.discount_condition Object Payload
优惠门槛
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| product_cnt | number | 否 | 商品件数门槛,不能和价格门槛同时设置 |
| product_price | number | 否 | 商品价格门槛,单位为分,不能和件数门槛同时设置 |
| product_ids | array | 否 | 商品 id 列表,商品券必填,最多 200 个 |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| errcode | number | 0 | 错误码 |
| errmsg | string | ok | 错误信息 |
| data | object | 返回数据 |
# Res.data Object Payload
返回数据
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| coupon_id | string | 123456789 | 优惠券 ID |
# 4. 枚举信息
# Body.type Enum
优惠券类型
| 枚举值 | 含义 | 必填字段 |
|---|---|---|
| 1 | 商品条件折券 | discount_condition.product_ids、discount_condition.product_cnt、discount_info.discount_num |
| 2 | 商品满减券 | discount_condition.product_ids、discount_condition.product_price、discount_info.discount_fee |
| 3 | 商品统一折扣券 | discount_condition.product_ids、discount_info.discount_num |
| 4 | 商品直减券(如果小于可用商品中的最小价格会提醒;没有商品时超过50w提醒) | discount_condition.product_ids、discount_info.discount_fee |
| 101 | 店铺条件折扣券 | discount_condition.product_cnt、discount_info.discount_num |
| 102 | 店铺满减券 | discount_condition.product_price、discount_info.discount_fee |
| 103 | 店铺统一折扣券 | discount_info.discount_num |
| 104 | 店铺直减券(如果小于可用商品中的最小价格会提醒;没有商品时超过50w提醒) | discount_info.discount_fee |
# 5. 注意事项
本接口无特殊注意事项
# 6. 代码示例
请求示例
{
"coupon_id": "123456789",
"type": 1,
"name": "双十二特惠券",
"discount_info": {
"discount_condition": {
"product_cnt": 2,
"product_ids": ["10000000000001", "10000000000002"]
},
"discount_num": 5500
},
"promote_info": { "promote_type": 1 },
"receive_info": {
"start_time": 1673110742,
"end_time": 1673196742,
"limit_num_one_person": 1,
"total_num": 100
},
"valid_info": {
"valid_type": 1,
"start_time": 1673110742,
"end_time": 1673196742
}
}
返回示例
{
"errcode": 0,
"errmsg": "ok",
"data": {
"coupon_id": "123456789"
}
}
# 7. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 |
|---|---|
| 10021005 | 优惠券名称太长 |
| 10021006 | 校验折扣数失败 |
| 10021007 | 校验优惠价格失败 |
| 10021008 | 校验直减券是否小于最低价格 |
| 10021009 | 校验领取时间失败 |
| 10021010 | 校验有效时间失败 |
| 10021011 | 校验优惠券总发放量失败 |
| 10021012 | 校验限领失败 |
| 10021013 | 校验商户失败 |
| 10021014 | 推广类型不对 |
| 10021021 | 校验入参失败,含有非商户的指定商品 |
| 10021024 | 优惠券信息违规 |
| 10021035 | 创建优惠券类型暂不支持 |
| 10021037 | 优惠券不存在 |
| 10021061 | 店铺未开启会员功能 |
# 8. 适用范围
本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明,均不可调用。
2026 年 06 月 03 日
补充 coupon_id 参数