特殊票券

深藏阁楼爱情的钟 2022-06-08 10:59 376阅读 0赞

1.会议/演出门票  
1.1 创建会议门票接口  
1.2 更新会议门票信息接口

2.飞机票  
2.1 创建飞机票接口  
2.2 更新飞机票信息接口  
3.电影票  
3.1.创建电影票  
3.2 更新电影票  
4.景区门票  
4.1 创建景区门票

特殊票类

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

1.1创建会议门票  
接口调用请求说明  
http请求方式: POST  
URL:[https://api.weixin.qq.com/card/create?access\_token=ACCESS\_TOKEN][https_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][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][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/][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至起用时间的秒数，最终需转换为字符串形态传入。（东八区时间(UTC+8)，单位为秒）  
end\_timestamp 否 unsigned int 15300000 type为1时专用，表示结束时间，建议设置为截止日期的23:59:59过期。（东八区时间(UTC+8)，单位为秒）  
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 更新会议门票  
支持调用“更新会议门票”接口update 入场时间、区域、座位等信息。

接口调用请求说明  
http请求方式: POST  
URL:[https://api.weixin.qq.com/card/meetingticket/updateuser?access\_token=TOKEN][https_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 错误信息。

1.  景区门票  
    2.1 创建景区门票  
    接口调用请求说明  
    http请求方式: POST  
    URL: [https://api.weixin.qq.com/card/create?access\_token=ACCESS\_TOKEN][https_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
    
    Base\_info字段详情见1.1 创建会议门票接口内字段书名

返回说明

\{  
“errcode”:0,  
“errmsg”:”ok”,  
“card\_id”:”p1Pj9jr90\_SQRaVqYI239Ka1erkI”  
\}  
参数名 描述  
errcode 错误码，0为正常。  
errmsg 错误信息。  
card\_id 卡券ID。  
3 电影票  
电影票券主要分为以下两种：  
1、电影票兑换券，归属于团购券。  
2、选座电影票，在购买时需要选定电影、场次、座位，具备较强的时效性和特殊性，此类电影票券即文档中的电影票。

3.1创建电影票  
接口调用请求说明  
http请求方式: POST  
URL:[https://api.weixin.qq.com/card/create?access\_token=ACCESS\_TOKEN][https_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字段详情见1.1 创建会议门票接口内字段书名

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

接口调用请求说明  
http请求方式: POST  
URL:[https://api.weixin.qq.com/card/movieticket/updateuser?access\_token=TOKEN][https_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 错误信息。  
4.飞机票

飞机票与其他卡券相比具有更强的时效性和特殊性，故机票生成后无需经过微信审核，即时生效。 机票使用场景主要分为以下两种：  
1、通过微信购买后直接添加至卡包，可值机时段由卡包在线办理登机牌。  
2、在微信商户（一般为航空公司）公众号内完成值机后，添加至微信卡包。

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

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

4.1 创建飞机票接口

机票示例

接口调用请求说明  
HTTPS请求方式: POST  
URL:[https://api.weixin.qq.com/card/create?access\_token=ACCESS\_TOKEN][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时间戳格式。

Base\_info字段详情见1.1 创建会议门票接口内字段书名

返回说明  
数据示例：  
\{  
“errcode”:0,  
“errmsg”:”ok”,  
“card\_id”:”p1Pj9jr90\_SQRaVqYI239Ka1erkI”  
\}  
参数名 描述  
errcode 错误码，0为正常。  
errmsg 错误信息。  
card\_id 卡券ID。

4.2 更新飞机票信息接口  
接口调用请求说明  
http请求方式: POST  
URL:[https://api.weixin.qq.com/card/boardingpass/checkin?access\_token=TOKEN][https_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 错误信息。

[https_api.weixin.qq.com_card_create_access_token_ACCESS_TOKEN]: https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN
[http_mmbiz.qpic.cn_mmbiz_iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmxibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g_0]: http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmxibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0
[http_www.qq.com]: http://www.qq.com
[http_mmbiz.qpic.cn]: http://mmbiz.qpic.cn/
[https_api.weixin.qq.com_card_meetingticket_updateuser_access_token_TOKEN]: https://api.weixin.qq.com/card/meetingticket/updateuser?access_token=TOKEN
[https_api.weixin.qq.com_card_movieticket_updateuser_access_token_TOKEN]: https://api.weixin.qq.com/card/movieticket/updateuser?access_token=TOKEN
[https_api.weixin.qq.com_card_boardingpass_checkin_access_token_TOKEN]: https://api.weixin.qq.com/card/boardingpass/checkin?access_token=TOKEN