特殊票券
特殊票类
会议/演出门票
支持开发者调用接口创建会议/演出门票,并当用户领取门票,调用更新门票接口将座位、入口等信息更新至门票。
创建会议门票
接口调用请求说明
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 | 错误信息。 |