Function

Buyer partners should provide a webhook/URL based on HTTP/HTTPS protocol to TSYFare for push change result and airlines PNR. TSYFare will push change ticket numbers when the tickets are issued. In another case, if the change order was rejected, a rejected reason would be provided.

Basic Parameter

Name	Type	Parameter Description	Sample
orderNum	String	reschedule order number	1012674912
status	String	Order status, it contains: CHANGED, or REJECTED	CHANGED
rejectReason	String	Reject reason	change is not permitted as per fare rules.
remark	String	Reject reason remark	-
parentOrderNum	String	Parent order number of this order	110425048101231
informType	String	Include Change_Status	Change_Status
airPnr	String	Airline PNR after rescheduling	EDTCZP
pnr	String	GDS PNR after rescheduling	EDTCZP
pnrList	Array	PNR list, refer to pnrList after rescheduling	-
totalfee	Number	Chang Total Fee	-
feeList	Array	Fee list, refer to feeList	-
passengers	Array	Passenger list, refer to passengers	-
paymentGate	String	Payment gate	Prepay
serialNum	String	Payment serial number	2013012200021000200172105074
merchantOrder	String	Merchant order number	PAY202411011052251028814703
permitVoid	Integer	Allow to void ticket or not. [1-yes, 0-not allowed]	0
data	Object	Include remark field for reference	-

feeList

Name	Type	Parameter Description	Sample
arrival	String	arrival	DEL
departure	String	departure	BKK
changeFee	Number	changeFee	190.0
currency	String	currency	USD
ticketDiffFee	Number	Ticket price difference fee	120.9
taxDiffFee	Number	Tax price difference fee	24.6
totalPricePer	Number	total Price	335.5
passengerId	Integer	passengerId	234521
segmentId	Integer	segmentId	234124
passengerName	String	LastName/FirstName	WANG/JIAN

Passengers

Name	Type	Parameter Description	Sample
passengerIndex	String	Passenger sequence no.	3
birthday	String	Birthday, format[yyyy-mm-dd]	20000101
cardExpiredDate	String	Travel document expired date, format[yyyy-mm-dd]	20300101
cardNum	String	Travel document number	P1234567
cardType	String	Travel document type	PP
firstName	String	First name	JIAN
lastName	String	Last name	WANG
nationality	String	Nationality [country code]	CN
psgType	String	Passenger type, including ADT for adults, CHD for children [age 2-12] and INF for infants [age 0-2, no seat]	ADT
sex	String	Gender, including M for male, F for female	F
ticketNum	String	Ticket number	1122334455667

pnrList

Name	Type	Parameter Description	Sample
segmentNo	Integer	Segment No.	1
departure	String	Departure [IATA airport code]	BKK
arrival	String	Destination [IATA airport code]	CNX
flightNum	String	Flight No.	FD112
cabinClass	String	Cabin class including ECONOMY, PREMIUM ECONOMY, BUSINESS, and FIRST.	ECONOMY
bookingCode	String	Cabin code	E
pnr	String	PNR	EDTCZP
airPnr	String	Airline PNR	EDTCZP
ticketNums	Array	Passengers and corresponding ticket numbers, refer to ticketNum	-

segmentList

Name	Type	Parameter Description	Sample
id	String	sequence no.	1
carrier	String	carrier	FD
arrival	String	arrival	DEL
arrivalTime	String	arrivalTime	P1234567
departureTime	String	departureTime
bookingCode	String	Cabin code	E
flightNum	String	Flight No.	FD112
tripType	String	1:outbound 2:inbound	1
segmentNo	Integer	Segment No.	1
type	String	1:before reschedule. 2:after reschedule	1

ticketNums

Name	Type	Parameter Description	Sample
passengerIndex	Integer	Passenger sequence no. Consistent with the passengerIndex under each passenger.	1
ticketNum	String	Ticket number	110425048101231

Request

Body Params application/json

object {0}

Example

{
    "airPnr": "WD91MQ",
    "currency": "CNY",
    "feeList": [
        {
            "arrival": "DMK",
            "changeFee": 650.0,
            "currency": "CNY",
            "departure": "KIX",
            "passengerId": 1,
            "passengerName": "KANPACHAI/NATTHAKAN",
            "segmentId": 1,
            "taxDiffFee": 150.0,
            "ticketDiffFee": 325.0,
            "totalPricePer": 1125.0
        },
        {
            "arrival": "DMK",
            "changeFee": 650.0,
            "currency": "CNY",
            "departure": "KIX",
            "passengerId": 2,
            "passengerName": "KANPACHAI/SAISAK",
            "segmentId": 1,
            "taxDiffFee": 150.0,
            "ticketDiffFee": 325.0,
            "totalPricePer": 1125.0
        },
        {
            "arrival": "DMK",
            "changeFee": 650.0,
            "currency": "CNY",
            "departure": "KIX",
            "passengerId": 3,
            "passengerName": "KANPACHAI/DITTITA",
            "segmentId": 1,
            "taxDiffFee": 150.0,
            "ticketDiffFee": 325.0,
            "totalPricePer": 1125.0
        }
    ],
    "informType": "Change_Status",
    "orderNum": "2361767123",
    "parentOrderNum": "3110679097",
    "passengers": [
        {
            "birthday": "19630113",
            "cardType": "PP",
            "firstName": "NATTHAKAN",
            "lastName": "KANPACHAI",
            "nationality": "TH",
            "passengerIndex": 1,
            "psgType": "ADT"
        },
        {
            "birthday": "19611109",
            "cardType": "PP",
            "firstName": "SAISAK",
            "lastName": "KANPACHAI",
            "nationality": "TH",
            "passengerIndex": 2,
            "psgType": "ADT"
        },
        {
            "birthday": "19860518",
            "cardType": "PP",
            "firstName": "DITTITA",
            "lastName": "KANPACHAI",
            "nationality": "TH",
            "passengerIndex": 3,
            "psgType": "ADT"
        }
    ],
    "paymentGate": "Prepay",
    "permitVoid": 0,
    "pnrList": [
        {
            "arrival": "DMK",
            "bookingCode": "V",
            "departure": "KIX",
            "flightNumber": "XJ611",
            "segmentNo": 1,
            "ticketNums": [
                {
                    "passengerIndex": 1,
                    "ticketNum": "WD91AA"
                },
                {
                    "passengerIndex": 2,
                    "ticketNum": "WD91AA"
                },
                {
                    "passengerIndex": 3,
                    "ticketNum": "WD91AA"
                }
            ],
            "tripType": 1
        }
    ],
    "refOrderNum": "3110679097",
    "segmentList": [
        {
            "arrival": "DMK",
            "arrivalTime": "202504080130",
            "bookingCode": "V",
            "carrier": "XJ",
            "departure": "KIX",
            "departureTime": "202504072100",
            "flightNum": "XJ611",
            "id": 1,
            "segmentNo": 1,
            "tripType": 1,
            "type": 2
        },
        {
            "arrival": "DMK",
            "arrivalTime": "202504071425",
            "bookingCode": "V",
            "carrier": "XJ",
            "departure": "KIX",
            "departureTime": "202504070955",
            "flightNum": "XJ613",
            "segmentNo": 1,
            "tripType": 1,
            "type": 1
        }
    ],
    "status": "CHANGED",
    "totalFee": 3375.0
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '' \
--header 'Content-Type: application/json' \
--data-raw '{
    "airPnr": "WD91MQ",
    "currency": "CNY",
    "feeList": [
        {
            "arrival": "DMK",
            "changeFee": 650.0,
            "currency": "CNY",
            "departure": "KIX",
            "passengerId": 1,
            "passengerName": "KANPACHAI/NATTHAKAN",
            "segmentId": 1,
            "taxDiffFee": 150.0,
            "ticketDiffFee": 325.0,
            "totalPricePer": 1125.0
        },
        {
            "arrival": "DMK",
            "changeFee": 650.0,
            "currency": "CNY",
            "departure": "KIX",
            "passengerId": 2,
            "passengerName": "KANPACHAI/SAISAK",
            "segmentId": 1,
            "taxDiffFee": 150.0,
            "ticketDiffFee": 325.0,
            "totalPricePer": 1125.0
        },
        {
            "arrival": "DMK",
            "changeFee": 650.0,
            "currency": "CNY",
            "departure": "KIX",
            "passengerId": 3,
            "passengerName": "KANPACHAI/DITTITA",
            "segmentId": 1,
            "taxDiffFee": 150.0,
            "ticketDiffFee": 325.0,
            "totalPricePer": 1125.0
        }
    ],
    "informType": "Change_Status",
    "orderNum": "2361767123",
    "parentOrderNum": "3110679097",
    "passengers": [
        {
            "birthday": "19630113",
            "cardType": "PP",
            "firstName": "NATTHAKAN",
            "lastName": "KANPACHAI",
            "nationality": "TH",
            "passengerIndex": 1,
            "psgType": "ADT"
        },
        {
            "birthday": "19611109",
            "cardType": "PP",
            "firstName": "SAISAK",
            "lastName": "KANPACHAI",
            "nationality": "TH",
            "passengerIndex": 2,
            "psgType": "ADT"
        },
        {
            "birthday": "19860518",
            "cardType": "PP",
            "firstName": "DITTITA",
            "lastName": "KANPACHAI",
            "nationality": "TH",
            "passengerIndex": 3,
            "psgType": "ADT"
        }
    ],
    "paymentGate": "Prepay",
    "permitVoid": 0,
    "pnrList": [
        {
            "arrival": "DMK",
            "bookingCode": "V",
            "departure": "KIX",
            "flightNumber": "XJ611",
            "segmentNo": 1,
            "ticketNums": [
                {
                    "passengerIndex": 1,
                    "ticketNum": "WD91AA"
                },
                {
                    "passengerIndex": 2,
                    "ticketNum": "WD91AA"
                },
                {
                    "passengerIndex": 3,
                    "ticketNum": "WD91AA"
                }
            ],
            "tripType": 1
        }
    ],
    "refOrderNum": "3110679097",
    "segmentList": [
        {
            "arrival": "DMK",
            "arrivalTime": "202504080130",
            "bookingCode": "V",
            "carrier": "XJ",
            "departure": "KIX",
            "departureTime": "202504072100",
            "flightNum": "XJ611",
            "id": 1,
            "segmentNo": 1,
            "tripType": 1,
            "type": 2
        },
        {
            "arrival": "DMK",
            "arrivalTime": "202504071425",
            "bookingCode": "V",
            "carrier": "XJ",
            "departure": "KIX",
            "departureTime": "202504070955",
            "flightNum": "XJ613",
            "segmentNo": 1,
            "tripType": 1,
            "type": 1
        }
    ],
    "status": "CHANGED",
    "totalFee": 3375.0
}'

ChangeResultPush

Function

Basic Parameter

feeList

Passengers

pnrList

segmentList

ticketNums

Request

Request samples

Responses

ChangeResultPush

Function#

Basic Parameter#

feeList#

Passengers#

pnrList#

segmentList#

ticketNums#

Request

Request samples

Responses

Function

Basic Parameter

feeList

Passengers

pnrList

segmentList

ticketNums