---
url: "https://pay.weixin.qq.com/doc/v3/merchant/4012460411.md"
title: "重启代金券批次"
doc_id: 4012460411
---

>更新时间：2024.09.19

通过此接口可重启指定代金券批次。重启后，该代金券批次可以再次发放。

**接口频率**：不区分来源 1000/min 单ip 60/min

**接口耗时**：1S

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




## 接口说明

支持商户：【普通商户】

请求方式：【POST】 `/v3/marketing/favor/stocks/{stock_id}/restart`

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

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

## 请求参数

### Header 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| Authorization | string | true | 请参考 [签名认证](https://pay.weixin.qq.com/doc/v3/merchant/4012365342.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 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| stock_id | string(20) | true | **【批次号】** 微信为每个代金券批次分配的唯一id。<br>校验规则：必须为代金券（全场券或单品券）批次号，不支持立减与折扣。 |
### Body 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| stock_creator_mchid | string(20) | true | **【创建批次的商户号】** 批次创建方商户号。<br>校验规则：接口传入的批次号需由stock\_creator\_mchid所创建。 |
## 应答参数

200 OK

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| restart_time | string | true | **【生效时间】** 生效时间，遵循 [rfc3339](https://datatracker.ietf.org/doc/html/rfc3339) 标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日 13点29分35秒。 |
| stock_id | string(20) | true | **【批次号】** 微信为每个代金券批次分配的唯一id。 |
## 错误码

### 公共错误码

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

### 业务错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | APPID\_MCHID\_NOT\_MATCH | 商户号与AppID不匹配 | 请绑定调用接口的商户号和AppID后重试 |
| 400 | INVALID\_REQUEST | OpenID与AppID不匹配 | 请使用AppID下的OpenID |
| 400 | INVALID\_REQUEST | 活动已结束或未激活 | 请检查批次状态 |
| 400 | INVALID\_REQUEST | 非法的商户号 | 请检查商户号是否正确 |
| 400 | INVALID\_REQUEST | 批次规则尚未同步完成，请稍后重试 | 稍后重试 |
| 400 | MCH\_NOT\_EXISTS | 商户号不合法 | 请输入正确的商户号 |
| 400 | PARAM\_ERROR | 回调URL不能为空 | 请填写回调URL |
| 400 | PARAM\_ERROR | 回调商户不能为空 | 请填写回调商户 |
| 400 | PARAM\_ERROR | 券ID必填 | 请填写券ID |
| 400 | PARAM\_ERROR | AppID必填 | 请输入AppID |
| 400 | PARAM\_ERROR | OpenID必填 | 请输入OpenID |
| 400 | PARAM\_ERROR | 页大小超过阈值 | 请不要超过最大的页大小 |
| 400 | PARAM\_ERROR | 输入时间格式错误 | 请输入正确的时间格式 |
| 400 | PARAM\_ERROR | 批次号必填 | 请输入批次号 |
| 400 | PARAM\_ERROR | 商户号必填 | 请输入商户号 |
| 400 | PARAM\_ERROR | 非法的批次状态 | 请检查批次状态 |
| 403 | NOT\_ENOUGH | 批次预算不足 | 请补充预算 |
| 403 | REQUEST\_BLOCKED | 调用商户无权限 | 请开通产品权限后再调用该接口 |
| 403 | REQUEST\_BLOCKED | 商户无权发券 | 调用接口的商户号无权发券，请检查是否是自己的批次或是已授权的批次。 |
| 403 | REQUEST\_BLOCKED | 批次不支持跨商户发券 | 该批次未做跨商户号的授权，请授权后再发放 |
| 403 | REQUEST\_BLOCKED | 用户被限领拦截 | 用户领取已经达到上限，请调高上限或停止发放。 |
| 403 | USER\_ACCOUNT\_ABNORMAL | 用户非法 | 该用户账号异常，无法领券。商家可联系微信支付或让用户联系微信支付客服处理。 |
| 404 | RESOURCE\_NOT\_EXISTS | 批次不存在 | 请检查批次ID是否正确 |
| 429 | FREQUENCY\_LIMITED | 请求过于频繁 | 稍后重试 |

请求示例

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


应答示例

> 200 OK

```
{
  "restart_time" : "2015-05-20T13:29:35.120+08:00",
  "stock_id" : "9865000"
}

```
