该接口为服务商或商户给零售小店活动添加业务代理的专用接口。 使用对象：活动创建方商户号、活动归属品牌的品牌主商户号或品牌经营商户号。

接口说明

支持商户：

【普通商户】

请求方式：

【PUT】/v3/marketing/goods-subsidy-activity/retail-store-act/{activity_id}/representative

请求域名：

【主域名】

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 路径参数
activity_id 必填 string(128)
【零售小店活动ID】 零售小店活动ID

Body 包体参数
representative_info_list 必填 array[RepresentativeInfo]
【业务代理信息列表】 业务代理信息列表
• 属性
out_request_no 必填 string(128)
【请求业务单据号】 商户新增业务代理请求的唯一标识，商户需保证唯一。可包含英文字母，数字，|，_，*，-等内容，不允许出现其他不合法符号。
add_time 选填 string
【添加时间】 添加时间

请求示例

PUT

应答参数

200OK
activity_id 必填 string
【零售小店活动ID】 零售小店活动ID
failed_representative_info_list 选填 array[object]
【添加失败业务代理信息列表】 添加失败业务代理信息列表
• 属性
add_time 必填 string
【添加时间】 添加时间

应答示例

200 OK

错误码

公共错误码

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

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	无效请求	请根据接口返回的详细信息检查
500	SYSTEM_ERROR	系统错误	请使用相同参数稍后重新调用