重启批次

更新时间:2024.05.28

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

接口频率:不区分来源 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
使用该域名将访问异地的接入点 ,指引点击查看

# 请求参数

    Header HTTP头参数
  • Authorization 必填 string
    请参考 签名认证 生成认证信息
  • Accept 必填 string
    请设置为 application/json
  • Content-Type 必填 string
    请设置为 application/json
    Path 路径参数
  • stock_id 必填 string(20)
    【批次号】 微信为每个代金券批次分配的唯一id。
    校验规则:必须为代金券(全场券或单品券)批次号,不支持立减与折扣。
    Body 包体参数
  • stock_creator_mchid 必填 string(20)
    【创建批次的商户号】 批次创建方商户号。
    校验规则:接口传入的批次号需由stock_creator_mchid所创建。

请求示例

POST

# 应答参数

    200OK
  • restart_time 必填 string
    【生效时间】 生效时间,遵循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)
    【批次号】 微信为每个代金券批次分配的唯一id。

应答示例

200 OK

# 错误码

# 公共错误码

状态码 错误码 描述 解决方案
400 PARAM_ERROR 参数错误 请根据错误提示正确传入参数
400 INVALID_REQUEST HTTP 请求不符合微信支付 APIv3 接口规则 请参阅 接口规则
401 SIGN_ERROR 验证不通过 请参阅 签名常见问题
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 请求过于频繁 稍后重试
反馈
咨询
目录