第三方开发者模式

一时失言乱红尘 2022-06-08 10:59 262阅读 0赞

第三方开发者模式

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][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][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][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][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 子商户审核事件推送  
开发者所代理的子商户审核通过后，会收到微信服务器发送的事件推送。

[https_api.weixin.qq.com_card_submerchant_submit_access_token_TOKEN]: https://api.weixin.qq.com/card/submerchant/submit?access_token=TOKEN
[http_mmbiz.xxxx]: http://mmbiz.xxxx