目錄

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
參數說明
參數 是否必須 說明
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至起用時間的秒數，最終需轉換為字符串形態傳入。（東八區時間(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

參數說明
參數 是否必須 說明
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 錯誤信息。

景區門票
2.1 創建景區門票
接口調用請求說明
http請求方式: POST
URL: 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
參數說明
參數 是否必須 說明
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

參數說明
參數 是否必須 說明
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

參數說明
參數 是否必須 說明
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
參數說明
參數 是否必須 說明
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 錯誤信息。

總結

以上是生活随笔為你收集整理的特殊票券的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。