>更新时间：2026.07.08

# 微信支付 - 商品券（单券）（普通服务商）文档索引

> 商品券（单券）为单次使用的优惠券，每次发放只会发放一张券，支持满减、折扣、兑换等类型，可设置全场或单品可用，适合短期促销、新人礼、单品特惠等场景。

## 接入指引
- [产品介绍](https://pay.weixin.qq.com/doc/v3/partner/4015989376.md)
- [常见问题](https://pay.weixin.qq.com/doc/v3/partner/4016950421.md)
- [开发指引](https://pay.weixin.qq.com/doc/v3/partner/4015788446.md)
- [错误码](https://pay.weixin.qq.com/doc/v3/partner/4023148522.md)

## API 列表
- [图片上传](https://pay.weixin.qq.com/doc/v3/partner/4015781275.md)
### 商品券管理
- [创建商品券](https://pay.weixin.qq.com/doc/v3/partner/4015781289.md)
- [修改商品券](https://pay.weixin.qq.com/doc/v3/partner/4015781296.md)
- [查询商品券](https://pay.weixin.qq.com/doc/v3/partner/4015781292.md)
- [失效商品券](https://pay.weixin.qq.com/doc/v3/partner/4015781290.md)
### 商品券批次管理
- [添加商品券批次](https://pay.weixin.qq.com/doc/v3/partner/4015781304.md)
- [查询商品券批次列表](https://pay.weixin.qq.com/doc/v3/partner/4015781553.md)
- [查询商品券指定批次](https://pay.weixin.qq.com/doc/v3/partner/4015781542.md)
- [修改商品券批次](https://pay.weixin.qq.com/doc/v3/partner/4015781556.md)
- [修改商品券批次发放预算](https://pay.weixin.qq.com/doc/v3/partner/4015781561.md)
- [失效商品券批次](https://pay.weixin.qq.com/doc/v3/partner/4015781532.md)
- [批次关联门店](https://pay.weixin.qq.com/doc/v3/partner/4015781302.md)
- [查询批次关联门店列表](https://pay.weixin.qq.com/doc/v3/partner/4015781546.md)
- [批次取消关联门店](https://pay.weixin.qq.com/doc/v3/partner/4015781537.md)
- [预上传券Code](https://pay.weixin.qq.com/doc/v3/partner/4015781572.md)
### 商品券发放
- [向用户发放商品券](https://pay.weixin.qq.com/doc/v3/partner/4015781605.md)
- [确认发放用户商品券](https://pay.weixin.qq.com/doc/v3/partner/4015781575.md)
#### 小程序发券组件
- [向用户预发放商品券](https://pay.weixin.qq.com/doc/v3/partner/4016434365.md)
- [调起小程序发券组件](https://pay.weixin.qq.com/doc/v3/partner/4016434346.md)
### 商品券核销
- [核销用户商品券](https://pay.weixin.qq.com/doc/v3/partner/4015781608.md)
- [调起小程序核销组件](https://pay.weixin.qq.com/doc/v3/partner/4016110739.md)
### 商品券查询
- [查询用户商品券详情](https://pay.weixin.qq.com/doc/v3/partner/4015781582.md)
- [指定券状态查询用户商品券列表](https://pay.weixin.qq.com/doc/v3/partner/4015781590.md)
### 商品券失效与退券
- [失效用户商品券](https://pay.weixin.qq.com/doc/v3/partner/4015781578.md)
- [退券](https://pay.weixin.qq.com/doc/v3/partner/4015781599.md)
### 商品券回调通知
- [获取商品券事件通知地址](https://pay.weixin.qq.com/doc/v3/partner/4015781284.md)
- [设置商品券事件通知地址](https://pay.weixin.qq.com/doc/v3/partner/4015781286.md)
- [商品券回调通知](https://pay.weixin.qq.com/doc/v3/partner/4015780862.md)
### 生成商品券头图
- [提交图片生成任务](https://pay.weixin.qq.com/doc/v3/partner/4017327735.md)
- [查询图片生成任务执行结果](https://pay.weixin.qq.com/doc/v3/partner/4017327739.md)
- [图片生成回调通知](https://pay.weixin.qq.com/doc/v3/partner/4017327744.md)

## 请求示例
- [修改商品券 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781296-curl.md)
- [修改商品券 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781296-java.md)
- [修改商品券 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781296-go.md)
- [修改商品券批次 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781556-curl.md)
- [修改商品券批次 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781556-java.md)
- [修改商品券批次 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781556-go.md)
- [修改商品券批次发放预算 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781561-curl.md)
- [修改商品券批次发放预算 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781561-java.md)
- [修改商品券批次发放预算 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781561-go.md)
- [创建商品券 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781289-curl.md)
- [创建商品券 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781289-java.md)
- [创建商品券 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781289-go.md)
- [向用户发放商品券 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781605-curl.md)
- [向用户发放商品券 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781605-java.md)
- [向用户发放商品券 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781605-go.md)
- [向用户预发放商品券 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4016434365-curl.md)
- [向用户预发放商品券 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4016434365-java.md)
- [向用户预发放商品券 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4016434365-go.md)
- [图片上传 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781275-curl.md)
- [图片上传 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781275-java.md)
- [图片上传 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781275-go.md)
- [失效商品券 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781290-curl.md)
- [失效商品券 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781290-java.md)
- [失效商品券 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781290-go.md)
- [失效商品券批次 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781532-curl.md)
- [失效商品券批次 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781532-java.md)
- [失效商品券批次 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781532-go.md)
- [失效用户商品券 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781578-curl.md)
- [失效用户商品券 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781578-java.md)
- [失效用户商品券 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781578-go.md)
- [批次关联门店 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781302-curl.md)
- [批次关联门店 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781302-java.md)
- [批次关联门店 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781302-go.md)
- [批次取消关联门店 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781537-curl.md)
- [批次取消关联门店 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781537-java.md)
- [批次取消关联门店 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781537-go.md)
- [指定券状态查询用户商品券列表 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781590-curl.md)
- [指定券状态查询用户商品券列表 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781590-java.md)
- [指定券状态查询用户商品券列表 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781590-go.md)
- [提交图片生成任务 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4017327735-curl.md)
- [提交图片生成任务 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4017327735-java.md)
- [提交图片生成任务 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4017327735-go.md)
- [查询商品券 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781292-curl.md)
- [查询商品券 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781292-java.md)
- [查询商品券 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781292-go.md)
- [查询商品券批次列表 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781553-curl.md)
- [查询商品券批次列表 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781553-java.md)
- [查询商品券批次列表 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781553-go.md)
- [查询商品券指定批次 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781542-curl.md)
- [查询商品券指定批次 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781542-java.md)
- [查询商品券指定批次 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781542-go.md)
- [查询图片生成任务执行结果 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4017327739-curl.md)
- [查询图片生成任务执行结果 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4017327739-java.md)
- [查询图片生成任务执行结果 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4017327739-go.md)
- [查询批次关联门店列表 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781546-curl.md)
- [查询批次关联门店列表 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781546-java.md)
- [查询批次关联门店列表 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781546-go.md)
- [查询用户商品券详情 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781582-curl.md)
- [查询用户商品券详情 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781582-java.md)
- [查询用户商品券详情 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781582-go.md)
- [核销用户商品券 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781608-curl.md)
- [核销用户商品券 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781608-java.md)
- [核销用户商品券 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781608-go.md)
- [添加商品券批次 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781304-curl.md)
- [添加商品券批次 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781304-java.md)
- [添加商品券批次 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781304-go.md)
- [确认发放用户商品券 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781575-curl.md)
- [确认发放用户商品券 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781575-java.md)
- [确认发放用户商品券 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781575-go.md)
- [获取商品券事件通知地址 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781284-curl.md)
- [获取商品券事件通知地址 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781284-java.md)
- [获取商品券事件通知地址 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781284-go.md)
- [设置商品券事件通知地址 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781286-curl.md)
- [设置商品券事件通知地址 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781286-java.md)
- [设置商品券事件通知地址 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781286-go.md)
- [退券 - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781599-curl.md)
- [退券 - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781599-java.md)
- [退券 - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781599-go.md)
- [预上传券Code - curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781572-curl.md)
- [预上传券Code - Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781572-java.md)
- [预上传券Code - Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781572-go.md)

## 附录
- [小程序发券组件开发指引](https://pay.weixin.qq.com/doc/v3/partner/4016434329.md)
- [小程序核销组件开发指引](https://pay.weixin.qq.com/doc/v3/partner/4016110741.md)
- [品牌、服务商、appid关联关系](https://pay.weixin.qq.com/doc/v3/partner/4018984107.md)
- [商品券可核销时间规则说明（coupon_available_period）](https://pay.weixin.qq.com/doc/v3/partner/4016675999.md)
- [商品券客户端消息推送页面](https://pay.weixin.qq.com/doc/v3/partner/4019005729.md)
- [商品券结构及修改说明](https://pay.weixin.qq.com/doc/v3/partner/4018984452.md)
### API请求示例-创建商品券
- [【单券-全场-折扣券】API请求示例](https://pay.weixin.qq.com/doc/v3/partner/4016756270.md)
- [【单券-全场-满减券】API请求示例](https://pay.weixin.qq.com/doc/v3/partner/4016756271.md)
- [【单券-单品-折扣券】API请求示例](https://pay.weixin.qq.com/doc/v3/partner/4016756272.md)
- [【单券-单品-满减券】API请求示例](https://pay.weixin.qq.com/doc/v3/partner/4016756273.md)
- [【单券-单品-兑换券】API请求示例](https://pay.weixin.qq.com/doc/v3/partner/4016756274.md)

