Contents

1.1 Creating Meeting Tickets 1.2 Updating Meeting Tickets

2.1 Creating Attractions Tickets

3. Movie Tickets

3.1. Creating Movie Tickets

3.2 Updating Movie Tickets

4. Air Tickets

4.1 Creating Air Tickets

4.2 Updating Air Tickets

# 1. Meeting/Performance Tickets

Supports developers to call the API for the creation of meeting/performance tickets.

Calls the ticket update API to update the seat, entrance, and other information to the ticket after the user receives the ticket.

# 1.1 Creating Meeting Tickets

API Request Format

HTTP request method: POSTURL:https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN

Parameters

Parameter	Required	Description
access_token	Yes	The credential for API call
POST data	Yes	JSON data

POST data example:


{ "card": {
   "card_type": "MEETING_TICKET",
   "meeting_ticket": {
       "base_info": {
           "logo_url": "http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmxibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0",
           "brand_name":"Ticketing office",
           "code_type":"CODE_TYPE_TEXT",
           "title": "XXMeeting",
           "color": "Color010",
           "notice": "Present this ticket to the ticket inspector at the time of use",
           "service_phone": "020-88888888",
           "description": "Make sure to enter on time",
           "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": "View more",
           "custom_url": "http://www.qq.com",
           "custom_url_sub_title": "6 Chinese characterstips",
                  },
       "meeting_detail": "Meeting time: xxx;Venue: xxx "}
 }
}

Fields dedicated to meeting tickets:

Parameter	Required	Type	Example	Description
card_type	Yes	string(24)	MEETING_TICKET	Meeting ticket type.
base_info	Yes	JSON structure	See the example above.	Basic coupon data (applicable to all coupons). See the table below.
meeting_detail	Yes	string(3072)	The meeting is held on May 10, 2015 in Guangzhou, at xxxx.	Meeting details.
map_url	No	string(128)	xxx.com	Venue map.

Base_info:

Parameter	Required	Type	Example	Description
logo_url	Yes	string(128)	http://mmbiz.qpic.cn/	Merchant logo of coupon. Recommended dimension 300*300 pixels.
code_type	Yes	string(16)	CODE_TYPE_TEXT	Code display type "CODE_TYPE_TEXT", text; "CODE_TYPE_BARCODE", barcode; "CODE_TYPE_QRCODE", QR code; "CODE_TYPE_ONLY_QRCODE", QR code with no code display; "CODE_TYPE_ONLY_BARCODE", barcode with no code display.
brand_name	Yes	string (36)	xx ticketing office	Merchant name, up to 12 Chinese characters.
title	Yes	string (27)	xx meeting ticket	Coupon title, with a maximum length of 9 Chinese characters (18 English characters). A combination of coupon attributes, service items and amount is recommended.
color	Yes	string (16)	Color010	Coupon color. Enter a value between Color010 and Color100.
notice	Yes	string (48)	Present the QR code for coupon redemption	Coupon usage tip, with a maximum length of 16 Chinese characters (32 English characters).
description	Yes	string (3072)	Using with other coupons is not allowed/nAsk the staff for an invoice for the group purchase.	Coupon usage instructions, with a maximum length of 1024 Chinese characters (2048 English characters).
sku	Yes	JSON structure	See example above	Product information
quantity	Yes	int	100000	Coupon inventory. Maximum is 100,000,000. Cannot be 0.
date_info	Yes	JSON structure	See example above.	Information of coupon validity period.
type	Yes	int	1	Coupon validity type. 1: a fixed time range; 2: a fixed number of days (after coupon receipt).
begin_timestamp	No	unsigned int	14300000	Start time of validity period. This field only takes effect when type = 1. It is expressed as a Unix timestamp, i.e. the number of seconds that have elapsed since 00:00:00 1/1/1970 (UTC+8).
end_timestamp	No	unsigned int	15300000	End time of validity period. This field only takes effect when type = 1. It is recommended to set the filed value to 23:59:59 on the expiration data. (UTC+8, in sec).
fixed_term	No	int	0	Indicates the number of days during which the received coupon is valid, and only takes effect when type = 2. Enter 0 if the coupon becomes valid on the day of its receipt.
fixed_begin_term	No	int	15	Indicates the number of days after which the received couponbecomes valid, and only takes effect when type = 2.
use_custom_code	No	bool	true	Whether to use custom code. Enter "true" or "false" (default). Generally, developers owning a coupon code system select custom codes and incorporate the coupons in the coupons for issuance.
bind_openid	No	bool	true	Whether to specify the users to receive the coupons. Enter "true" or "false" (default).
service_phone	No	string（24）	40012234	Customer service number
location_id_list	No	array	1234, 2312	ID of store location. Obtain the value by calling the POI Store Management API.
source	No	string (36)	Dianping	Third-party source name, such as TravelGo, Dianping.
custom_url_name	No	string (15)	Use Now	Title of the custom external redirect link.
custom_url	No	string (128)	"xxxx.com"	Custom redirect URL
custom_url_sub_title	No	string (18)	More surprise	Words shown to the right of the entry button
promotion_url_name	No	string (15)	Product Overview	Title of custom entry button to promotional page.
promotion_url	No	string (128)	XXXX.com	URL of external redirect link
promotion_url_sub_title	No	string (18)	Big Offers!	Words shown to the right of the entry button to the promotional page
get_limit	No	int	1	Maximum number of coupons that each user can claim
can_share	No	bool	false	Indicates whether the coupon claiming page is sharable.
can_give_friend	No	bool	false	Indicates whether the coupon is transferable.

Response Description

Example:


{
   "errcode":0,
   "errmsg":"ok",
   "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}

Parameter	Description
errcode	Error code. 0 indicates a successful request.
errmsg	Error message
card_id	Coupon ID

# 1.2 Updating Meeting Tickets

Calls the "Update Meeting Ticket" API to update the time, area, seat, and other entry information.

API Request Format

HTTP request method: POSTURL:https://api.weixin.qq.com/card/meetingticket/updateuser?access_token=TOKEN

Parameters

Parameter	Required	Description
access_token	Yes	The credential for API call
POST data	Yes	JSON data

{
   "code": "717523732898",
   "card_id": "pXch-jvdwkJjY7evUFV-sGsoMl7A",
   "zone" : Area "C",
   "entrance" : "Northeast gate",
   "seat_number" : Row "2 Seat 15"
}

Parameter	Required	Type	Example	Description
code	Yes	string(20)	1231123	Coupon code.
card_id	No	string (32)	pXch-jvdwkJjY7evUFV-sGsoMl7A	Serial number of the ticket to be updated. card_id is required if use_custom_code is true when the coupon is generated.
begin_time	No	unsigned int	1433432201	Beginning time. Weixin will send a notice through the "A-Hong Tickets" Official Account or the service notification two hours before the event in the Unix timestamp format.
end_time	No	unsigned int	1433432401	Ending time of the event in the Unix timestamp format.
zone	Yes	string (12)	Area C	Area.
entrance	Yes	string (12)	Gate 3	Entrance.
seat_number	Yes	string (12)	Row 2 Seat 15	Seat No.

Response Description

Example:

{
   "errcode":0,
   "errmsg":"ok"
}

Parameter	Description
errcode	Error code. 0 indicates a successful request.
errmsg	Error message

# 2. Attractions Tickets

# 2.1 Creating Attractions Tickets

API Request Format

httpRequest method: POSTURL: https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN

Parameters

Parameter	Required	Description
access_token	Yes	The credential for API call
POST data	Yes	JSON data

{ "card": {
   "card_type": "SCENIC_TICKET",
   "scenic_ticket": {
       "base_info": {
          },
       "ticket_class": "Full-day ticket"
   }
  }
}

Fields dedicated to attractions tickets:

Parameter	Required	Type	Example	Description
card_type	Yes	string(24)	SCENIC_TICKET	Attractions ticket type.
base_info	Yes	SON structure	See the example above.	Basic coupon data (applicable to all coupons). See the table below.
ticket_class	Yes	string(3072)	Weekday full-day ticket	Ticket type, such as weekday full-day ticket and pass.
guide_url	No	string(128)	xxx.com	The URL of the guide map.

Base_info fields (For details, see "1.1 Fields of the Creating Meeting Ticket" API)

Response Description

{
   "errcode":0,
   "errmsg":"ok",
   "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}

Parameter	Description
errcode	Error code. 0 indicates a successful request.
errmsg	Error message
card_id	Coupon ID

# 3 Movie Tickets

There are two types for movie tickets and coupons:

Movie ticket coupon, a group-purchase coupon.
Movie ticket with seat selected. The ticket is time-sensitive and specific with movie, time, and seat all determined when being purchased. This type of tickets are the movie tickets mentioned in documentation.

# 3.1 Creating Movie Tickets

API Request Format

HTTP request method: POSTURL:https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN

Parameters

Parameter	Required	Description
access_token	Yes	The credential for API call
POST data	Yes	JSON data

{ "card": {
   "card_type": "MOVIE_TICKET",
   "movie_ticket": {
       "base_info": {
          },
       "detail": "Movie name: xxx, synopsis: xxx"
   }
  }
}

Fields dedicated to movie tickets:

Parameter	Required	Type	Example	Description
card_type	Yes	string(24)	MOVIE_TICKET	Movie ticket type.
base_info	Yes	JSON structure	See the example above.	Basic coupon data (applicable to all coupons). See the table below.
detail	Yes	string(3072)	Movie name: xxx, synopsis: xxx.	Movie ticket details.

Base_info fields (For details, see 1.1 Fields of the "Create Meeting Ticket" API )

# 3.2 Updating Movie Tickets

Calls the "Update Movie Ticket" API to update the movie and seat information after the user claims the ticket.

API Request Format

HTTP request method: POSTURL:https://api.weixin.qq.com/card/movieticket/updateuser?access_token=TOKEN

Parameters

Parameter	Required	Description
access_token	Yes	The credential for API call
POST data	Yes	JSON data

{
	"code" : "277217129962",
	"card_id": "p1Pj9jr90_SQRaVqYI239Ka1erkI",
	"ticket_class": "4D",
	"show_time": 1408493192,
	"duration"：120,
	"screening_room": Hall "5",
	"seat_number": [ Row "5 Seat 14" , Row "5 Seat 15" ]
}

Parameter	Required	Type	Example	Description
code	Yes	string(20)	1231123	Coupon code.
card_id	Yes	string (32)	Enjoy a 20% discount on Platinum member cards.	Serial number of the ticket to be updated. card_id is required if use_custom_code is true when the coupon is generated.
ticket_class	Yes	string (12)	2D	Movie type, such as 2D and 3D.
screening_room	No	string (12)	Hall A	Hall information of the movie.
seat_number	No	string (12)	Row 5 Seat 10	Seat No.
show_time	Yes	unsigned int	14300000	Movie showtime in the Unix timestamp format.
duration	Yes	int	120	Movie duration. Enter an integer.

Response Description

Example:

{   "errcode":0,   "errmsg":"ok"}

Parameter	Description
errcode	Error code. 0 indicates a successful request.
errmsg	Error message

# 4. Air Tickets

Compared to other coupons, air tickets are more time-sensitive and specific, so the ticket comes into effect directly without approval by Weixin. Air tickets are mainly used in two scenes:

The ticket is added to Cards & Offers directly after being purchased through Weixin. The boarding pass can be processed online from Cards & Offers during check-in time.
The ticket is added to Weixin Cards & Offers after the passenger completes check-in via the Official Account of a Weixin merchant (typically airlines).

Scene 1: After the user clicks "Add to Cards & Offers" on the merchant's HTML5 page, the merchant will call the API to create the ticket with the user information, and issue the ticket after obtaining a card_id. During the check-in period, the user can click the URL specified by the merchant to check in the boarding pass online. After that, the merchant will call the "Update Air Ticket" API to sync the check-in information.

Scene 2: After the user clicks the JS API on the merchant's HTML5 page, the merchant will call the API to generate the ticket with the user information, and issue the ticket after obtaining a card_id. The merchant will immediately update the air ticket API to sync the check-in information.

# 4.1 Creating Air Tickets

Air ticket example

API Request Format

HTTPSRequest method: POSTURL:https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN

Parameters

Parameter	Required	Description
access_token	Yes	The credential for API call
POST data	Yes	JSON data


{"card": {
   "card_type": "BOARDING_PASS",
   "boarding_pass": {
       "base_info": {
        xxxxxxxxxxxxxxxxxxxx
        xxxxxxxxxxxxxxxxxxxxx
       },
       "from": "Chengdu",
       "to": "Guangzhou",
       "flight": "CE123",
       "departure_time": "1434507901",
       "landing_time": "1434909901",
       "air_model": "AirbusA320"
   }
  }
}

Fields dedicated to air ticket:

Parameter	Required	Type	Example	Description
card_type	Yes	string(24)	BOARDING_PASS	Air ticket type.
base_info	Yes	JSON structure	See the example.	Basic coupon data. See the table below. This field is applicable to all coupons.
from	Yes	string(54)	Chengdu	Origin, up to 18 Chinese characters.
to	Yes	string(54)	Guangzhou	Destination, up to 18 Chinese characters.
flight	Yes	string(24)	CE123	Flight
gate	Yes	string(12)	A11	Gate, up to 4 Chinese characters.
check_in_url	No	string(128)	xxx.com	URL for online check-in.
air_model	Yes	string(24)	Airbus A320	Aircraft model, up to 8 Chinese characters.
departure_time	Yes	string(128)	1434507901	Departure time in the Unix timestamp format.
landing_time	Yes	string(128)	1434909901	Landing time in the Unix timestamp format.

Base_info fields (For details, see 1.1 Fields of the "Create Meeting Ticket" API )

Response Description

Example:


{
   "errcode":0,
   "errmsg":"ok",
   "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}

Parameter	Description
errcode	Error code. 0 indicates a successful request.
errmsg	Error message
card_id	Coupon ID

# 4.2 Updating Air Tickets

API Request Format

httpRequest method: POST
URL:https://api.weixin.qq.com/card/boardingpass/checkin?access_token=TOKEN

Parameters

Parameter	Required	Description
access_token	Yes	The credential for API call
POST data	Yes	JSON data

{
"code": "198374613512",
"card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI",
"passenger_name": "Passenger name",
"class": "Class",
"seat": "Seat",
"etkt_bnr": "E-ticket number",
"qrcode_data": "QR code data",
"is_cancel ": false
}

Parameter	Required	Type	Example	Description
code	Yes	string(20)	1231123	Coupon code.
card_id	No	string (32)	p1Pj9jr90_SQRaVqYI239Ka1erkI	Coupon ID. Required for coupon with custom code.
etkt_bnr	Yes	string (14)	1234567	E-ticket number, up to 14 numbers.
class	Yes	string (15)	Economy class	Class, such as first class, up to 5 Chinese characters.
qrcode_data	No	string (3072)	12345	QR code data. The QR code string the passenger used for check-in. Weixin generates the check-in QR code from the data.
seat	No	string (12)	5C	Seat of the passenger.
is_cancel	No	bool	false	Indicates whether to cancel the check-in. Enter true or false (default). When the value is true, the check-in will be canceled with all the fields above (such as class) ignored. The ticket will return to the status before check-in and the passenger can check in again.

Response Description

Example:


{
   "errcode":0,
   "errmsg":"ok"
}

Parameter	Description
errcode	Error code. 0 indicates a successful request.
errmsg	Error message