开通广告展示API

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


此接口为特约商户的点金计划页面开通广告展示功能,可同时配置同业过滤标签,防止特约商户支付后出现同行业的广告内容。

注意:

• 最多可传入3个同业过滤标签值

接口说明

适用对象: 服务商 渠道商

请求URL:https://api.mch.weixin.qq.com/v3/goldplan/merchants/open-advertising-show

请求方式:PATCH

接口规则:https://wechatpay-api.gitbook.io/wechatpay-api-v3


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"
  ]
}

{
JAVA示例代码
}

返回参数


处理成功,应答无内容

返回示例

 
204
处理成功,应答无内容
                    

http://2323weixin.qq.com
                    

错误码公共错误码

状态码 错误码 描述 解决方案
400 INVALID_REQUEST 调用方非普通服务商/渠道商 只有普通服务商和渠道商才能调用该接口
400 INVALID_REQUEST 服务商未开通点金计划 请在服务商平台先行开通点金计划后再试
400 INVALID_REQUEST 服务商被处罚中 请在服务商平台处理处罚后再试
400 INVALID_REQUEST 特约商户未开通点金计划 该商户暂未开通点金计划,请开通后配置
400 INVALID_REQUEST 特约商户被处罚中 请让特约商户在商户平台处理处罚后再试
400 MCH_NOT_EXISTS 特约商户号不存在 特约商户号不存在,请确认特约商户号准确性
400 PARAM_ERROR 参数错误 根据错误提示,传入正确参数
500 SYSTEM ERROR 系统繁忙,请稍后重试 5开头错误码都为系统问题,请使用相同参数稍后重新调用
500 operation failed 请求操作失败,请稍后重试 5开头错误码都为系统问题,请使用相同参数稍后重新调用
500 SIGN ERROR 签名验证失败 5开头错误码都为系统问题,请使用相同参数稍后重新调用
400 INVALID_REQUEST 操作失败 操作失败,请稍后重试
500 SYSTEMERROR 特约商户信息系统错误 系统错误,请稍后重试。请使用相同参数稍后重新调用
400 INVALID_REQUEST 特约商户信息逻辑错误 特约商户号不存在或不是当前服务商的特约商户
400 INVALID_REQUEST 命中频率限制 接口调用速度过快,请降低频率调用该接口
400 INVALID_REQUEST 商户类型不合法 只有普通服务商和普通渠道商才能调用该接口
400 INVALID_REQUEST 商户关系错误 特约商户号不存在或不是当前服务商的特约商户
400 INVALID_REQUEST 服务商未开通点金计划 服务商未开通点金计划,请开通服务商后重试


版本说明

关闭
V1.0
2020年08月27
打开广告展示接口上线

技术咨询

反馈有奖