微信门店小程序接口文档

目录
微信门店小程序接口文档
一、简介须知
二、权限须知
三、门店接口概览
四、接口开发
1.拉取门店小程序类目
2.创建门店小程序
3.查询门店小程序审核结果
4.修改门店小程序信息
5.从腾讯地图拉取省市区信息
6.在腾讯地图中搜索门店
7.在腾讯地图中创建门店
8.添加门店
9.更新门店信息
10.获取单个门店信息
11.获取门店信息列表
12.删除门店
13.升级流程 — 从门店管理迁移到门店小程序
14.业务接口-门店小程序卡券.

微信门店小程序接口文档
一、简介须知
门店小程序是公众平台向商户提供的对其线下门店相关功能的管理能力。门店小程序可设置到公众号介绍页、自定义菜单和图文消息中，通过附近关联导入出现在“附近的小程序”，也可应用在卡券、广告、WIFI等业务使用。
门店小程序接口是为商户提供批量新增、查询、修改、删除门店等主要功能，包括创建小程序商家账号，方便商户快速高效进行门店管理和操作。
备注：原门店管理权限可通过升级为门店小程序使用相关权限。
示例图：

二、权限须知
门店小程序权限开放给所有非个人公众号；拥有旧门店管理权限的公众号可通过升级获取门店小程序权限。
曾授权第三方旧门店管理权限集的公众号，门店小程序权限集默认授权原第三方。
三、门店接口概览

四、接口开发
1.拉取门店小程序类目
请求方式：GET（请使用https协议）
https://api.weixin.qq.com/wxa/get_merchant_category?access_token=TOKEN
请求参数：
参数
说明
access_token
调用接口凭证
返回json示例（门店小程序类目分一级和二级类目）：
{
“errcode”: 0,
“errmsg”: “ok”,
“data”: {
“all_category_info”: {
“categories”: [
{
“id”: 0,
“name”: “root”,
“level”: 0, //根节点，对应子节点是一级类目的id
“children”: [ //子节点列表
269,
278
]
},
{
“id”: 278,
“name”: “购物”,
“level”: 1,//一级类目
“father”: 0,
“children”: [
279,
280
]
},
{
“id”: 280,
“name”: “便利店”,
“level”: 2, //二级类目
“father”: 278,
“children”: [],
“qualify”: {
“exter_list”: [
{
“inner_list”: [
{
“name”: “若涉及食品，请提供《食品经营许可证》或《卫生许可证》” //需要提交的证件名字
}
]
}
]
},
“scene”: 3,
“sensitive_type”: 1 //如果sensitive_type=1，在创建门店小程序时，需要添加相关证件
},
…
]
}
}
}
返回参数说明：
参数
说明
备注
id
类目id
必填
level
类目的级别，一级或者二级类目
必填
sensitive_type
0或者1，
0表示不用特殊处理
1表示创建该类目的门店小程序时，需要添加相关证件
必填
qualify.exter_list.inner_list.name
相关证件的名字
必填

可参考：门店小程序类目对应表

2.创建门店小程序
说明：创建门店小程序提交后需要公众号管理员确认通过后才可进行审核。如果主管理员24小时超时未确认，才能再次提交。
请求方式: POST（请使用https协议）
https://api.weixin.qq.com/wxa/apply_merchant?access_token=TOKEN
POST数据示例：
{
“first_catid”: 476, //get_store_category接口获取的一级类目id
　　　“second_catid”: 477, //get_store_category接口获取的二级类目id
　　　“qualification_list”: “RTZgKZ386yFn5kQSWLTxe4bqxwgzGBjs3OE02cg9CVQk1wRVE3c8fjUFX7jvpi-P”,
“headimg_mediaid”: “RTZgKZ386yFn5kQSWLTxe4bqxwgzGBjs3OE02cg9CVQk1wRVE3c8fjUFX7jvpi-P”,
“nickname”: “hardenzhang308”,
“intro”: “hardenzhangtest”,
“org_code”: “”,
“other_files”: “”
}
请求参数说明：
参数
说明
备注
first_catid
一级类目id
必填
second_catid
二级类目id
必填
qualification_list
类目相关证件的临时素材mediaid
如果second_catid对应的sensitive_type为1，则qualification_list字段需要填
支持0~5个mediaid，例如mediaid1|mediaid2
选填
headimg_mediaid
头像 — 临时素材mediaid
mediaid用现有的media/upload接口得到的,获取链接：
https://mp.weixin.qq.com/wiki?t=t=resource/res_main&id=mp1444738726
(支持jpg和png格式的图片，后续加上其他格式)
必填
nickname
门店小程序的昵称
名称长度为4-30个字符（中文算两个字符）
必填
intro
门店小程序的介绍
必填
org_code
营业执照或组织代码证 — 临时素材mediaid
如果返回错误码85024，则该字段必填，否则不用填
选填
other_files
补充材料 — 临时素材mediaid
如果返回错误码85024，则可以选填
支持0~5个mediaid，例如mediaid1|mediaid2
选填
access_token
调用接口凭证
必填
返回json示例：
{
“errcode” : 0,
“errmsg” : “ok”
}
错误码说明：
返回码
说明
85024
你申请的名称需要补充相应资料进行审核，此时请求参数org_code和other_files需要填写
85025
管理员手机登记数量已超过上限，不能使用该主体开通门店
85026
该微信号已绑定5个管理员，请使用另一个微信号完成信息登记
85027
管理员身份证已登记过5次，请使用另一个身份证完成用户信息登记
85028
该主体登记数量已超过上限，不能使用该主体开通门店
85029
商家名称已被占用，请换一个重试
85030
名称长度为4-30个字符（一个中文占两个字符），不能含有特殊字符及“微信”等保留字”
85031
不能使用该名称
85032
该名称在侵权投诉保护期，暂不支持申请，请重新提交一个新的名称
85033
名称不能包含违反公众平台协议、相关法律法规和政策的内容，不得使用“微信”等保留字
85034
商家名称在改名15天保护期内，请换一个重试。
85035
需与该帐号相同主体才可申请
85036
介绍中不得含有虚假的、冒充、利用他人名义的、容易构成混淆、误认的、法律、法规和政策禁止的内容
85049
头像或者简介修改达到每个月上限
43104
没有权限
85050
正在审核中，请勿重复提交
85053
请先成功创建门店后再调用
85056
临时mediaid无效

事件推送 - 创建门店小程序的审核结果