礼品卡接口文档

更新日期	说明
2016/11/15	支持增删改查货架
2016/12/7	创建货架接口结构调整，增加了主题结构
2016/12/14	增加赠送礼品卡事件
2016/12/21	批量拉取接口由GET修改为POST方法
2016/12/27	新增兑换卡类型
2017/1/5	支持开发者预设礼品卡转赠次数
2017/1/19	增加了page_title字段开发者可以自定义page的title
2017/2/8	新增下架货架页接口
2017/2/20	新增申请流程
2017/4/25	支持支付后开发票功能
2017/6/2	新增礼品卡群发的开关
2017/12/25	1.支持买给自己选项 2.支持单个/批量查询订单3.支持为单品增加商品缩略图和商品描述4.增加商户自助配置小程序流程5.支持营销功能6.小程序渠道支持自定义投放渠道值

1.礼品卡概述

微信为礼品卡商户提供了一套完整的微信礼品卡的创建、销售以及使用流程，商户可以在微信卡券平台通过API创建礼品卡、创建礼品卡货架、调用接口进行余额同步。开发者通过将创建的礼品卡货架配置在在公众号或生成二维码贴在门店进行礼品卡的售卖。

用户可以通过购买礼品卡送给朋友并且附上祝福语，表达节日的祝福和慰问。一张小小的礼品卡，传递浓浓的情谊。

商户微信礼品卡有以下优势：

1卡包收纳、存储，用户再也不用担心弄丢礼品卡了；

2 原生社交转赠流程顺畅、安全，朋友之间赠送礼品卡变得更加容易了；

3 打开礼品卡礼包的惊喜感，让收到礼品的朋友享受双重喜悦；

4 商户使用微信提供的动态码能力，可以免开发就可以使用安全的二维码储值消费流程；

5 多渠道售卖，商户可以将礼品卡货架配置在公众号菜单、图文、二维码甚至广告渠道进行销售。
更多惊喜，等你一起来探索。

2.礼品卡产品流程

以下交互示意供参考，实际以最终实现为准。

2.1 礼品卡购买赠送流程

小程序

2.2 礼品卡接收流程

小程序

2.3礼品卡卡包内展示

小程序

3. 接入门槛

3.1 类目范围

现阶段主要针对以下卡券类目商户开放，虚拟类目暂不支持。具体如下：

一级类目	二级类目
购物	百货商场、购物中心/购物街、超市、便利店、普通食品、保健食品、酒类、副食品门市、服饰、鞋类箱包、珠宝配饰、化妆品、日护用品、钟表眼镜、鲜花礼品、母婴用品、运动户外、乐器、图书报刊杂志、药房/药店、数码家电、家纺家装、建材五金/机械仪表、综合电商
生活服务	汽车销售、加油站、家政服务、养生养护、婚庆服务、汽车维修
酒店	星级酒店、度假村、快捷酒店
美食	粤菜、茶餐厅、川菜、湘菜、东北菜、西北菜、火锅、自助餐、小吃、快餐、日本料理、韩国料理、东南亚菜、西餐、面包甜点、咖啡厅、江浙菜、其它美食、酒吧/俱乐部、外卖
休闲娱乐	美容美发、美甲、温泉洗浴、运动健身、足疗按摩

3.2 商户资质要求

微信礼品卡根据其承载内容，分为储值类型礼品卡和单品类型礼品卡。其中储值类型礼品卡，指卡面信息包含具体储值金额，如1000元礼品卡，单品类型礼品卡，指该礼品卡用于兑换指定单品，如汉堡礼品卡。两种礼品卡需要商户具备的资质条件有所不同，具体如下。

3.2.1储值类型礼品卡

商户需具备单用途预付卡备案才可开展礼品卡业务（含礼品储值卡和礼品兑换券），若备案主体与公众号主体不一致，需符合以下条件之一：集团发卡、品牌发卡、多用途牌照方担保。

补充材料

过渡阶段以邮件方式提交，说明如下：

1）
集团发卡：若单用途预付卡持牌机构为集团母公司，申请储值权限的公众号认证主体为集团旗下子公司，且股权占比50%以上，申请方可额外补充备案公司的《集团发卡授权书》（需有备案公司公章），以开通权限。

2）
品牌发卡：若单用途预付卡持牌机构为品牌方，申请储值权限的公众号认证主体为品牌授权的加盟商，申请方可额外补充《特许经营授权书》（需有备案公司公章），以开通权限。

这两种种情况下，授权书由企业自拟，需说明清楚以下情况：我是谁；我备案的情况；我授权给谁；授权它做什么事情（以集团名义发卡？以品牌名义发卡？）；被授权方发的卡，我负责兑现。

3）
多用途预付卡牌照：若申请方获得预付卡发行与受理的发行机构（《支付业务许可证》）的合作授权，申请方可通过邮件直接提交《多用途预付卡备案》材料，以及备案方与申请方的《合作协议》（需有备案公司公章），以开通权限。

此处需关注三点：

a. 牌照方必须是“预付卡发行与受理”的发行机构，不能是“预付卡受理”的受理机构；b.
完成授权后，品牌方需委托牌照方执行制卡、发卡等行为，品牌方自身公众号仍未获得预付卡权限，如果牌照方需要进行预付卡销售，为合规行为，经法务评估不存在二清风险，另由于目前法规规定发卡机构应当通过实体网点发行销售预付卡，建议优先接入有实体卡业务的商户；

c.
《支付机构预付卡业务管理办法》规定，支付机构应该严格按照《支付业务许可证》核准的业务类型和业务范围从事预付卡业务，不得在未设立省级分支机构的省（自治区、直辖市、计划单列市）从事预付卡业务。因此，地方性的牌照持有方不得在全国范围开展业务。

多用途牌照方授权的情况下，授权书在以上基础上，还需要补充以下说明，即需完整描述：

a)
我是谁,我备案的情况，我授权给谁，授权它做什么事情，被授权方发的卡，我负责兑现；

b) 特约商户基本信息；

c) 收费项目和标准；

d) 持卡人用卡权益的保障要求；

e) 卡片信息、交易数据、受理终端、交易凭证的管理要求；

f) 特约商户收款账户名称、开户行、账号及资金结算周期；

g) 账务核对、差错处理和业务纠纷的处置要求；

h) 相关业务风险承担和违约责任的承担机制 ;

i) 协议终止条件、终止后的债权债务清偿方式。

补充材料，在过渡阶段统一以邮件的方式，发送给：weixincard@tencent.com;
fourierwang@tencent.com,lamielu@tencent.com; olinawang@tencent.com;
jenniezhou@tencent.com; timdong@tencent.com 。后续会支持在MP系统提交。

3.2.2 单品类型礼品卡

无需具备预付卡资质，平台视为普通兑换卡业务。符合类目要求的商家无需单独走申请流程，凭接口文档可以直接开发。

4 接入准备

4.1 拥有一个认证公众号并开通卡券功能

4.1.1新注册流程

若商户还未拥有开通卡券功能的公众号，商户可以登陆【微信公众平台】进行公众号注册并进行认证，具体流程参见：《注册微信公众平台》
注册完成后，商户可以登录【微信公众平台】，并进入【添加插件】-【卡包功能】提交相应资料并开通卡券功能，详情参见：《微信卡券功能使用规则》。

4.1.2非新注册流程

若商户已有开通卡券功能的公众号则可根据自身情况，决定是否直接复用。

注：以上开通均需3-5工作日的审核时间，请根据项目进度提前申请操作。

4.2 拥有一个认证小程序（礼品卡专用）

我们需要商户提供一个独立的小程序用于上传礼品卡的代码以及资料。须商户申请或拥有一个礼品卡专用的小程序。

4.2.1 新注册流程

若商户还未拥有认证的小程序，商户可以登陆【微信公众平台】进行小程序注册并进行认证，具体流程参见：《注册小程序账号》。

4.2.2 复用公众号资质快速注册

若商户已有认证公众账号，可以登录【微信公众平台】，进入【小程序管理】-【添加】-【快速注册并认证小程序】直接快速注册认证的小程序。

4.3 使用用公众号申请商户号

商户须使用公众号申请的商户号来走通礼品卡的配置流程，申请流程请见：【微信公众平台】

注意事项
1 自助配置流程仅支持公众号申请的商户号，小程序申请的商户号暂不支持走自助配置流程；
2 商户号建议为礼品卡专用，便于对账统计；
3 支持普通服务商和直连商户模式的商户号，暂不支持银行服务商和支付机构服务商模式下的商户号。

5开发概述

5.1 须知

礼品卡为微信卡券的一种类型，请开发者在开发礼品卡功能之前请先概览《公众平台接口文档》、《微信卡券接口文档》以及《微信卡券功能使用规则》以确保熟悉礼品卡开发中涉及的基本概念和礼品卡运营相关的基本准则。

5.2 术语解释

为了避免开发者在开发过程中产生概念混淆，请开发在开发礼品卡接口前熟知以下术语。

参数名	描述
card_id	卡券ID。一个卡券ID对应一类卡券，包含了相应库存数量的Code码。
code	卡券Code码。一张卡券的唯一标识，核销卡券时使用此串码，支持商户自定义。
openid	用户在该公众号下的唯一身份。
access_token	调用接口的凭证，有效时间为7200s，每次请求刷新，通过获取access_token接口获取,开发者需妥善保存并建立缓存机制。
jsapi_ticket	调用微信内网页调用微信原生功能的JS-SDK接口须使用的签名票据，详情见:JS-SDK部分
api_ticket	调用微信卡券接口时签名的临时票据，有效时间为7200s， 7200s内重复请求保持不变，获取api_ticket接口获取。
card_ext	可扩张卡券的附加信息，用于投放卡券是附带卡券基本信息。
outer_str	领券渠道的场景值。支持商户自定义场景值填入card_ext进行卡券投放，当用户领取时会将相应场景值通过事件通知商户。
事件推送	在卡券通过审核、卡券被领取、卡券被删除、卡券被核销时，均会推送事件通知开发者，接收地址为公众平台开发者中心填写的服务器URL。
自定义入口	通过API创建卡券支持商户自定义卡券详情页跳转外链的单元。
礼品卡使用	本文档定义礼品卡的余额减少称为礼品卡使用。包括但不限于线下POS机余额扣减，用户在线使用等场景