特殊票券
目录
1.会议/演出门票
1.1 创建会议门票接口 1.2 更新会议门票信息接口
2.景区门票
2.1 创建景区门票
3.电影票
3.1.创建电影票
3.2 更新电影票
4.飞机票
4.1 创建飞机票接口
4.2 更新飞机票信息接口
# 1.会议/演出门票
支持开发者调用接口创建会议/演出门票。
当用户领取门票,调用更新门票接口将座位、入口等信息更新至门票。
# 1.1创建会议门票
接口调用请求说明
http请求方式: POSTURL:https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN
参数说明
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 "}
}
}
会议门票专属字段:
Base_info字段:
返回说明
数据示例:
{
"errcode":0,
"errmsg":"ok",
"card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}
# 1.2 更新会议门票
支持调用“更新会议门票”接口update 入场时间、区域、座位等信息。
接口调用请求说明
http请求方式: POSTURL:https://api.weixin.qq.com/card/meetingticket/updateuser?access_token=TOKEN
参数说明
{
"code": "717523732898",
"card_id": "pXch-jvdwkJjY7evUFV-sGsoMl7A",
"zone" : "C区",
"entrance" : "东北门",
"seat_number" : "2排15号"
}
返回说明
数据示例:
{
"errcode":0,
"errmsg":"ok"
}
# 2. 景区门票
# 2.1 创建景区门票
接口调用请求说明
http请求方式: POSTURL: https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN
参数说明
{ "card": {
"card_type": "SCENIC_TICKET",
"scenic_ticket": {
"base_info": {
},
"ticket_class": "全日票"
}
}
}
景区门票专属字段:
Base_info字段详情见1.1 创建会议门票接口内字段书名
返回说明
{
"errcode":0,
"errmsg":"ok",
"card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}
# 3 电影票
电影票券主要分为以下两种:
1、电影票兑换券,归属于团购券。
2、选座电影票,在购买时需要选定电影、场次、座位,具备较强的时效性和特殊性,此类电影票券即文档中的电影票。
# 3.1创建电影票
接口调用请求说明
http请求方式: POSTURL:https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN
参数说明
{ "card": {
"card_type": "MOVIE_TICKET",
"movie_ticket": {
"base_info": {
},
"detail": "电影名:xxx,电影简介:xxx"
}
}
}
电影票专属字段:
Base_info字段详情见1.1 创建会议门票接口内字段书名
# 3.2 更新电影票
领取电影票后通过调用“更新电影票”接口update电影信息及用户选座信息。
接口调用请求说明
http请求方式: POSTURL:https://api.weixin.qq.com/card/movieticket/updateuser?access_token=TOKEN
参数说明
{
"code" : "277217129962",
"card_id": "p1Pj9jr90_SQRaVqYI239Ka1erkI",
"ticket_class": "4D",
"show_time": 1408493192,
"duration":120,
"screening_room": "5号影厅",
"seat_number": [ "5 排14 号" , "5排15号" ]
}
返回说明
数据示例:
{ "errcode":0, "errmsg":"ok"}
# 4.飞机票
飞机票与其他卡券相比具有更强的时效性和特殊性,故机票生成后无需经过微信审核,即时生效。 机票使用场景主要分为以下两种:
1、通过微信购买后直接添加至卡包,可值机时段由卡包在线办理登机牌。
2、在微信商户(一般为航空公司)公众号内完成值机后,添加至微信卡包。
第一种场景: 用户点击商户H5页面“添加至卡包”后,商户根据用户机票信息,调用接口创建卡券,获取card_id后,将机票下发给用户。在可值机时段,用户点击商户指定的URL在线办理登机牌。办理成功后,商户调用更新机票信息接口,将值机信息同步。
第二种场景: 用户点击商户H5页面提供的JS API后,商户根据用户机票信息,调用接口生成卡券,获取card_id后,将机票下发给用户。并立即更新机票接口,将值机信息同步。
# 4.1 创建飞机票接口
机票示例
接口调用请求说明
HTTPS请求方式: POSTURL:https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN
参数说明
{"card": {
"card_type": "BOARDING_PASS",
"boarding_pass": {
"base_info": {
xxxxxxxxxxxxxxxxxxxx
xxxxxxxxxxxxxxxxxxxxx
},
"from": "成都",
"to": "广州",
"flight": "CE123",
"departure_time": "1434507901",
"landing_time": "1434909901",
"air_model": "空客A320"
}
}
}
机票专属字段:
Base_info字段详情见1.1 创建会议门票接口内字段书名
返回说明
数据示例:
{
"errcode":0,
"errmsg":"ok",
"card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}
# 4.2 更新飞机票信息接口
接口调用请求说明
http请求方式: POST URL:https://api.weixin.qq.com/card/boardingpass/checkin?access_token=TOKEN
参数说明
{
"code": "198374613512",
"card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI",
"passenger_name": "乘客姓名",
"class": "舱等",
"seat": "座位号",
"etkt_bnr": "电子客票号",
"qrcode_data": "二维码数据",
"is_cancel ": false
}
返回说明
数据示例:
{
"errcode":0,
"errmsg":"ok"
}