第三方开发者模式

更新通知

第三方开发者模式

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

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

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

1 第三方代制模式

模式概述

为了降低商户接入卡券的难度，微信公众平台向所有已具备卡券功能的公众号开放“第三方代制”功能。申请并开通此功能后，具备开发能力的开发者，可通过API接口协助无公众号的商户快速接入并使用卡券。协助制券的开发者称为“母商户”，被协助制券的商户称为“子商户”。

母商户需将旗下子商户资料提前上传报备，通过审核方可生效。在制券过程中允许母商户从报备的子商户列表中，选择一个子商户协助制券。

开通步骤

第一步，申请路径：微信公众平台-卡券功能-右上角-商户信息-第三方代制模式。

第二步，商户通过微信公众平台或API接口，提交子商户资料、资质，审核通过后可使用该子商户信息制券。

第三步，调用API接口创建卡券时，需传入该模式的特有字段，具体字段参考创建子商户接口的返回字段说明。该模式下，仅创建卡券接口有变动，其余接口和卡券整体接口的使用保持不变。

1.1 创建子商户接口

接口说明

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

接口详情

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

参数说明

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

字段说明

备注：授权函请在《第三方代制模式指引文档》内下载，手填并加盖鲜章后，上传彩色扫描件或彩照。

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

特别注意：

若子商户资料通过微信公众平台提交，可在微信公众平台卡券功能-子商户管理-子商户详情里查看子商户ID，或通过子商户创建接口返回子商户ID，或通过子商户信息拉取接口获取子商户ID。

1.2 子商户审核事件推送

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

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName> 
<FromUserName><![CDATA[FromUser]]></FromUserName> 
<CreateTime>123456789</CreateTime> 
<MsgType><![CDATA[event]]></MsgType> 
<Event><![CDATA[card_merchant_check_result]]></Event> 
<MerchantId>0</MerchantId>
<IsPass>1</IsPass>
<Reason><![CDATA[reason]]></Reason>
</xml>

字段说明

1.3卡券开放类目查询接口

接口说明

通过调用该接口查询卡券开放的类目ID，类目会随业务发展变更，请每次用接口去查询获取实时卡券类目。

注意：

1.本接口查询的返回值还有卡券资质ID,此处的卡券资质为：已微信认证的公众号通过微信公众平台申请卡券功能时，所需的资质。

2.对于第三方开发者代制（无公众号）模式，子商户无论选择什么类目，均暂不需按照此返回提供资质，返回值仅参考类目ID 即可。

接口详情

接口调用请求说明

HTTP请求方式: GET 
URL:https://api.weixin.qq.com/card/getapplyprotocol?access_token=TOKEN

参数说明

返回数据

{
   "category": [
       {
           "primary_category_id": 1,
           "category_name": "美食",
           "secondary_category": [
               {
                   "secondary_category_id": 101,
                   "category_name": "粤菜",
                   "need_qualification_stuffs": [
                       "food_service_license_id",
                       "food_service_license_bizmedia_id"
                   ],
                   "can_choose_prepaid_card": 1,
                   "can_choose_payment_card": 1
               },                
       }
   ],
   "errcode": 0,
   "errmsg": "ok"
}

1.4 更新子商户接口

接口说明

支持调用该接口更新子商户信息。 

接口详情

接口调用请求说明

http请求方式: POST https://api.weixin.qq.com/card/submerchant/update?access_token=TOKEN

参数说明

POST数据示例

{
  "info": {
  "merchant_id": 12,
  "app_id":"xxxxxxxxxxxxx",
  "brand_name": "aaaaaa",
  "logo_url": "http://mmbiz.xxxx",
  "protocol": "media_id",
  "agreement_media_id":"xxxxxxxxxx",
  "operator_media_id":"xxxxxxxx",
  "end_time": 1438990559,
  "primary_category_id": 1,
  "secondary_category_id": 101
 }
}

返回数据

{
"info": {
 "merchant_id": 12,
 "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
 }
}

特别注意：

若子商户资料通过微信公众平台提交，可在微信公众平台卡券功能-子商户管理-子商户详情里查看子商户ID，或通过子商户创建接口返回子商户ID，或通过子商户信息拉取接口获取子商户ID。

1.5 拉取单个子商户信息接口

接口说明

通过指定的子商户appid，拉取该子商户的基础信息。 注意，用母商户去调用接口，但接口内传入的是子商户的appid。

接口详情

接口调用请求说明

HTTP请求方式: POST 
URL:https://api.weixin.qq.com/card/submerchant/get?access_token=TOKEN

参数说明

POST数据示例

{  
"merchant_id": 12
 }

返回数据

{
 "info": {
 "merchant_id": 12,
 "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
 }
}

查询失败返回示例（errcode不为0，errmsg为相应错误信息）：

{  "errcode":xxxx,  "errmsg":"xxxx" }

1.6 批量拉取子商户信息接口

接口说明

母商户可以通过该接口批量拉取子商户的相关信息，一次调用最多拉取100个子商户的信息，可以通过多次拉去满足不同的查询需求

接口详情

接口调用请求说明

HTTP请求方式: POST 
URL:https://api.weixin.qq.com/card/submerchant/batchget?access_token=TOKEN

参数说明

POST数据示例

{  "begin_id": 0,  "limit": 50,  "status": "CHECKING" }

字段说明

返回数据

{
 "info_list": [
 {
  "merchant_id": 12,
  "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": 13,
  "create_time": 1438790559,
  "update_time": 1438790559,
  "brand_name": "bbbbbb",
  "logo_url": "http://mmbiz.xxxx",
  "status": "APPROVED",
  "begin_time": 1438790559,
  "end_time": 1438990559,
  "primary_category_id": 1,
  "secondary_category_id": 101
 }
 ]
 "next_begin_id": 13
}

开发者注意：

当母商户的子商户数量超过100时，可通过填写begin_id的值，从而多次拉取列表的的方式来满足查询需求。具体的方式是，将上一次调用得到的返回中的next_begin_id的值作为下一次调用中的begin_id的值。

1.7 创建子商户卡券接口

若母商户需创建自己的卡券，参考原有卡券创建接口

接口调用请求说明

HTTP请求方式: POST 
URL:https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN

参数说明

POST数据示例

{ 
 "card": {
  "card_type": "GROUPON",
  "groupon": {
      "base_info": {
             {
       "sub_merchant_info":{
       "merchant_id":xxx
           },
          "logo_url": 
  "http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmxibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0",
          "brand_name":"海底捞",
          "code_type":"CODE_TYPE_TEXT",
          "title": "132元双人火锅套餐",
          "sub_title": "周末狂欢必备",
          "color": "Color010",
          "notice": "使用时向服务员出示此券",
          "service_phone": "020-88888888",
          "description": "不可与其他优惠同享\n如需团购券发票，请在消费时向商户提出\n店内均可使用，仅限堂食",
          "date_info": {
              "type": "DATE_TYPE_FIX_TIME_RANGE",
              "begin_timestamp": 1397577600 ,
              "end_timestamp": 1422724261
          },
          "sku": {
              "quantity": 500000
          },
          "get_limit": 3,
          "use_custom_code": false,
          "bind_openid": false,
          "can_share": true,
        "can_give_friend": true,
          "location_id_list" : [123, 12321, 345345],
          "custom_url_name": "立即使用",
          "custom_url": "http://www.qq.com",
          "custom_url_sub_title": "6个汉字tips",
          "promotion_url_name": "更多优惠",
        "promotion_url": "http://www.qq.com",
          "source": "大众点评"
   },
      "deal_detail": "以下锅底2选1（有菌王锅、麻辣锅、大骨锅、番茄锅、清补凉锅、酸菜鱼锅可选）：\n大锅1份 12元\n小锅2份 16元 "}
 }
}

1.8 错误码说明

1.9 联系我们

第三方代制模式的开发问题，可通过邮箱weixin_card@foxmail.com联系我们。

2 第三方强授权模式

模式概述

“第三方强授权模式”是腾讯为降低卡券接入门槛，商户可快速接入，由具备开发能力的开发者代商户制卡券的功能。为商户提供开发能力的开发者简称“母商户”，商户简称“子商户”。

该模式下，子商户公众号无需微信认证，子商户也不需单独申请卡券功能，只需将资料提供给母商户代为提交。 该模式下，卡券的商户名和logo均为子商户的商户名和logo，且卡券创建、投放、核销等流程均只能由母商户通过调用API接口完成，子商户本身不具备直接调用卡券接口或在卡券商户后台手工操作的能力。

“第三方强授权”功能，面向微信开放平台所有已全网发布的第三方平台开放，第三方平台需达到一定注册资本金额，提供相关资质，经审核通过后才可获得协助制券能力。 “子商户”面向未认证的微信公众号开放，可选择已开放的卡券类目接入，子商户资质需由母商户代为提交，审核通过后可由母商户协助使用卡券功能。

母商户每月可为每个子商户代制券10个cardid，且每个cardid累计sku不超过5万。具体的数量限制会随运营规则调整。

开通步骤

第一步：开发者所在企业申请第三方开发者代制能力，提交资料并审核；

第二步：母商户为子商户提交资质认证资料审核；

第三步：子商户发起授权，母商户确认授权；

第四步：母商户代子商户调用卡券接口，进行卡券制作、投放、核销等动作；

第五步：母商户可以调用数据接口代子商户获取数据；

2.1 母商户资质申请接口

接口说明

母商户资质申请接口是第三方平台用以申请第三方强授权能力，并提交自身资质资料的上传接口，只有上传相关资质，并审核通过后才可代名下子商户提交资质。

母商户提交资质包括：注册资本、营业执照（扫描件）、税务登记证（扫描件）、上季度缴税清单（扫描件）；

母商户必须先上传相应扫描件获取media_id后，传入media_id。详见上传图片media接口

同一个appid的申请，仅当驳回时可以再次提交，审核中和审核通过时不可重复提交

接口详情

接口调用请求说明

http请求方式: POST http:// api.weixin.qq.com /cgi-bin/component/upload_card_agent_qualification?access_token=TOKEN

参数说明

POST数据示例

{ 
  "register_capital": 100000,
  "business_license_media_id": "Y0vGhBIycyhEFTyq6km0pGpCPzdqoxMnr1wjs574LqeWzsPtido2VM5grKk5gzn3",
  "tax_registration_certificate_media_id": "Y0vGhBIycyhEFTyq6km0pGpCPzdqoxMnr1wjs574LqeWzsPtido2VM5grKk5gzn3",
  "last_quarter_tax_listing_media_id": "Y0vGhBIycyhEFTyq6km0pGpCPzdqoxMnr1wjs574LqeWzsPtido2VM5grKk5gzn3"
}

字段说明

返回数据

上传成功示例：

{ "errcode":0, "errmsg":"ok" }

上传失败示例（errcode不为0，errmsg为相应错误信息）：

{ "errcode":61011, "errmsg":"invalid component" }

2.2 母商户资质审核查询接口

接口说明

该接口用于查询母商户资质审核的结果，审核通过后才能用接口继续提交子商户资质。

接口详情

接口调用请求说明

http请求方式: GET http:// api.weixin.qq.com / cgi-bin/component/check_card_agent_qualification?access_token=TOKEN

参数说明

返回数据’’’

查询成功返回示例：

{
  "result":"RESULT_PASS"，
}
{
  "result":" RESULT_NOT_PASS ",   
}
{
  "result":"RESULT_CHECKING",   
}
{
"result":"RESULT_NOTHING_TO_CHECK",   
}

查询失败返回示例：（errcode不为0，errmsg为相应错误信息）：

{ "errcode":xxxx, "errmsg":"xxxx" }

2.3 子商户资质申请接口

接口说明

母商户（第三方平台）申请获得第三方强授权能力后，才可提交名下子商户的资质。

子商户资质审核通过后，才可进行后续的授权流程。

子商户的资质包括：商户名称、商户logo（图片）、卡券类目、AppID、营业执照或个体户经营执照（扫描件）、授权协议（扫描件）。

注意： 1、请用母商户（第三方平台）的账号提交子商户资料。

2、母商户必须先上传子商户的相应扫描件获取media_id后，传入media_id。

3、母商户必须先通过卡券类目查询接口获取卡券实时对外开放的一级、二级类目ID，传入类目ID。

4、商户名称在12个汉字长度内。

5、同一个appid的申请，仅当驳回时可再次提交，审核中和审核通过时不可重复提交。

接口详情

接口调用请求说明

http请求方式: POST http:// api.weixin.qq.com /cgi-bin/component/upload_card_merchant_qualification?access_token=TOKEN

参数说明

POST数据示例

{
 "appid": "wxf8b4f85e442a4e77",
 "name": "灰太狼烧烤店",
 "logo_media_id": "Y0vGhBIycyhEFTyq6km0pGpCPzdqoxMnr1wjs574LqeWzsPtido2VM5grKk5gzn3",
 "business_license_media_id": "Y0vGhBIycyhEFTyq6km0pGpCPzdqoxMnr1wjs574LqeWzsPtido2VM5grKk5gzn3",
 "operator_id_card_media_id":"xxxxxxxxx"
 "agreement_file_media_id": "Y0vGhBIycyhEFTyq6km0pGpCPzdqoxMnr1wjs574LqeWzsPtido2VM5grKk5gzn3",
 "primary_category_id": "1",
 "secondary_category_id": "101"
}

字段说明

返回数据

上传成功示例：

{  "errcode":0,  "errmsg":"ok" }

上传失败示例（errcode不为0，errmsg为相应错误信息）：

{  "errcode":40013,  "errmsg":"invalid appid" }

2.4 授权子商户审核事件推送

当子商户资质审核通过时，开发者将收到微信服务器推送的事件。

<xml>
<AppId><![CDATA[AppId]]></AppId>
<CreateTime>1449471727</CreateTime>
<InfoType><![CDATA[card_merchant_auth_check_result]]></InfoType>
<SubMerchantAppId><![CDATA[AppId]]></SubMerchantAppId>
<IsPass>0</IsPass>
<Reason><![CDATA[Reason]]></Reason>
</xml>

字段说明

2.5 子商户资质审核查询接口

接口说明

该接口用于查询子商户资质审核的结果，审核通过后才能进行后续授权流程。 注意，用母商户去调用接口，但接口内传入的是子商户的appid。

接口详情

接口调用请求说明

http请求方式: POST http:// api.weixin.qq.com / cgi-bin/component/check_card_merchant_qualification?access_token=TOKEN

参数说明

POST数据示例

{  “appid”:”wx********” }

返回数据’’’

查询成功返回示例：

{
  "result":"RESULT_PASS"，
}
{
  "result":" RESULT_NOT_PASS ",   
}
{
  "result":"RESULT_CHECKING",   
}
{
"result":"RESULT_NOTHING_TO_CHECK",   
}

查询失败返回示例：（errcode不为0，errmsg为相应错误信息）：

{ "errcode":xxxx, "errmsg":"xxxx" }

2.6 图片上传media接口

开发者经常需要用到一些临时性的多媒体素材的场景，例如在使用接口（特别是发送消息时），对多媒体文件、多媒体消息的获取和调用等操作，都需通过media_id来进行。

为了卡券第三方代理模式相关接口调用顺畅，现已为所有对外的第三方平台账号配置“图片上传media接口”的权限。

注意：

1.对于临时素材，每个素材（media_id）会在开发者上传或粉丝发送到微信服务器3天后自动删除（所以用户发送给开发者的素材，若开发者需要，应尽快下载到本地），以节省服务器资源。

2.media_id是可复用的。

3.素材的格式大小等要求与公众平台官网一致。具体是，图片大小不超过2M，支持bmp/png/jpeg/jpg/gif格式

4.需使用https调用本接口。

5.请使用第三方平台账号的ACCESS_TOKEN调用（已开权限）

接口详情

接口调用请求说明

https请求方式: POST https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE

参数说明

调用示例

curl -F  media=@test.jpg "https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE"

返回数据

上传成功示例：

{  "type":"TYPE",  "media_id":"MEDIA_ID",  "created_at":123456789 }

上传失败示例（errcode不为0，errmsg为相应错误信息）：

{  "errcode":40004,  "errmsg":"invalid media type" }

2.7 卡券开放类目查询接口

接口说明

通过调用该接口查询卡券开放的类目ID，类目会随业务发展变更，请每次用接口去查询获取实时卡券类目。

注意：

1.本接口查询的返回值还有卡券资质ID,此处的卡券资质为：已微信认证的公众号通过微信公众平台申请卡券功能时，所需的资质。

2.对于第三方强授权模式，子商户无论选择什么类目，均提交营业执照即可，所以不用考虑此处返回的资质字段，返回值仅参考类目ID即可。

接口详情

接口调用请求说明

https请求方式: GET https://api.weixin.qq.com/card/getapplyprotocol?access_token=TOKEN

参数说明

返回数据

{
   "category": [
       {
           "primary_category_id": 1,
           "category_name": "美食",
           "secondary_category": [
               {
                   "secondary_category_id": 101,
                   "category_name": "粤菜",
                   "need_qualification_stuffs": [
                       "food_service_license_id",
                       "food_service_license_bizmedia_id"
                   ],
                   "can_choose_prepaid_card": 1,
                   "can_choose_payment_card": 1
               },                
       }
   ],
   "errcode": 0,
   "errmsg": "ok"
}

2.8 拉取单个子商户信息接口

接口说明

通过指定的子商户appid，拉取该子商户的基础信息。 注意，用母商户去调用接口，但接口内传入的是子商户的appid。

接口详情

接口调用请求说明

http请求方式: POST http:// api.weixin.qq.com / cgi-bin/component/get_card_merchant?access_token=TOKEN

参数说明

POST数据示例

{  “appid”:”wx********” }

返回数据

{
 "appid":"wxd395ea50d8b6867a",
 "name":"灰太狼烧烤店",
 "primary_category_id":1,
 "secondary_category_id":101,
 "submit_time":1440580664,
 "result":"RESULT_PASS"
}

查询失败返回示例（errcode不为0，errmsg为相应错误信息）：

{  "errcode":xxxx,  "errmsg":"xxxx" }

2.9 拉取子商户列表接口

接口说明

通过指定的子商户appid，拉取该子商户的基础信息。 注意，用母商户去调用接口，但接口内传入的是子商户的appid。

接口详情

接口调用请求说明

http请求方式: POST http:// api.weixin.qq.com / cgi-bin/component/batchget_card_merchant?access_token=TOKEN

参数说明

POST数据示例

{  "next_get": ""  }

字段说明

返回数据

查询成功返回示例：

{
 "list":[
 {
 "appid":"wxd395ea50d8b6867a",
 "name":"灰太狼烧烤店",
 "primary_category_id":1,
 "secondary_category_id":101,
 "submit_time":1440580664,
 "result":"RESULT_PASS"
 },
 {"appid":"wx6384a98262a87262",
 "name":"灰太狼烧烤店",
 "primary_category_id":1,
 "secondary_category_id":101,
 "submit_time":1440580515,
 "result":"RESULT_PASS"
 },
 {"appid":"wx42cf28f28b77d653",
 "name":"灰太狼烧烤店",
 "primary_category_id":1,
 "secondary_category_id":101,
 "submit_time":1440386151,
 "result":"RESULT_CHECKING"
 },
 {"appid":"wx5aecba35a7d70c14",
 "name":"灰太狼烧烤店",
 "primary_category_id":1,
 "secondary_category_id":101,
 "submit_time":1440385851,
 "result":"RESULT_PASS"
 }
 ],
 "next_get":"13"
}

查询失败返回示例（errcode不为0，errmsg为相应错误信息）：

{  "errcode":xxxx,  "errmsg":"xxxx" }

开发者注意： 

当母商户的子商户数量超过20时，可通过填写next_get的值，从而多次拉取列表的的方式来满足查询需求。具体的方式是，将上一次调用得到的返回中的next_get的值作为下一次调用中的next_get的值。

2.10 第三方强授权相关接口

接口说明

1.普通授权，即公众号本身已有某接口或业务的权限，通过第三方授权，第三方代公众号代公众号调用该接口或实现该业务。

2.普通授权的相关接口请参考微信开放平台相关文档：https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419318587&lang=zh_CN

3.强授权，即公众号本身无某接口或业务的权限，但第三方获取了该接口或业务的权限后，通过强授权过程，公众号也额外获得该权限。

4.强授权过程变更2个API，并增加了1个第三方平台确认授权的API。api_query_auth, 增加返回字段：need_confirm, already_confirm, 分别表示是否需要确认，是否已经确认。api_getauthorizer_info，增加返回字段：need_confirm, already_confirm, 分别表示是否需要确认，是否已经确认。api_confirm_authorization, 第三方平台确认授权API。

注意： 若子商户公众号本身有卡券功能，不用调用强授权确认接口，直接可调用卡券接口。 建议在进行强授权接口确认前，通过普通授权接口内的“5、获取授权方的账户信息“接口查询该公众号是否具备“卡券功能”。

【强授权权限集，必须调接口进行授权确认，才能真正获得强授权特性】

2.10.1 使用授权码换取公众号的授权信息

接口说明

该API用于使用授权码换取授权公众号的授权信息，并换取authorizer_access_token和authorizer_refresh_token。 授权码的获取，需要在用户在第三方平台授权页中完成授权流程后，在回调URI中通过URL参数提供给第三方平台方。

接口调用请求说明

http请求方式: POST https://api.weixin.qq.com/cgi-bin/component/api_query_auth?component_access_token=TOKEN

参数说明

POST数据示例

{  "component_appid":"appid_value",  "authorization_code": "auth_code_value" }

字段说明

返回数据

返回结果示例

{
 "authorization_info": {
 "authorizer_appid": "wxf8b4f85f3a794e77", 
 "authorizer_access_token": "QXjUqNqfYVH0yBE1iI_7vuN_9gQbpjfK7hYwJ3P7xOa88a89-  Aga5x1NMYJyB8G2yKt1KCl0nPC3W9GJzw0Zzq_dBxc8pxIGUNi_bFes0qM", 
 "expires_in": 7200, 
 "authorizer_refresh_token": "dTo-YCXPL4llX-u1W1pPpnp8Hgm4wpJtlR6iV0doKdY", 
 "func_info": [
 {"funcscope_category": {"id": 1}，confirm_info”:{"need_confirm":      1,"already_confirm":0}}, 
 {"funcscope_category": {"id": 2}，confirm_info”:{"need_confirm": 1,"already_confirm":0}}, 
 {"funcscope_category": {"id": 50}，confirm_info”:{"need_confirm": 1,"already_confirm":1}}
]
}

2.10.2 确认授权

接口说明

该API用于使用授权码换取授权公众号的授权信息，并换取authorizer_access_token和authorizer_refresh_token。 授权码的获取，需要在用户在第三方平台授权页中完成授权流程后，在回调URI中通过URL参数提供给第三方平台方。

接口调用请求说明

http请求方式: POST https://api.weixin.qq.com/ cgi-bin/component/api_confirm_authorization?component_access_token =TOKEN

参数说明

POST数据示例

{  "component_appid":"appid_value",  "authorizer_appid": "authorizer_appid_value",  "funcscope_category_id":8，  "confirm_value": 1 }

字段说明

返回数据

{  "errcode":xxxx,  "errmsg":"xxxx" }

2.10.3 获取授权方的账户信息

接口说明

该API用于获取授权方的公众号基本信息，包括头像、昵称、帐号类型、认证类型、微信号、原始ID和二维码图片URL。 需要特别记录授权方的帐号类型，在消息及事件推送时，对于不具备客服接口的公众号，需要在5秒内立即响应；而若有客服接口，则可以选择暂时不响应，而选择后续通过客服接口来发送消息触达粉丝。

接口调用请求说明

http请求方式: POST https://api.weixin.qq.com/ cgi-bin/component/api_get_authorizer_info?component_access_token=TOKEN

参数说明

POST数据示例

{  ”component_appid":"appid_value" ,  "authorizer_appid": "auth_appid_value"  }

字段说明

返回数据

返回结果示例

{
  "authorizer_info": {
  "nick_name": "微信SDK Demo Special", 
  "head_img": "http://wx.qlogo.cn/mmopen/GPyw0pGicibl5Eda4GmSSbTguhjg9LZjumHmVjybjiaQXnE9XrXEts6ny9Uv4Fk6hOScWRDibq1fI0WOkSaAjaecNTict3n6EjJaC/0", 
  "service_type_info": { "id": 2 }, 
  "verify_type_info": { "id": 0 },
  "user_name":"gh_eb5e3a772040",
  "alias":"paytest01"
}, 
  "qrcode_url":"URL",    
  "authorization_info": {
  "appid": "wxf8b4f85f3a794e77", 
  "func_info": [
  {"funcscope_category": {"id": 1}，confirm_info”:{"need_confirm": 1,"already_confirm":0}}, 
  {"funcscope_category": {"id": 2}，confirm_info”:{"need_confirm": 1,"already_confirm":0}}, 
  {"funcscope_category": {"id":,8}，confirm_info”:{"need_confirm": 1,"already_confirm":1}}
]
}
}

2.11 错误码说明