基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
微信支付分(公共API)
微信支付分(免确认预授权模式)
微信支付分(需确认模式)
支付即服务
行业方案
智慧商圈
微信支付分停车服务
电子发票
营销工具
代金券
商家券
委托营销
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
商家转账到零钱
分账
风险合规
消费者投诉2.0
其他能力
清关报关
图片上传
视频上传
微信支付平台证书

修改批次预算API

最新更新时间:2020.11.04 版本说明


商户可以通过该接口修改批次单天发放上限数量或者批次最大发放数量

接口说明

适用对象: 直连商户

请求URL:https://api.mch.weixin.qq.com/v3/marketing/busifavor/stocks/{stock_id}/budget

请求方式:Patch

前置条件: 已创建商家券批次,且修改时间位于有效期结束时间前


path 指该参数为路径参数

query 指该参数为URL参数

body 指该参数需在请求JSON传参


请求参数

参数名 变量 类型[长度限制] 必填 描述
批次号 stock_id string[1,20] path批次号
示例值:98065001
目标批次最大发放个数 target_max_coupons int 二选一 body批次最大发放个数
注:目标批次即修改后的批次
示例值:3000
目标单天发放上限个数 target_max_coupons_by_day int body单天发放上限个数
注:目标批次即修改后的批次
示例值:500
当前批次最大发放个数 current_max_coupons int body当前批次最大发放个数,当传入target_max_coupons大于0时,current_max_coupons必传
注:当前批次即未修改的批次
示例值:500
当前单天发放上限个数 current_max_coupons_by_day int body当前单天发放上限个数 ,当传入target_max_coupons_by_day大于0时,current_max_coupons_by_day必填
注:当前批次即未修改的批次
示例值:300
修改预算请求单据号 modify_budget_request_no string[1,128] body修改预算请求单据号
示例值:1002600620019090123143254436

请求示例


{
  "target_max_coupons": 3000,
  "current_max_coupons": 500,
  "modify_budget_request_no": "1002600620019090123143254436"
}

{
JAVA示例代码
}

返回参数

参数名 变量 类型[长度限制] 必填 描述
批次当前最大发放个数 max_coupons int 批次最大发放个数
示例值:300
当前单天发放上限个数 max_coupons_by_day int 当前单天发放上限个数
示例值:100

返回示例


{
  "max_coupons": 300,
  "max_coupons_by_day": 100
}
                    

http://2323weixin.qq.com
                    

错误码公共错误码

状态码 错误码 描述 解决方案
404 RESOURCE_NOT_EXISTS 批次不存在 请检查批次id
403 RULELIMIT 仅创建方有权限使券失效 仅创建方有权限使券失效
404 RESOURCE_NOT_EXISTS 批次已过期 只能修改运行中的批次预算
403 RULELIMIT 批次正在修改中,请稍后重试 批次正在修改中,请稍后重试
403 RULE_LIMIT 批次库存的当前值错误,请获取批次详情查看最新值 批次库存的当前值错误,请获取批次详情查看最新值
403 RULELIMIT 目标库存数目不能小于批次已发放库存数目 目标库存数目不能小于批次已发放库存数目
429 FREQUENCY_LIMITED 调用太频繁,请降低调用接口频率 调用太频繁,请降低调用接口频率


技术咨询

文档反馈