特殊票券
目錄
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 錯誤信息。
總結
- 上一篇: C++ 按位与、或、异或等运算方法
- 下一篇: html下拉菜单换背景颜色,如何在sel