第三方开发者模式

第三方开发者模式

1、具备认证公众号的商家，可用商家自己公众号申请卡券功能后，通过微信开放平台“公众号登陆授权”授权给开发者，代为开发和应用卡券功能，卡券数据及会员归属在商家自己公众号下。该模式简称为“普通授权”，无额外开发接口，参考卡券整套基础接口即可。
2、针对没有公众号或未认证的公众号，或者有认证公众号但不想自己运营公众号的商家，为了降低商户接入成本，可由第三方背书接入。子商户将卡券制作权限授权给开发者所在企业，由开发者所在企业为子商户作为信用背书，并可以帮助 没有能力制作卡券的商户制作卡券。
目前，这种降低商户门槛，由第三方背书接入的开发者模式分为：第三方代制模式（查看介绍及指引文档）和第三方强授权模式（查看介绍及指引文档）。这两种模式需额外接口。参考如下接口文档。
备注：由于第三方强授权模式平台化暂缓，仅支持卡券业务，而未认证公众号有相关权限都无法获取，无法开发会员卡、朋友券等功能，影响整体微信营销解决方案开发。因此，建议开发者接入普通授权模式，或者第三方代制模式。

目录

1 第三方代制模式
1.1 创建子商户接口
1.2 子商户审核事件推送
1.3 卡券开放类目查询接口
1.4 更新子商户接口
1.5 拉取单个子商户信息接口
1.6 批量拉取子商户信息接口
1.7 创建子商户卡券接口
1.8 错误码说明
1.9 联系我们
2 第三方强授权模式
2.1 母商户资质申请接口
2.2 母商户资质审核查询接口
2.3 子商户资质申请接口
2.4 授权子商户审核事件推送
2.5 子商户资质审核查询接口
2.6 图片上传media接口
2.7 卡券开放类目查询接口
2.8 拉取单个子商户信息接口
2.9 拉取子商户列表接口
2.10 新增第三方强授权相关接口
2.11 错误码说明
1 第三方代制模式
模式概述
为了降低商户接入卡券的难度，微信公众平台向所有已具备卡券功能的公众号开放“第三方代制”功能。申请并开通此功能后，具备开发能力的开发者，可通过API接口协助无公众号的商户快速接入并使用卡券。协助制券的开发者称为“母商户”，被协助制券的商户称为“子商户”。
母商户需将旗下子商户资料提前上传报备，通过审核方可生效。在制券过程中允许母商户从报备的子商户列表中，选择一个子商户协助制券。

开通步骤
第一步，申请路径：微信公众平台-卡券功能-右上角-商户信息-第三方代制模式。
第二步，商户通过微信公众平台或API接口，提交子商户资料、资质，审核通过后可使用该子商户信息制券。
第三步，调用API接口创建卡券时，需传入该模式的特有字段，具体字段参考创建子商户接口的返回字段说明。该模式下，仅创建卡券接口有变动，其余接口和卡券整体接口的使用保持不变。详情参考微信卡券接口文档

1.1 创建子商户接口
接口说明
支持母商户调用该接口传入子商户的相关资料，并获取子商户ID，用于子商户的卡券功能管理。 子商户的资质包括：商户名称、商户logo（图片）、卡券类目、授权函（扫描件或彩照）、授权函有效期截止时间。

接口详情
HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/submerchant/submit?access_token=TOKEN

参数说明
参数 是否必须 说明
access_token 是 调用接口凭证
POST数据 是 Json数据

POST数据示例
{
“info”: {
“brand_name”: “aaaaaa”,
“app_id”：”xxxxxxxxxxx”,
“logo_url”: “http://mmbiz.xxxx“,
“protocol”: “xxxxxxxxxx”,
“agreement_media_id”:”xxxxxxxxxx”,
“operator_media_id”:”xxxxxxxx”,
“end_time”: 1438990559,
“primary_category_id”: 1,
“secondary_category_id”: 101
}
}

字段说明
参数名 必填 类型 示例 说明
info 是 json结构

app_id 否 String(36) wxxxxxxxxxxx 子商户的公众号app_id，配置后子商户卡券券面上的app_id为该app_id。注意：该app_id须经过认证
brand_name 是 String(36) 兰州拉面 子商户名称（12个汉字内），该名称将在制券时填入并显示在卡券页面上
logo_url 是 string(128) http://mmbiz.xxxx 子商户logo，可通过上传图片接口获取。该logo将在制券时填入并显示在卡券页面上
protocol 是 String(36) mdasdfkl ： 授权函ID，即通过上传临时素材接口上传授权函后获得的meida_id
end_time 是 unsigned int 15300000 授权函有效期截止时间（东八区时间，单位为秒），需要与提交的扫描件一致
primary_category_id 是 int 2 一级类目id,可以通过本文档中接口查询
secondary_category_id 是 int 2 二级类目id，可以通过本文档中接口查询
agreement_media_id 否 string(36) 2343343424 营业执照或个体工商户营业执照彩照或扫描件
operator_media_id 否 string(36) 2343343424 营业执照内登记的经营者身份证彩照或扫描件

备注：授权函请在《第三方代制模式指引文档》内下载，手填并加盖鲜章后，上传彩色扫描件或彩照。
1、授权函必须加盖企业公章，或个体户店铺章、发票专用章、财务章、合同章等具备法律效力的盖章，不可使用个人私章；
2、若子商户是个体工商户，且无上述公章，授权函可用个体工商户经营者签字代替公章，且须同时额外上传《个体工商户营业执照》及该执照内登记的经营者的身份证彩照。（本方案仅适用于子商户是个体工商户，且无公章的场景。其他场景必须在授权函加盖公章）
3、子商户若有公众号，且不愿意自己运营，通过授权方式让第三方代制，支持配置子商户公众号。配置后，1）该子商户的制券配额不再限制，2）该卡券详情页关联的公众号为子商户配置这个公众号。
返回数据
{
“info”: {
“merchant_id”: 12,
“app_id”:”xxxxxxxxxxxxx”,
“create_time”: 1438790559,
“update_time”: 1438790559,
“brand_name”: “aaaaaa”,
“logo_url”: “http://mmbiz.xxxx“,
“status”: “CHECKING”,
“begin_time”: 1438790559,
“end_time”: 1438990559,
“primary_category_id”: 1,
“secondary_category_id”: 101
}
}
特别注意：
参数名 描述
merchant_id 子商户id，对于一个母商户公众号下唯一
app_id 子商户若有公众号，且不愿意自己运营，通过授权方式让第三方代制，支持配置子商户公众号。配置后，1）该子商户的制券配额不再限制，2）该卡券详情页关联的公众号为子商户配置这个公众号。
create_time 子商户信息创建时间
update_time 子商户信息更新时间
brand_name 子商户名称（12个汉字内），该名称将在制券时填入并显示在卡券页面上。
logo_url 子商户logo，可通过上传logo接口获取。该logo将在制券时填入并显示在卡券页面上
status 子商户状态，”CHECKING” 审核中, “APPROVED” , 已通过；”REJECTED”被驳回, “EXPIRED”协议已过期
bengin_time 创建时间（非协议开始时间）
end_time 授权函有效期截止时间（东八区时间，单位为秒）
primary_category_id 子商户一级类目
secondary_category_id 子商户二级类目
若子商户资料通过微信公众平台提交，可在微信公众平台卡券功能-子商户管理-子商户详情里查看子商户ID，或通过子商户创建接口返回子商户ID，或通过子商户信息拉取接口获取子商户ID。

1.2 子商户审核事件推送
开发者所代理的子商户审核通过后，会收到微信服务器发送的事件推送。