第三方开发者模式

《第三方开发者模式》由会员分享，可在线阅读，更多相关《第三方开发者模式（51页珍藏版）》请在金锄头文库上搜索。

1、版本号更新内容V1.0第三方代制模式，支持第三方为子商户代创建会员卡V1.1第三方代制模式，支持开发者创建有app_id的子商户，创建有app_id时，领卡页面及卡券详情页支持关联配置子商户公众号，但卡券数据仍归属第三方账号第三方开发者代制（有公众号模式）名称逐步规范为“第三方强授权模式”；第三开发者模式第三开发者模式更新通知V1.2第三方开发者代制（无公众号模式）名称逐步规范为“第三方代制模式”；第三方普通授权模式、强授权模式、代制模式，统称第三方开发者模式。第三方开发者模式1、具备认证公众号的商家，可用商家自己公众号申请卡券功能后，通过微信开放平台“公众号登陆授权”授权给开发者，代为开发和

2、应用卡券功能，卡券数据及会员归属在商家自己公众号下。该模式简称为“普通授权”，无额外开发接口，参考卡券整套基础接口即可。2、针对没有公众号或未认证的公众号，或者有认证公众号但不想 自己运营公众号的商家，为了降低商户接入成本，可由第三方背书接入。子商户将卡券制作权限授权给开发者所在企业，由开发 者所在企业为子商户作为信用背书，并可以帮助 没有能力制作卡 券的商户制作卡券。目前，这种降低商户门槛，由第三方背书接入的开发者模式分 为：第三方代制模式（查看介绍及指引文档）和第三方强授权模 式（查看介绍及指引文档）。这两种模式需额外接口。参考如下 接口文档。1 第三方代制模式模式概述为了降低商户接入卡券

3、的难度，微信公众平台向所有已具备卡券 功能的公众号开放“第三方代制”功能。申请并开通此功能后， 具备开发能力的开发者，可通过API接口协助无公众号的商户快速 接入并使用卡券。协助制券的开发者称为“母商户”，被协助制 券的商户称为“子商户”。母商户需将旗下子商户资料提前上传报备，通过审核方可生效。 在制券过程中允许母商户从报备的子商户列表中，选择一个子商 户协助制券。开通步骤第一步，申请路径：微信公众平台-卡券功能-右上角-商户信息-第 三方代制模式。第二步，商户通过微信公众平台或API接口，提交子商户资料、资 质，审核通过后可使用该子商户信息制券。第三步，调用API接口创建卡券时，需传入该模式

4、的特有字段，具 体字段参考创建子商户接口的返回字段说明。该模式下，仅创建 卡券接口有变动，其余接口和卡券整体接口的使用保持不变。1.1 创建子商户接口接口说明支持母商户调用该接口传入子商户的相关资料，并获取子商户 ID，用于子商户的卡券功能管理。 子商户的资质包括：商户名 称、商户logo（图片）、卡券类目、授权函（扫描件或彩照）、 授权函有效期截止时间。接口详情HTTP请求方式: POST URL:https:/ “brand_name“: “aaaaaa“,“app_id“：“xxxxxxxxxxx“,“logo_url“: “http:/mmbiz.xxxx“,“protocol“: “

5、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)brand_name是String(36)logo_url是string(128)protocol是String(36)end_time是unsignedintprimary_category_id是intseco

6、ndary_category_id是intagreement_media_id否string(36)operator_media_id否string(36)备注：授权函请在第三方代制模式指引文档内下载，手填并 加盖鲜章后，上传彩色扫描件或彩照。1、授权函必须加盖企业公章，或个体户店铺章、发票专用章、财 务章、合同章等具备法律效力的盖章，不可使用个人私章；2、若子商户是个体工商户，且无上述公章，授权函可用个体工商 户经营者手印代替公章，且须同时额外上传个体工商户营业执 照及该执照内登记的经营者的身份证彩照。（本方案仅适用于 子商户是个体工商户，且无公章的场景。其他场景必须在授权函 加盖公章）返回

7、数据“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

8、子商户id，对于一个母商户公众号下唯一create_time子商户信息创建时间update_time子商户信息更新时间brand_name子商户名称（12个汉字内），该名称将在制券时填入并显示在卡券页面上。logo_url子商户logo，可通过上传logo接口获取。该logo将在制券时填入并显示在卡券页面上status子商户状态，“CHECKING“ 审核中,“APPROVED“ , 已通过；“REJECTED“被驳回,“EXPIRED“协议已过期bengin_time创建时间（非协议开始时间）end_time授权函有效期截止时间（东八区时间，单位为秒）primary_category_id子

9、商户一级类目secondary_category_id子商户二级类目若子商户资料通过微信公众平台提交，可在微信公众平台卡券功 能-子商户管理-子商户详情里查看子商户ID，或通过子商户创建 接口返回子商户ID，或通过子商户信息拉取接口获取子商户ID。1.2 子商户审核事件推送开发者所代理的子商户审核通过后，会收到微信服务器发送的事件推送。123456789 0 1字段说明参数ToUserName开发者微信号。FromUserName发送方帐号（一个OpenID）。CreateTime消息创建时间 （整型）。MsgType消息类型，event。Event事件类型，card_merchant_che

10、ck_result(子商户审核事件)MerchantId子商户ID。IsPass是否通过，为1时审核通过。Reason驳回的原因1.3卡券开放类目查询接口接口说明通过调用该接口查询卡券开放的类目ID，类目会随业务发展变 更，请每次用接口去查询获取实时卡券类目。注意：1.本接口查询的返回值还有卡券资质ID,此处的卡券资质为：已微 信认证的公众号通过微信公众平台申请卡券功能时，所需的资 质。2.对于第三方开发者代制（无公众号）模式，子商户无论选择什 么类目，均暂不需按照此返回提供资质，返回值仅参考类目ID 即 可。接口详情接口调用请求说明HTTP请求方式: GET URL:https:/ “pri

11、mary_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“ 参数名err

12、code错误码，0为正常。errmsg错误信息。primary_category_id一级目录idsecondary_category_id二级目录id1.4 更新子商户接口接口说明支持调用该接口更新子商户信息。 接口详情接口调用请求说明http请求方式: POST https:/ “merchant_id“: 12,“app_id“:“xxxxxxxxxxxxx“,“brand_name“: “aaaaaa“,“logo_url“: “http:/mmbiz.xxxx“,“protocol“: “media_id“,“agreement_media_id“:“xxxxxxxxxx“,“ope

13、rator_media_id“:“xxxxxxxx“,“end_time“: 1438990559,“primary_category_id“: 1,“secondary_category_id“: 101 参数名必填类型info是json结构merchant_id是intapp_id否String(36)brand_name是String(36)logo_url是string(128)protocol是String(36)end_time是unsignedintagreement_media_id否string(36)operator_media_id否string(36)primary_c

14、ategory_id是intsecondary_category_id是int返回数据 “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 参

15、数名merchant_id子商户id，对于一个母商户公众号下唯一。创建卡券时需填入该id号，字段结构如下：base_info：sub_merchant_info:merchant_id：，详情见创建卡券接口create_time子商户信息创建时间update_time子商户信息更新时间brand_name子商户名称（12个汉字内），该名称将在制券时填入并显示在卡券页面上。logo_url子商户logo，可通过上传logo接口获取。该logo将在制券时填入并显示在卡券页面上status子商户状态，“CHECKING“ 审核中,“APPROVED“ , 已通过；“REJECTED“被驳回,“EXPIRED“协议已过期bengin_time创建时间（非协议开始时间）end_time授权函有效期截止时间（东八区时间，单位为秒）primary_category_id子商户一级类目s