微信公众平台开发者文档

更新时间2022-04-11

特殊票券卡券错误码

第三方开发者模式

更新通知

版本号	更新内容	更新时间
V1.0	第三方代制模式，支持第三方为子商户代创建会员卡	2016-3-20
V1.1	第三方代制模式，支持开发者创建有app_id的子商户，创建有app_id的子商户卡券时，领卡页面及卡券详情页支持关联配置子商户公众号，但卡券数据仍归属第三方账号	2016-4-28
V1.2	第三方开发者代制（有公众号模式）名称逐步规范为“第三方强授权模式”；第三方开发者代制（无公众号模式）名称逐步规范为“第三方代制模式”；第三方普通授权模式、强授权模式、代制模式，统称第三方开发者模式。	2016-5-17

版本号

更新内容

更新时间

V1.0

第三方代制模式，支持第三方为子商户代创建会员卡

2016-3-20

V1.1

第三方代制模式，支持开发者创建有app_id的子商户，创建有app_id的子商户卡券时，领卡页面及卡券详情页支持关联配置子商户公众号，但卡券数据仍归属第三方账号

2016-4-28

V1.2

第三方开发者代制（有公众号模式）名称逐步规范为“第三方强授权模式”；

第三方开发者代制（无公众号模式）名称逐步规范为“第三方代制模式”；

第三方普通授权模式、强授权模式、代制模式，统称第三方开发者模式。

2016-5-17

第三方开发者模式

1、具备认证公众号的商家，可用商家自己公众号申请卡券功能后，通过微信开放平台“公众号登陆授权”授权给开发者，代为开发和应用卡券功能，卡券数据及会员归属在商家自己公众号下。该模式简称为“普通授权”，无额外开发接口，参考卡券整套基础接口即可。

2、针对没有公众号或未认证的公众号，或者有认证公众号但不想自己运营公众号的商家，为了降低商户接入成本，可由第三方背书接入。子商户将卡券制作权限授权给开发者所在企业，由开发者所在企业为子商户作为信用背书，并可以帮助没有能力制作卡券的商户制作卡券。

目前，这种降低商户门槛，由第三方背书接入的开发者模式分为：第三方代制模式（查看介绍及指引文档）和第三方强授权模式（查看介绍及指引文档）。这两种模式需额外接口。参考如下接口文档。

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接口获取。该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	营业执照内登记的经营者身份证彩照或扫描件