给指定用户报名多笔立减活动

更新时间：2025.05.13

商户平台创建活动后，可以调用此接口给指定用户报名多笔立减活动。

接口说明

支持商户：【普通商户】

请求方式：【POST】/v3/marketing/bank-favor/users/{openid}/bank-multi-activity

请求域名：【主域名】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 路径参数

openid 　必填 string

【用户标识ID】用户标识ID，用户在公众账号ID下的唯一标识。校验规则：该用户标识ID需要与接口传入中的公众账号ID有对应关系。

body 包体参数

stock_id 　必填 string

【批次ID】微信为每个批次分配的唯一ID。校验规则：必须为绑定多笔立减活动的代金券

activity_id 　必填 string

【多笔立减活动ID】多笔立减活动ID

out_request_no 　必填 string

【商户单据号】商户此次发放凭据号（格式：商户ID+日期+流水号），商户侧需保持唯一性

appid 　必填 string

【公众账号ID】微信为发券方商户分配的公众账号ID，接口传入的所有appid应该为公众号的appid或者小程序的appid（在mp.weixin.qq.com申请的）或APP的appid（在open.weixin.qq.com申请的）。校验规则：1、该appid需要与接口传入中的openid有对应关系；2、该appid需要与调用接口的商户号（即请求头中的商户号）有绑定关系，若未绑定，可参考该指引完成绑定（商家商户号与AppID账号关联管理）

stock_creator_mchid 　必填 string

【创建批次的商户号】批次创建方商户号

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/marketing/bank-favor/users/oUpF8uMuAJO_M2pxb1Q9zNjWeS6o/bank-multi-activity \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "stock_id" : "9865888",
8    "activity_id" : "186745560",
9    "out_request_no" : "6122352020010133287985742",
10    "appid" : "wx57849631bb367f52",
11    "stock_creator_mchid" : "9800064"
12  }'
13

应答参数

200 OK

coupon_id 　必填 string

【代金券ID】优惠券的主键，唯一定义此资源的标识

应答示例

200 OK

1{
2  "coupon_id" : "9856888"
3}
4

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
403	RULE_LIMIT	用户已达最大领券次数	该用户已达到该批次的领取上限
403	REQUEST_BLOCKED	参数错误，请检查批次参数	活动未开始或已结束
403	NOT_ENOUGH	批次预算耗尽	该批次的预算已经耗尽
404	RESOURCE_NOT_EXISTS	批次不存在	请检查批次及制券商户号信息
403	NOT_ENOUGH	账户余额不足，请充值	商户号余额不足，无法继续发券，请充值
403	NOT_ENOUGH	发券超过单天限额	已超过该批次设置的单天发放限制额度，无法发放
403	REQUEST_BLOCKED	仅在广告场景下发放批次	该批次已在朋友圈广告发放，不支持在其他渠道发放
403	REQUEST_BLOCKED	商户号收款功能受限，无法发券	商户号收款功能受限
403	USER_ACCOUNT_ABNORMAL	用户未实名	该用户无实名信息，无法领券。商家可联系微信支付或让用户联系微信支付客服处理。
400	PARAM_ERROR	批次号必填	请输入批次号
400	PARAM_ERROR	活动ID必填	请输入活动ID
400	PARAM_ERROR	OpenID必填	请输入OpenID
400	PARAM_ERROR	商户单据号必填	请输入商户单据号
400	PARAM_ERROR	AppID必填	请输入AppID
400	PARAM_ERROR	商户号必填	请输入商户号
400	INVALID_REQUEST	非法的商户号	请检查商户号准确性
403	REQUEST_BLOCKED	批次不支持跨商户发券	该批次不支持其他商户发放
400	INVALID_REQUEST	OpenID与AppID不匹配	OpenID与AppID需有对应关系
400	APPID_MCHID_NOT_MATCH	商户号与AppID不匹配	调用接口的商户号需与接口传入的AppID有绑定关系
403	MCH_NOT_EXISTS	商户号不合法	请检查商户号准确性
429	FREQUENCY_LIMIT_EXCEED	接口限频	请降低调用频率

文档是否有帮助

更多支持

开发文档(服务商)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服