×

使用微信公众平台开发前必读

微信公众平台开发概述微信公众平台开发者规范微信公众号接口权限说明微信公众号接口调用频次限制说明

开始开发微信公众平台

微信开发者平台接入指南微信公众平台接口域名说明微信平台开发者获取access_token获取微信服务器IP地址微信平台开发报警排查指引微信接口测试号申请

微信公众平台自定义开发

微信平台开发自定义菜单创建接口微信公众平台自定义菜单查询接口微信自定义菜单删除接口微信自定义菜单事件推送微信公众平台个性化菜单接口微信获取自定义菜单配置接口

微信公众平台 消息管理

微信平台接收普通消息微信平台开发接收事件推送微信平台被动回复用户消息微信消息加解密说明微信公众号客服消息微信高级群发接口微信公众号开发模板消息接口微信平台开发者模板消息运营规范获取微信公众号的自动回复规则

微信网页开发

微信网页授权微信网页开发样式库微信JS-SDK说明文档微信web开发者工具

微信平台素材管理

微信新增临时素材获取微信平台临时素材微信开发者新增永久素材微信开发者 删除永久素材微信开发者修改永久图文素材获取微信公众号素材总数获取微信公众平台的素材列表

微信平台 用户管理

微信公众号用户标签管理微信平台开发者设置用户备注名获取微信公众号用户的基本信息(UnionID机制)获取微信公众号用户列表获取微信用户地理位置微信公众号黑名单管理

管理微信账号

微信生成带参数的二维码微信公众号长链接转短链接接口微信认证事件推送

微信公众号数据统计

微信用户分析数据接口微信图文分析数据接口微信消息分析数据接口微信接口分析数据接口

微信卡券接口说明

微信卡券接口微信平台开发者创建卡券微信平台投放卡券核销微信平台的卡券微信公众号管理卡券微信卡券事件推送微信平台会员卡专区(一)微信平台会员卡专区(二)微信优惠券朋友的券专区微信特殊票券第三方微信开发者模式微信卡券错误码

微信门店

微信门店接口

微信小店

微信小店接口微信平台语义理解接口

微信设备功能

微信服务号设备功能介绍微信如何新增产品型号

微信平台新版客服功能

将消息转发到微信客服微信客服管理微信会话控制微信获取聊天记录

微信摇一摇周边

申请开通微信摇一摇微信设备ID微信摇一摇页面管理微信摇一摇上传图片素材微信平台管理设备与页面的关联关系微信摇一摇数据统计微信摇一摇关注的JSAPI微信摇一摇事件通知微信html5页面获取设备信息微信摇一摇获取设备及用户信息微信摇一摇红包介绍说明微信摇一摇周边错误码

微信连WIFI

微信连Wi-Fi开发者指引微信Wi-Fi硬件鉴权协议接口说明微信Wi-Fi软件服务管理接口说明开通微信连Wi-Fi插件微信Wi-Fi门店管理微信Wi-Fi设备管理配置微信WiFi联网方式微信商家主页管理微信平台Wi-Fi数据统计连网后微信公众号下发消息微信卡券投放微信Wi-Fi接口返回错误码微信连网过程常见错误码

微信扫一扫

微信扫一扫接入指南微信上进行商品创建微信商品发布微信商品管理微信扫一扫事件推送微信一物一码专区微信扫一扫错误码微信公众号在线帮助工具微信扫一扫常见问题

微信特殊票券


特殊票类

会议/演出门票

支持开发者调用接口创建会议/演出门票,并当用户领取门票,调用更新门票接口将座位、入口等信息更新至门票。

会议/演出门票

创建会议门票

接口调用请求说明

http请求方式: POSThttps://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN

参数说明

参数 是否必须 说明
access_token 调用接口凭证
POST数据 Json数据

POST数据示例:

{ 
"card": {
   "card_type": "MEETING_TICKET",
   "meeting_ticket": {
       "base_info": {
           "logo_url": 
"http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmxibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0",
           "brand_name":"票务公司",
           "code_type":"CODE_TYPE_TEXT",
           "title": "XX会议",
           "color": "Color010",
           "notice": "使用时向检票员出示此券",
           "service_phone": "020-88888888",
           "description": "请务必准时入场",
           "date_info": {
               "type": 1,
               "begin_timestamp": 1397577600 ,
               "end_timestamp": 1422724261
           },
           "sku": {
               "quantity": 50000000
           },
           "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",
                  },
       "meeting_detail": "会议时间:xxx;地点:xxx "}
 }
}
参数名 必填 类型 示例值 描述
card_type string(24) MEETING_TICKET 会议门票类型。
base_info Json结构 见上述示例。 基本的卡券数据,见下表,所有卡券通用。
meeting_detail string(3072) 本次会议于2015年5月10号在广州举行,会场地点:xxxx。 会议详情。
map_url string(128) xxx.com 会场导览图。

base_info字段

参数名 必填 类型 示例值 描述
logo_url string(128) http://mmbiz.qpic.cn/ 卡券的商户logo,建议像素为300*300。
code_type string(16) CODE_TYPE_TEXT Code展示类型,"CODE_TYPE_TEXT",文本;"CODE_TYPE_BARCODE",一维码 ;"CODE_TYPE_QRCODE",二维码;"CODE_TYPE_ONLY_QRCODE",二维码无code显示;"CODE_TYPE_ONLY_BARCODE",一维码无code显示;
brand_name string(36) xx票务公司 商户名字,字数上限为12个汉字。
title string(27) xx会议门票 卡券名,字数上限为9个汉字。(建议涵盖卡券属性、服务及金额)。
color string(16) Color010 券颜色。按色彩规范标注填写Color010-Color100。
notice string(48) 请出示二维码核销卡券 卡券使用提醒,字数上限为16个汉字。
description string(3072) 不可与其他优惠同享/n如需团购券发票,请向店员提出要求。 卡券使用说明,字数上限为1024个汉字。
sku Json结构 见上述示例。 商品信息。
quantity int 100000 卡券库存的数量,不支持填写0,上限为100000000。
date_info Json结构 见上述示例。 使用日期,有效期的信息。
type int 1 使用时间的类型,仅支持填写1或2。1为固定日期区间,2为固定时长(自领取后按天算)。
begin_timestamp unsigned int 14300000 type为1时专用,表示起用时间。从1970年1月1日00:00:00至起用时间的秒数,最终需转换为字符串形态传入。(东八区时间,单位为秒)
end_timestamp unsigned int 15300000 type为1时专用,表示结束时间,建议设置为截止日期的23:59:59过期。(东八区时间,单位为秒)
fixed_term int 0 type为2时专用,表示自领取后多少天内有效,领取后当天有效填写0。(单位为天)
fixed_begin_term int 15 type为2时专用,表示自领取后多少天开始生效。(单位为天)
use_custom_code bool true 是否自定义Code码。填写true或false,默认为false。通常自有优惠码系统的开发者选择自定义Code码,在卡券投放时带入。
bind_openid bool true 是否指定用户领取,填写true或false。默认为false。
service_phone string(24) 40012234 客服电话。
location_id_list array 1234,2312 门店位置ID。调用POI门店管理接口获取门店位置ID。
source string(36) 大众点评 第三方来源名,例如同程旅游、大众点评。
custom_url_name string(15) 立即使用 自定义跳转外链的入口名字。
custom_url string(128) "xxxx.com" 自定义跳转的URL。
custom_url_sub_title string(18) 更多惊喜 显示在入口右侧的提示语。
promotion_url_name string(15) 产品介绍 营销场景的自定义入口名称。
promotion_url string(128) XXXX.com 入口跳转外链的地址链接。
promotion_url_sub_title string(18) 卖场大优惠。 显示在营销入口右侧的提示语。
get_limit int 1 每人可领券的数量限制。
can_share bool false 卡券领取页面是否可分享。
can_give_friend bool false 卡券是否可转赠。

返回说明

数据示例:

{
   "errcode":0,
   "errmsg":"ok",
   "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}
参数名 描述
errcode 错误码,0为正常。
errmsg 错误信息。
card_id 卡券ID。

更新会议门票

支持调用“更新会议门票”接口update 入场时间、区域、座位等信息。

接口调用请求说明

http请求方式: POSThttps://api.weixin.qq.com/card/meetingticket/updateuser?access_token=TOKEN

参数说明

参数 是否必须 说明
access_token 调用接口凭证
POST数据 Json数据
{
   "code": "717523732898",
   "card_id": "pXch-jvdwkJjY7evUFV-sGsoMl7A",
   "zone" : "C区",
   "entrance" : "东北门",
   "seat_number" : "2排15号"
}
参数名 必填 类型 示例值 描述
code string(20) 1231123 卡券Code码。
card_id string(32) pXch-jvdwkJjY7evUFV-sGsoMl7A 要更新门票序列号所述的card_id,生成券时use_custom_code 填写true 时必填。
begin_time unsigned int 1433432201 开场时间,Unix时间戳格式。
end_time unsigned int 1433432401 结束时间,Unix时间戳格式。
zone string(12) C 区 区域。
entrance string(12) 3号门 入口。
seat_number string(12) 2 排15 号 座位号。

返回说明

数据示例:

{
   "errcode":0,
   "errmsg":"ok"
}
参数名 描述
errcode 错误码,0为正常。
errmsg 错误信息。

景区门票

创建景区门票

接口调用请求说明

http请求方式: POSThttps://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN

参数说明

参数 是否必须 说明
access_token 调用接口凭证
POST数据 Json数据
{ 
"card": {
   "card_type": "SCENIC_TICKET",
   "scenic_ticket": {
       "base_info": {
          },
       "ticket_class": "全日票"
   }
  }
 }
参数名 必填 类型 示例值 描述
card_type string(24) SCENIC_TICKET 景区门票类型。
base_info Json结构 见上述示例。 基本的卡券数据,见下表,所有卡券通用。
ticket_class string(3072) 平日全票 票类型,例如平日全票,套票等。
guide_url string(128) xxx.com 导览图url


参数名 必填 类型 示例值 描述
logo_url string(128) http://mmbiz.qpic.cn/ 卡券的商户logo,建议像素为300*300。
code_type string(16) CODE_TYPE_TEXT Code展示类型,"CODE_TYPE_TEXT",文本;"CODE_TYPE_BARCODE",一维码 ;"CODE_TYPE_QRCODE",二维码;"CODE_TYPE_ONLY_QRCODE",二维码无code显示;"CODE_TYPE_ONLY_BARCODE",一维码无code显示;
brand_name string(36) 长隆旅游景区 商户名字,字数上限为12个汉字。
title string(27) 景区通票 卡券名,字数上限为9个汉字。(建议涵盖卡券属性、服务及金额)。
color string(16) Color010 券颜色。按色彩规范标注填写Color010-Color100。详情见获取颜色列表接口
notice string(48) 请出示二维码核销卡券 卡券使用提醒,字数上限为16个汉字。
description string(3072) 不可与其他优惠同享/n如需团购券发票,请向店员提出要求。 卡券使用说明,字数上限为1024个汉字。
sku Json结构 见上述示例。 商品信息。
quantity int 100000 卡券库存的数量,不支持填写0,上限为100000000。
date_info Json结构 见上述示例。 使用日期,有效期的信息。
type int 1 使用时间的类型,仅支持填写1或2。1为固定日期区间,2为固定时长(自领取后按天算)。
begin_timestamp unsigned int 14300000 type为1时专用,表示起用时间。从1970年1月1日00:00:00至起用时间的秒数,最终需转换为字符串形态传入。(东八区时间,单位为秒)
end_timestamp unsigned int 15300000 type为1时专用,表示结束时间,建议设置为截止日期的23:59:59过期。(东八区时间,单位为秒)
fixed_term int 0 type为2时专用,表示自领取后多少天内有效,领取后当天有效填写0。(单位为天)
fixed_begin_term int 15 type为2时专用,表示自领取后多少天开始生效。(单位为天)
use_custom_code bool true 是否自定义Code码。填写true或false,默认为false。通常自有优惠码系统的开发者选择自定义Code码,在卡券投放时带入。
bind_openid bool true 是否指定用户领取,填写true或false。默认为false。
service_phone string(24) 40012234 客服电话。
location_id_list array 1234,2312 门店位置ID。调用POI门店管理接口获取门店位置ID。
source string(36) 大众点评 第三方来源名,例如同程旅游、大众点评。
custom_url_name string(15) 立即使用 自定义跳转外链的入口名字。
custom_url string(128) "xxxx.com" 自定义跳转的URL。
custom_url_sub_title string(18) 更多惊喜 显示在入口右侧的提示语。
promotion_url_name string(15) 产品介绍 营销场景的自定义入口名称。
promotion_url string(128) XXXX.com 入口跳转外链的地址链接。
promotion_url_sub_title string(18) 卖场大优惠。 显示在营销入口右侧的提示语。
get_limit int 1 每人可领券的数量限制。
can_share bool false 卡券领取页面是否可分享。
can_give_friend bool false 卡券是否可转赠。

返回说明

数据示例:

{
   "errcode":0,
   "errmsg":"ok",
   "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}
参数名 描述
errcode 错误码,0为正常。
errmsg 错误信息。
card_id 卡券ID。

电影票

电影票券主要分为以下两种:

1、电影票兑换券,归属于团购券。

2、选座电影票,在购买时需要选定电影、场次、座位,具备较强的时效性和特殊性,此类电影票券即文档中的电影票。

使用场景: 用户点击商户H5页面提供的添加至卡包JS-SDK后,商户根据用户电影票信息,调用接口创建卡券,获取card_id后,将带有唯一Code码的电影票下发给用户,用户领取后通过接口(更新电影票)update用户选座信息。

电影票

创建电影票

接口调用请求说明

http请求方式: POSThttps://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN

参数说明

参数 是否必须 说明
access_token 调用接口凭证
POST数据 Json数据
{ 
"card": {
   "card_type": "MOVIE_TICKET",
   "movie_ticket": {
       "base_info": {
          },
       "detail": "电影名:xxx,电影简介:xxx"
   }
  }
 }
参数名 必填 类型 示例值 描述
card_type string(24) MOVIE_TICKET 电影票类型。
base_info Json结构 见上述示例。 基本的卡券数据,见下表,所有卡券通用。
detail string(3072) 电影名:xxx,电影简介:xxx。 电影票详情

base_info字段

参数名 必填 类型 示例值 描述
logo_url string(128) http://mmbiz.qpic.cn/ 卡券的商户logo,建议像素为300*300。
code_type string(16) CODE_TYPE_TEXT Code展示类型,"CODE_TYPE_TEXT",文本;"CODE_TYPE_BARCODE",一维码 ;"CODE_TYPE_QRCODE",二维码;"CODE_TYPE_ONLY_QRCODE",二维码无code显示;"CODE_TYPE_ONLY_BARCODE",一维码无code显示;
brand_name string(36) 电影票 商户名字,字数上限为12个汉字。
title string(27) 复仇者联盟2 卡券名,字数上限为9个汉字。(建议涵盖卡券属性、服务及金额)。
color string(16) Color010 券颜色。按色彩规范标注填写Color010-Color100。详情见获取颜色列表接口
notice string(48) 输入兑换码核销 卡券使用提醒,字数上限为16个汉字。
description string(3072) 不可与其他优惠同享。 卡券使用说明,字数上限为1024个汉字。
sku Json结构 见上述示例。 商品信息。
quantity int 100000 卡券库存的数量,不支持填写0,上限为100000000。
date_info Json结构 见上述示例。 使用日期,有效期的信息。
type int 1 使用时间的类型,仅支持填写1或2。1为固定日期区间,2为固定时长(自领取后按天算)。
begin_timestamp unsigned int 14300000 type为1时专用,表示起用时间。从1970年1月1日00:00:00至起用时间的秒数,最终需转换为字符串形态传入。(东八区时间,单位为秒)
end_timestamp unsigned int 15300000 type为1时专用,表示结束时间,建议设置为截止日期的23:59:59过期。(东八区时间,单位为秒)
fixed_term int 0 type为2时专用,表示自领取后多少天内有效,领取后当天有效填写0。(单位为天)
fixed_begin_term int 15 type为2时专用,表示自领取后多少天开始生效。(单位为天)
use_custom_code bool true 是否自定义Code码。填写true或false,默认为false。通常自有优惠码系统的开发者选择自定义Code码,在卡券投放时带入。
bind_openid bool true 是否指定用户领取,填写true或false。默认为false。
service_phone string(24) 40012234 客服电话。
location_id_list array 1234,2312 门店位置ID。调用POI门店管理接口获取门店位置ID。
source string(36) 大众点评 第三方来源名,例如同程旅游、大众点评。
custom_url_name string(15) 立即使用 自定义跳转外链的入口名字。
custom_url string(128) "xxxx.com" 自定义跳转的URL。
custom_url_sub_title string(18) 更多惊喜 显示在入口右侧的提示语。
promotion_url_name string(15) 产品介绍 营销场景的自定义入口名称。
promotion_url string(128) XXXX.com 入口跳转外链的地址链接。
promotion_url_sub_title string(18) 卖场大优惠。 显示在营销入口右侧的提示语。
get_limit int 1 每人可领券的数量限制。
can_share bool false 卡券领取页面是否可分享。
can_give_friend bool false 卡券是否可转赠。

更新电影票

领取电影票后通过调用“更新电影票”接口update电影信息及用户选座信息。

接口调用请求说明

http请求方式: POSThttps://api.weixin.qq.com/card/movieticket/updateuser?access_token=TOKEN

参数说明

参数 是否必须 说明
access_token 调用接口凭证
POST数据 Json数据
 {   
"code" : "277217129962",
"card_id": "p1Pj9jr90_SQRaVqYI239Ka1erkI",
"ticket_class": "4D",
"show_time": 1408493192,
"duration":120,
"screening_room": "5号影厅",
"seat_number": [ "5 排14 号" , "5排15号" ]
  }
参数名 必填 类型 示例值 描述
code string(20) 1231123 卡券Code码。
card_id string(32) 持白金会员卡到店消费,可享8折优惠。 要更新门票序列号所述的card_id,生成券时use_custom_code填写true时必填。
ticket_class string(12) 2D 电影票的类别,如2D、3D。
screening_room string(12) A厅 该场电影的影厅信息。
seat_number string(12) 5排10座 座位号。
show_time unsigned int 14300000 电影的放映时间,Unix时间戳格式。
duration int 120 放映时长,填写整数。

返回说明

数据示例:

{
   "errcode":0,
   "errmsg":"ok"
}
参数名 描述
errcode 错误码,0为正常。
errmsg 错误信息。

飞机票


飞机票与其他卡券相比具有更强的时效性和特殊性,故机票生成后无需经过微信审核,即时生效。 机票使用场景主要分为以下两种:

1、通过微信购买后直接添加至卡包,可值机时段由卡包在线办理登机牌。

2、在微信商户(一般为航空公司)公众号内完成值机后,添加至微信卡包。

第一种场景: 用户点击商户H5页面“添加至卡包”后,商户根据用户机票信息,调用接口创建卡券,获取card_id后,将机票下发给用户。在可值机时段,用户点击商户指定的URL在线办理登机牌。办理成功后,商户调用更新机票信息接口,将值机信息同步。

第二种场景: 用户点击商户H5页面提供的JS API后,商户根据用户机票信息,调用接口生成卡券,获取card_id后,将机票下发给用户。并立即更新机票接口,将值机信息同步。

创建飞机票接口


创建飞机票接口

接口调用请求说明

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

参数说明

参数 是否必须 说明
access_token 调用接口凭证
POST数据 Json数据

{
"card": {
   "card_type": "BOARDING_PASS",
   "boarding_pass": {
       "base_info": {
        xxxxxxxxxxxxxxxxxxxx
        xxxxxxxxxxxxxxxxxxxxx
       },
       "from": "成都",
       "to": "广州",
       "flight": "CE123",
       "departure_time": "1434507901",
       "landing_time": "1434909901",
       "air_model": "空客A320"
   }
  }
 }

机票专属字段:

参数名 必填 类型 示例值 描述
card_type string(24) BOARDING_PASS 飞机票类型。
base_info JSON结构 见示例 基本的卡券数据,所有卡券通用,详细字段见下表。
from string(54) 成都 起点,上限为18个汉字。
to string(54) 广州 终点,上限为18个汉字。
flight string(24) CE123 航班
gate string(12) A11 入口,上限为4个汉字。
check_in_url string(128) xxx.com 在线值机的链接。
air_model string(24) 空客A320 机型,上限为8个汉字。
departure_time string(128) 1434507901 起飞时间。Unix时间戳格式。
landing_time string(128) 1434909901 降落时间。Unix时间戳格式。


返回说明

数据示例:

{
   "errcode":0,
   "errmsg":"ok",
   "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}
参数名 描述
errcode 错误码,0为正常。
errmsg 错误信息。
card_id 卡券ID。

更新飞机票信息接口

接口调用请求说明

http请求方式: POSThttps://api.weixin.qq.com/card/boardingpass/checkin?access_token=TOKEN

参数说明

参数 是否必须 说明
access_token 调用接口凭证
POST数据 Json数据
{
"code": "198374613512",
"card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI",
"passenger_name": "乘客姓名",
"class": "舱等",
"seat": "座位号",
"etkt_bnr": "电子客票号",
"qrcode_data": "二维码数据",
"is_cancel ": false
}
参数名 必填 类型 示例值 描述
code string(20) 1231123 卡券Code码。
card_id string(32) p1Pj9jr90_SQRaVqYI239Ka1erkI 卡券ID,自定义Code码的卡券必填。
etkt_bnr string(14) 1234567 电子客票号,上限为14个数字。
class string(15) 经济舱。 舱等,如头等舱等,上限为5个汉字。
qrcode_data string(3072) 12345 二维码数据。乘客用于值机的二维码字符串,微信会通过此数据为用户生成值机用的二维码。
seat string(12) 5排c号 乘客座位号。
is_cancel bool false 是否取消值机。填写true或false。true代表取消,如填写true上述字段(如calss等)均不做判断,机票返回未值机状态,乘客可重新值机。默认填写false。

返回说明

数据示例:

{
   "errcode":0,
   "errmsg":"ok"
}
参数名 描述
errcode 错误码,0为正常。
errmsg 错误信息。


分类导航

关注微信下载离线手册

bootwiki移动版 bootwiki
(群号:472910771)