第三方微信開發(fā)者模式

更新通知

第三方開發(fā)者模式

1、具備認證公眾號的商家，可用商家自己公眾號申請卡券功能后，通過微信開放平臺“公眾號登陸授權”授權給開發(fā)者，代為開發(fā)和應用卡券功能，卡券數(shù)據(jù)及會員歸屬在商家自己公眾號下。該模式簡稱為“普通授權”，無額外開發(fā)接口，參考卡券整套基礎接口即可。

2、針對沒有公眾號或未認證的公眾號，或者有認證公眾號但不想自己運營公眾號的商家，為了降低商戶接入成本，可由第三方背書接入。子商戶將卡券制作權限授權給開發(fā)者所在企業(yè)，由開發(fā)者所在企業(yè)為子商戶作為信用背書，并可以幫助 沒有能力制作卡券的商戶制作卡券。

目前，這種降低商戶門檻，由第三方背書接入的開發(fā)者模式分為：第三方代制模式（查看介紹及指引文檔）和第三方強授權模式（查看介紹及指引文檔）。這兩種模式需額外接口。參考如下接口文檔。

1 第三方代制模式

模式概述

為了降低商戶接入卡券的難度，微信公眾平臺向所有已具備卡券功能的公眾號開放“第三方代制”功能。申請并開通此功能后，具備開發(fā)能力的開發(fā)者，可通過API接口協(xié)助無公眾號的商戶快速接入并使用卡券。協(xié)助制券的開發(fā)者稱為“母商戶”，被協(xié)助制券的商戶稱為“子商戶”。

母商戶需將旗下子商戶資料提前上傳報備，通過審核方可生效。在制券過程中允許母商戶從報備的子商戶列表中，選擇一個子商戶協(xié)助制券。

開通步驟

第一步，申請路徑：微信公眾平臺-卡券功能-右上角-商戶信息-第三方代制模式。

第二步，商戶通過微信公眾平臺或API接口，提交子商戶資料、資質(zhì)，審核通過后可使用該子商戶信息制券。

第三步，調(diào)用API接口創(chuàng)建卡券時，需傳入該模式的特有字段，具體字段參考創(chuàng)建子商戶接口的返回字段說明。該模式下，僅創(chuàng)建卡券接口有變動，其余接口和卡券整體接口的使用保持不變。

1.1 創(chuàng)建子商戶接口

接口說明

支持母商戶調(diào)用該接口傳入子商戶的相關資料，并獲取子商戶ID，用于子商戶的卡券功能管理。 子商戶的資質(zhì)包括：商戶名稱、商戶logo（圖片）、卡券類目、授權函（掃描件或彩照）、授權函有效期截止時間。

接口詳情

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

參數(shù)說明

POST數(shù)據(jù)示例

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

字段說明

備注：授權函請在《第三方代制模式指引文檔》內(nèi)下載，手填并加蓋鮮章后，上傳彩色掃描件或彩照。

1、授權函必須加蓋企業(yè)公章，或個體戶店鋪章、發(fā)票專用章、財務章、合同章等具備法律效力的蓋章，不可使用個人私章；

2、若子商戶是個體工商戶，且無上述公章，授權函可用個體工商戶經(jīng)營者手印代替公章，且須同時額外上傳《個體工商戶營業(yè)執(zhí)照》及該執(zhí)照內(nèi)登記的經(jīng)營者的身份證彩照。（本方案僅適用于子商戶是個體工商戶，且無公章的場景。其他場景必須在授權函加蓋公章）

返回數(shù)據(jù)

{
"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，或通過子商戶創(chuàng)建接口返回子商戶ID，或通過子商戶信息拉取接口獲取子商戶ID。

1.2 子商戶審核事件推送

開發(fā)者所代理的子商戶審核通過后，會收到微信服務器發(fā)送的事件推送。

<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卡券開放類目查詢接口

接口說明

通過調(diào)用該接口查詢卡券開放的類目ID，類目會隨業(yè)務發(fā)展變更，請每次用接口去查詢獲取實時卡券類目。

注意：

1.本接口查詢的返回值還有卡券資質(zhì)ID,此處的卡券資質(zhì)為：已微信認證的公眾號通過微信公眾平臺申請卡券功能時，所需的資質(zhì)。

2.對于第三方開發(fā)者代制（無公眾號）模式，子商戶無論選擇什么類目，均暫不需按照此返回提供資質(zhì)，返回值僅參考類目ID 即可。

接口詳情

接口調(diào)用請求說明

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

參數(shù)說明

返回數(shù)據(jù)

{
   "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 更新子商戶接口

接口說明

支持調(diào)用該接口更新子商戶信息。 

接口詳情

接口調(diào)用請求說明

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

參數(shù)說明

POST數(shù)據(jù)示例

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

返回數(shù)據(jù)

{
"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，或通過子商戶創(chuàng)建接口返回子商戶ID，或通過子商戶信息拉取接口獲取子商戶ID。

1.5 拉取單個子商戶信息接口

接口說明

通過指定的子商戶appid，拉取該子商戶的基礎信息。 注意，用母商戶去調(diào)用接口，但接口內(nèi)傳入的是子商戶的appid。

接口詳情

接口調(diào)用請求說明

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

參數(shù)說明

POST數(shù)據(jù)示例

{  
"merchant_id": 12
 }

返回數(shù)據(jù)

{
 "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 批量拉取子商戶信息接口

接口說明

母商戶可以通過該接口批量拉取子商戶的相關信息，一次調(diào)用最多拉取100個子商戶的信息，可以通過多次拉去滿足不同的查詢需求

接口詳情

接口調(diào)用請求說明

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

參數(shù)說明

POST數(shù)據(jù)示例

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

字段說明

返回數(shù)據(jù)

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

開發(fā)者注意：

當母商戶的子商戶數(shù)量超過100時，可通過填寫begin_id的值，從而多次拉取列表的的方式來滿足查詢需求。具體的方式是，將上一次調(diào)用得到的返回中的next_begin_id的值作為下一次調(diào)用中的begin_id的值。

1.7 創(chuàng)建子商戶卡券接口

若母商戶需創(chuàng)建自己的卡券，參考原有卡券創(chuàng)建接口

接口調(diào)用請求說明

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

參數(shù)說明

POST數(shù)據(jù)示例

{ 
 "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": "不可與其他優(yōu)惠同享\n如需團購券發(fā)票，請在消費時向商戶提出\n店內(nèi)均可使用，僅限堂食",
          "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": "更多優(yōu)惠",
        "promotion_url": "http://www.qq.com",
          "source": "大眾點評"
   },
      "deal_detail": "以下鍋底2選1（有菌王鍋、麻辣鍋、大骨鍋、番茄鍋、清補涼鍋、酸菜魚鍋可選）：\n大鍋1份 12元\n小鍋2份 16元 "}
 }
}

1.8 錯誤碼說明

1.9 聯(lián)系我們

第三方代制模式的開發(fā)問題，可通過郵箱weixin_card@foxmail.com聯(lián)系我們。

2 第三方強授權模式

模式概述

“第三方強授權模式”是騰訊為降低卡券接入門檻，商戶可快速接入，由具備開發(fā)能力的開發(fā)者代商戶制卡券的功能。為商戶提供開發(fā)能力的開發(fā)者簡稱“母商戶”，商戶簡稱“子商戶”。

該模式下，子商戶公眾號無需微信認證，子商戶也不需單獨申請卡券功能，只需將資料提供給母商戶代為提交。 該模式下，卡券的商戶名和logo均為子商戶的商戶名和logo，且卡券創(chuàng)建、投放、核銷等流程均只能由母商戶通過調(diào)用API接口完成，子商戶本身不具備直接調(diào)用卡券接口或在卡券商戶后臺手工操作的能力。

“第三方強授權”功能，面向微信開放平臺所有已全網(wǎng)發(fā)布的第三方平臺開放，第三方平臺需達到一定注冊資本金額，提供相關資質(zhì)，經(jīng)審核通過后才可獲得協(xié)助制券能力。 “子商戶”面向未認證的微信公眾號開放，可選擇已開放的卡券類目接入，子商戶資質(zhì)需由母商戶代為提交，審核通過后可由母商戶協(xié)助使用卡券功能。

母商戶每月可為每個子商戶代制券10個cardid，且每個cardid累計sku不超過5萬。具體的數(shù)量限制會隨運營規(guī)則調(diào)整。

開通步驟

第一步：開發(fā)者所在企業(yè)申請第三方開發(fā)者代制能力，提交資料并審核；

第二步：母商戶為子商戶提交資質(zhì)認證資料審核；

第三步：子商戶發(fā)起授權，母商戶確認授權；

第四步：母商戶代子商戶調(diào)用卡券接口，進行卡券制作、投放、核銷等動作；

第五步：母商戶可以調(diào)用數(shù)據(jù)接口代子商戶獲取數(shù)據(jù)；

2.1 母商戶資質(zhì)申請接口

接口說明

母商戶資質(zhì)申請接口是第三方平臺用以申請第三方強授權能力，并提交自身資質(zhì)資料的上傳接口，只有上傳相關資質(zhì)，并審核通過后才可代名下子商戶提交資質(zhì)。

母商戶提交資質(zhì)包括：注冊資本、營業(yè)執(zhí)照（掃描件）、稅務登記證（掃描件）、上季度繳稅清單（掃描件）；

母商戶必須先上傳相應掃描件獲取media_id后，傳入media_id。詳見上傳圖片media接口

同一個appid的申請，僅當駁回時可以再次提交，審核中和審核通過時不可重復提交

接口詳情

接口調(diào)用請求說明

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

參數(shù)說明

POST數(shù)據(jù)示例

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

字段說明

返回數(shù)據(jù)

上傳成功示例：

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

上傳失敗示例（errcode不為0，errmsg為相應錯誤信息）：

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

2.2 母商戶資質(zhì)審核查詢接口

接口說明

該接口用于查詢母商戶資質(zhì)審核的結(jié)果，審核通過后才能用接口繼續(xù)提交子商戶資質(zhì)。

接口詳情

接口調(diào)用請求說明

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

參數(shù)說明

返回數(shù)據(jù)’’’

查詢成功返回示例：

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

查詢失敗返回示例：（errcode不為0，errmsg為相應錯誤信息）：

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

2.3 子商戶資質(zhì)申請接口

接口說明

母商戶（第三方平臺）申請獲得第三方強授權能力后，才可提交名下子商戶的資質(zhì)。

子商戶資質(zhì)審核通過后，才可進行后續(xù)的授權流程。

子商戶的資質(zhì)包括：商戶名稱、商戶logo（圖片）、卡券類目、AppID、營業(yè)執(zhí)照或個體戶經(jīng)營執(zhí)照（掃描件）、授權協(xié)議（掃描件）。

注意： 1、請用母商戶（第三方平臺）的賬號提交子商戶資料。

2、母商戶必須先上傳子商戶的相應掃描件獲取media_id后，傳入media_id。

3、母商戶必須先通過卡券類目查詢接口獲取卡券實時對外開放的一級、二級類目ID，傳入類目ID。

4、商戶名稱在12個漢字長度內(nèi)。

5、同一個appid的申請，僅當駁回時可再次提交，審核中和審核通過時不可重復提交。

接口詳情

接口調(diào)用請求說明

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

參數(shù)說明

POST數(shù)據(jù)示例

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

字段說明

返回數(shù)據(jù)

上傳成功示例：

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

上傳失敗示例（errcode不為0，errmsg為相應錯誤信息）：

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

2.4 授權子商戶審核事件推送

當子商戶資質(zhì)審核通過時，開發(fā)者將收到微信服務器推送的事件。

<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 子商戶資質(zhì)審核查詢接口

接口說明

該接口用于查詢子商戶資質(zhì)審核的結(jié)果，審核通過后才能進行后續(xù)授權流程。 注意，用母商戶去調(diào)用接口，但接口內(nèi)傳入的是子商戶的appid。

接口詳情

接口調(diào)用請求說明

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

參數(shù)說明

POST數(shù)據(jù)示例

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

返回數(shù)據(jù)’’’

查詢成功返回示例：

{
  "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接口

開發(fā)者經(jīng)常需要用到一些臨時性的多媒體素材的場景，例如在使用接口（特別是發(fā)送消息時），對多媒體文件、多媒體消息的獲取和調(diào)用等操作，都需通過media_id來進行。

為了卡券第三方代理模式相關接口調(diào)用順暢，現(xiàn)已為所有對外的第三方平臺賬號配置“圖片上傳media接口”的權限。

注意：

1.對于臨時素材，每個素材（media_id）會在開發(fā)者上傳或粉絲發(fā)送到微信服務器3天后自動刪除（所以用戶發(fā)送給開發(fā)者的素材，若開發(fā)者需要，應盡快下載到本地），以節(jié)省服務器資源。

2.media_id是可復用的。

3.素材的格式大小等要求與公眾平臺官網(wǎng)一致。具體是，圖片大小不超過2M，支持bmp/png/jpeg/jpg/gif格式

4.需使用https調(diào)用本接口。

5.請使用第三方平臺賬號的ACCESS_TOKEN調(diào)用（已開權限）

接口詳情

接口調(diào)用請求說明

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

參數(shù)說明

調(diào)用示例

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

返回數(shù)據(jù)

上傳成功示例：

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

上傳失敗示例（errcode不為0，errmsg為相應錯誤信息）：

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

2.7 卡券開放類目查詢接口

接口說明

通過調(diào)用該接口查詢卡券開放的類目ID，類目會隨業(yè)務發(fā)展變更，請每次用接口去查詢獲取實時卡券類目。

注意：

1.本接口查詢的返回值還有卡券資質(zhì)ID,此處的卡券資質(zhì)為：已微信認證的公眾號通過微信公眾平臺申請卡券功能時，所需的資質(zhì)。

2.對于第三方強授權模式，子商戶無論選擇什么類目，均提交營業(yè)執(zhí)照即可，所以不用考慮此處返回的資質(zhì)字段，返回值僅參考類目ID即可。

接口詳情

接口調(diào)用請求說明

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

參數(shù)說明

返回數(shù)據(jù)

{
   "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，拉取該子商戶的基礎信息。 注意，用母商戶去調(diào)用接口，但接口內(nèi)傳入的是子商戶的appid。

接口詳情

接口調(diào)用請求說明

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

參數(shù)說明

POST數(shù)據(jù)示例

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

返回數(shù)據(jù)

{
 "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，拉取該子商戶的基礎信息。 注意，用母商戶去調(diào)用接口，但接口內(nèi)傳入的是子商戶的appid。

接口詳情

接口調(diào)用請求說明

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

參數(shù)說明

POST數(shù)據(jù)示例

{  "next_get": ""  }

字段說明

返回數(shù)據(jù)

查詢成功返回示例：

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

開發(fā)者注意： 

當母商戶的子商戶數(shù)量超過20時，可通過填寫next_get的值，從而多次拉取列表的的方式來滿足查詢需求。具體的方式是，將上一次調(diào)用得到的返回中的next_get的值作為下一次調(diào)用中的next_get的值。

2.10 第三方強授權相關接口

接口說明

1.普通授權，即公眾號本身已有某接口或業(yè)務的權限，通過第三方授權，第三方代公眾號代公眾號調(diào)用該接口或?qū)崿F(xiàn)該業(yè)務。

2.普通授權的相關接口請參考微信開放平臺相關文檔：https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419318587&lang=zh_CN

3.強授權，即公眾號本身無某接口或業(yè)務的權限，但第三方獲取了該接口或業(yè)務的權限后，通過強授權過程，公眾號也額外獲得該權限。

4.強授權過程變更2個API，并增加了1個第三方平臺確認授權的API。api_query_auth, 增加返回字段：need_confirm, already_confirm, 分別表示是否需要確認，是否已經(jīng)確認。api_getauthorizer_info，增加返回字段：need_confirm, already_confirm, 分別表示是否需要確認，是否已經(jīng)確認。api_confirm_authorization, 第三方平臺確認授權API。

注意： 若子商戶公眾號本身有卡券功能，不用調(diào)用強授權確認接口，直接可調(diào)用卡券接口。 建議在進行強授權接口確認前，通過普通授權接口內(nèi)的“5、獲取授權方的賬戶信息“接口查詢該公眾號是否具備“卡券功能”。

【強授權權限集，必須調(diào)接口進行授權確認，才能真正獲得強授權特性】

2.10.1 使用授權碼換取公眾號的授權信息

接口說明

該API用于使用授權碼換取授權公眾號的授權信息，并換取authorizer_access_token和authorizer_refresh_token。 授權碼的獲取，需要在用戶在第三方平臺授權頁中完成授權流程后，在回調(diào)URI中通過URL參數(shù)提供給第三方平臺方。

接口調(diào)用請求說明

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

參數(shù)說明

POST數(shù)據(jù)示例

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

字段說明

返回數(shù)據(jù)

返回結(jié)果示例

{
 "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。 授權碼的獲取，需要在用戶在第三方平臺授權頁中完成授權流程后，在回調(diào)URI中通過URL參數(shù)提供給第三方平臺方。

接口調(diào)用請求說明

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

參數(shù)說明

POST數(shù)據(jù)示例

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

字段說明

返回數(shù)據(jù)

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

2.10.3 獲取授權方的賬戶信息

接口說明

該API用于獲取授權方的公眾號基本信息，包括頭像、昵稱、帳號類型、認證類型、微信號、原始ID和二維碼圖片URL。 需要特別記錄授權方的帳號類型，在消息及事件推送時，對于不具備客服接口的公眾號，需要在5秒內(nèi)立即響應；而若有客服接口，則可以選擇暫時不響應，而選擇后續(xù)通過客服接口來發(fā)送消息觸達粉絲。

接口調(diào)用請求說明

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

參數(shù)說明

POST數(shù)據(jù)示例

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

字段說明

返回數(shù)據(jù)

返回結(jié)果示例

{
  "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 錯誤碼說明