最新更新时间:2020.08.27 版本说明
此接口为特约商户的点金计划页面开通广告展示功能,可同时配置同业过滤标签,防止特约商户支付后出现同行业的广告内容。
• 最多可传入3个同业过滤标签值
适用对象: 服务商
请求URL:https://api.mch.weixin.qq.com/v3/goldplan/merchants/open-advertising-show
请求方式:PATCH
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
特约商户号 | sub_mchid | string[1, 32] | 是 | body 需要开通广告展示的特约商户号,由微信支付生成并下发。 示例值:1900000109 |
同业过滤标签值 | advertising_industry_filters | array | 否 | body特约商户同业过滤的同业过滤标签值 如已设置同业过滤标签,再次请求传入,视为新增,将覆盖原有同业标签配置 E_COMMERCE:综合电商平台 LOVE_MARRIAGE:婚恋 POTOGRAPHY:摄影摄像机构及服务 EDUCATION:教育 FINANCE:金融 TOURISM:旅游 SKINCARE:护肤彩妆 FOOD:食品 SPORT:运动户外 JEWELRY_WATCH:珠宝钟表 HEALTHCARE:医疗健康 BUSSINESS:商务服务 PARENTING:亲子 CATERING:餐饮美食 RETAIL:零售百货 SERVICES:生活服务 LAW:法律服务 ESTATE:房地产 TRANSPORTATION:交通运输 ENERGY_SAVING:节能环保 SECURITY:安全安保 BUILDING_MATERIAL:家居装修建材 COMMUNICATION:通讯及IT服务 MERCHANDISE:日用百货 ASSOCIATION:机构协会 COMMUNITY:网络资讯及社区 ONLINE_AVR:在线视听与阅读 WE_MEDIA:自媒体 CAR:汽车 SOFTWARE:软件工具 GAME:游戏 CLOTHING:服饰鞋帽箱包 INDUSTY:工业工程 AGRICULTURE:农林牧渔 PUBLISHING_MEDIA:出版传媒 HOME_DIGITAL:数码家电 示例值:SOFTWARE,SECURITY,LOVE_MARRIAGE |
{
"sub_mchid": "1900000109",
"advertising_industry_filters": [
"SOFTWARE",
"SECURITY",
"LOVE_MARRIAGE"
]
}
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | INVALID_REQUEST | 调用方非普通服务商/渠道商 | 只有普通服务商和渠道商才能调用该接口 |
服务商未开通点金计划 | 请在服务商平台先行开通点金计划后再试 | ||
服务商被处罚中 | 请在服务商平台处理处罚后再试 | ||
特约商户未开通点金计划 | 该商户暂未开通点金计划,请开通后配置 | ||
特约商户被处罚中 | 请让特约商户在商户平台处理处罚后再试 | ||
特约商户信息逻辑错误 | 特约商户号不存在或不是当前服务商的特约商户 | ||
命中频率限制 | 接口调用速度过快,请降低频率调用该接口 | ||
商户类型不合法 | 只有普通服务商和普通渠道商才能调用该接口 | ||
商户关系错误 | 特约商户号不存在或不是当前服务商的特约商户 | ||
服务商未开通点金计划 | 服务商未开通点金计划,请开通服务商后重试 | ||
操作失败 | 操作失败,请稍后重试 | ||
400 | MCH_NOT_EXISTS | 特约商户号不存在 | 特约商户号不存在,请确认特约商户号准确性 |
400 | PARAM_ERROR | 参数错误 | 根据错误提示,传入正确参数 |
500 | SYSTEM ERROR | 系统繁忙,请稍后重试 | 5开头错误码都为系统问题,请使用相同参数稍后重新调用 |
500 | operation failed | 请求操作失败,请稍后重试 | 5开头错误码都为系统问题,请使用相同参数稍后重新调用 |
500 | SIGN ERROR | 签名验证失败 | 5开头错误码都为系统问题,请使用相同参数稍后重新调用 |
500 | SYSTEMERROR | 特约商户信息系统错误 | 系统错误,请稍后重试。请使用相同参数稍后重新调用 |