---
url: "https://pay.weixin.qq.com/doc/v3/partner/4012463807.md"
title: "发放指定批次的代金券"
doc_id: 4012463807
---

>更新时间：2024.11.18

商户平台/API完成制券后，可使用发放代金券接口发券。通过调用此接口可发放指定批次给指定用户，发券场景可以是小程序、H5、APP等。

注意：

1. 商户可在H5活动页面、商户小程序、商户APP等自有场景内调用该接口完成发券，商户默认只允许发放本商户号（调用发券接口的商户号）创建的代金券，如需发放其他商户商户创建的代金券，请参考[常见问题](https://developers.weixin.qq.com/community/pay/doc/0000046f16862087608adcdf959c08)Q1。

2. 跨商户发券时，请求参数中除了stock\\\_id和stock\\\_creator\\\_mchid为创建方提供的数据，其他的所有调用数据都由发放方提供。


频率限制：500/s

处理耗时：100ms

幂等规则：接口支持幂等重入




## 接口说明

支持商户：【普通服务商】　【从业机构（银行）】　【从业机构（支付机构）】　【渠道商】　【清算机构】

请求方式：【POST】 `/v3/marketing/favor/users/{openid}/coupons`

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引[点击查看](https://pay.weixin.qq.com/doc/v3/partner/4012082567.md)

## 请求参数

### Header 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| Authorization | string | true | 请参考 [签名认证](https://pay.weixin.qq.com/doc/v3/partner/4012365870.md#%E8%AF%B7%E6%B1%82%E6%8E%A5%E5%8F%A3%E5%90%8E%E7%AB%AF%E7%AD%BE%E5%90%8D) 生成认证信息 |
| Accept | string | true | 请设置为 `application/json` |
| Content-Type | string | true | 请设置为 `application/json` |
### Path 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| openid | string(128) | true | **【用户openid】** openid信息，用户在appid下的唯一标识。<br>校验规则：该openid需要与接口传入中的appid有对应关系。 |
### Body 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| stock_id | string(20) | true | **【批次id】** 微信为每个批次分配的唯一id。<br>校验规则：必须为代金券（全场券或单品券）批次号，不支持立减与折扣。 |
| out_request_no | string(128) | true | **【商户单据号】** 商户此次发放凭据号（格式：商户id+日期+流水号），商户侧需保持唯一性 |
| appid | string(128) | true | **【公众账号ID】** 微信为发券方商户分配的公众账号ID，接口传入的所有appid应该为公众号的appid或者小程序的appid（在mp.weixin.qq.com申请的）或APP的appid（在open.weixin.qq.com申请的）。<br>校验规则：<br>1、该appid需要与接口传入中的openid有对应关系；<br>2、该appid需要与调用接口的商户号（即请求头中的商户号）有绑定关系，若未绑定，可参考该指引完成绑定（ [商家商户号与AppID账号关联管理](https://kf.qq.com/faq/1801116VJfua1801113QVNVz.html)） |
| stock_creator_mchid | string(20) | true | **【创建批次的商户号】** 批次创建方商户号。<br>校验规则：接口传入的批次号需由stock\_creator\_mchid所创建。 |
| coupon_value | integer | false | **【指定面额发券，面额】** 指定面额发券场景，券面额，其他场景不需要填，单位：分。 （该字段暂未开放 ）<br>校验规则：仅在发券时指定面额及门槛的场景才生效，常规发券场景请勿传入该信息。 |
| coupon_minimum | integer | false | **【指定面额发券，券门槛】** 指定面额发券批次门槛，其他场景不需要，单位：分。 （该字段暂未开放 ）<br>校验规则：仅在发券时指定面额及门槛的场景才生效，常规发券场景请勿传入该信息。 |
## 应答参数

200 OK

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| coupon_id | string | true | **【代金券id】** 微信为代金券唯一分配的id。 |
## 错误码

### 公共错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | PARAM\_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
| 400 | INVALID\_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 [接口规则](https://pay.weixin.qq.com/doc/v3/partner/4012081726.md) |
| 401 | SIGN\_ERROR | 验证不通过 | 请参阅 [签名常见问题](https://pay.weixin.qq.com/doc/v3/partner/4012082324.md) |
| 500 | SYSTEM\_ERROR | 系统异常，请稍后重试 | 请稍后重试 |

### 业务错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | APPID\_MCHID\_NOT\_MATCH | 商户号与AppID不匹配 | 调用接口的商户号需与接口传入的AppID有绑定关系，请参考[常见问题](https://developers.weixin.qq.com/community/pay/doc/0000046f16862087608adcdf959c08)Q4 |
| 400 | INVALID\_REQUEST | OpenID与AppID不匹配 | OpenID与AppID需有对应关系 |
| 400 | INVALID\_REQUEST | 非法的商户号 | 请检查商户号准确性 |
| 400 | INVALID\_REQUEST | 调用频率过高 | 请降低API调用频率 |
| 400 | INVALID\_REQUEST | 活动已结束或未激活 | 请检查批次状态 |
| 400 | INVALID\_REQUEST | 批次信息获取失败，请确认参数是否有误 | 请检查创建商户号与批次号的对应关系 |
| 400 | PARAM\_ERROR | AppID必填 | 请输入AppID |
| 400 | PARAM\_ERROR | OpenID必填 | 请输入OpenID |
| 400 | PARAM\_ERROR | 批次号必填 | 请输入批次号 |
| 400 | PARAM\_ERROR | 商户号必填 | 请输入商户号 |
| 400 | PARAM\_ERROR | 非法的批次状态 | 请检查批次状态，仅支持发放状态为“运营中”的代金券批次 |
| 403 | MCH\_NOT\_EXISTS | 商户号不合法 | 请检查商户号准确性 |
| 403 | NOT\_ENOUGH | 批次预算不足 | 批次预算已发放完，请补充批次预算 |
| 403 | NOT\_ENOUGH | 发券超过单天限额 | 已超过该批次设置的单天发放限制额度，无法发放 |
| 403 | NOT\_ENOUGH | 账户余额不足，请充值 | 商户号余额不足，无法继续发券，请充值 |
| 403 | NOT\_ENOUGH | 批次预算耗尽 | 该批次的预算已经耗尽 |
| 403 | REQUEST\_BLOCKED | 商户无权发券 | 该批次不支持其他商户发放，请参考[常见问题](https://developers.weixin.qq.com/community/pay/doc/0000046f16862087608adcdf959c08)Q1 |
| 403 | REQUEST\_BLOCKED | 批次不支持跨商户发券 | 该批次不支持其他商户发放，请参考[常见问题](https://developers.weixin.qq.com/community/pay/doc/0000046f16862087608adcdf959c08)Q1 |
| 403 | REQUEST\_BLOCKED | 用户被限领拦截 | 该用户已达到该批次的领取上限，请参考[常见问题](https://developers.weixin.qq.com/community/pay/doc/0000046f16862087608adcdf959c08)Q6 |
| 403 | REQUEST\_BLOCKED | 不能在API渠道发放 | 请检查批次信息，仅支持发放微信支付代金券，不支持发放立减与折扣 |
| 403 | REQUEST\_BLOCKED | 不支持指定面额发券 | 仅在发券时指定面额及门槛的场景才生效，常规发券场景请勿传入该信息 |
| 403 | REQUEST\_BLOCKED | 仅在广告场景下发放批次 | 该批次已在朋友圈广告发放，不支持在其他渠道发放 |
| 403 | RULE\_LIMIT | 用户已达最大领券次数 | 该用户已达到该批次的领取上限，请参考[常见问题](https://developers.weixin.qq.com/community/pay/doc/0000046f16862087608adcdf959c08)Q6 |
| 403 | RULE\_LIMIT | 被自然人规则拦截 | 该自然人已达到该批次的领取上限，请参考[常见问题](https://developers.weixin.qq.com/community/pay/doc/0000046f16862087608adcdf959c08)Q6 |
| 403 | USER\_ACCOUNT\_ABNORMAL | 用户非法 | 用户命中微信支付风控模型，请参考[常见问题](https://developers.weixin.qq.com/community/pay/doc/0000046f16862087608adcdf959c08)Q5 |
| 403 | USER\_ACCOUNT\_ABNORMAL | 用户未实名 | 该用户无实名信息，无法领券。商家可联系微信支付或让用户联系微信支付客服处理。 |
| 404 | RESOURCE\_NOT\_EXISTS | 批次不存在 | 请检查批次及制券商户号信息 |
| 429 | FREQUENCY\_LIMITED | 当前请求人数过多，请稍后重试 | 请降低API调用频率 |

请求示例

- [curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4012463807-curl.md)
- [Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4012463807-java.md)
- [Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4012463807-go.md)


应答示例

> 200 OK

```
{
  "coupon_id" : "9867041"
}

```
