Description

Partners need to initiate a change request from the B2B backend first. We will asynchronously push the change fee information through the ChangePricePush interface, and then push the change result information through the ChangeResultPush interface

Function

Buyer partners should provide a webhook/URL based on HTTP/HTTPS protocol to TSYFare for push change price . TSYFare will push the ticket price information for rescheduling

Basic Parameter

Name	Type	Parameter Description	Sample
orderNum	String	reschedule order number	1012674912
parentOrderNum	String	Parent order number of this order	110425048101231
informType	String	Include Change_Price	Change_Price
airPnr	String	Airline PNR before rescheduling	EDTCZP
pnr	String	GDS PNR before rescheduling	EDTCZP
pnrList	Array	PNR list, refer to pnrList ,before rescheduling	-
totalfee	Number	Chang Total Fee	-
feeList	Array	Fee list, refer to feeList	-
segmentList	Array	Segment list, refer to segmentList	-
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]	2000-01-01
cardExpiredDate	String	Travel document expired date, format[yyyy-mm-dd]	2000-01-01
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

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

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	-

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": "WD91AA",
    "currency": "CNY",
    "feeList": [
        {
            "arrival": "DMK",
            "changeFee": 650.0,
            "currency": "CNY",
            "departure": "KIX",
            "passengerId": 1,
            "passengerName": "KANPACHAITEST/NATTHAKANTEST",
            "segmentId": 1,
            "taxDiffFee": 150.0,
            "ticketDiffFee": 325.0,
            "totalPricePer": 1125.0
        },
        {
            "arrival": "DMK",
            "changeFee": 650.0,
            "currency": "CNY",
            "departure": "KIX",
            "passengerId": 2,
            "passengerName": "KANPACHAITEST/SAISAKTEST",
            "segmentId": 1,
            "taxDiffFee": 150.0,
            "ticketDiffFee": 325.0,
            "totalPricePer": 1125.0
        },
        {
            "arrival": "DMK",
            "changeFee": 650.0,
            "currency": "CNY",
            "departure": "KIX",
            "passengerId": 3,
            "passengerName": "KANPACHAITEST/DITTITATEST",
            "segmentId": 1,
            "taxDiffFee": 150.0,
            "ticketDiffFee": 325.0,
            "totalPricePer": 1125.0
        }
    ],
    "informType": "Change_Price",
    "orderNum": "236176712322222",
    "parentOrderNum": "311067909722222",
    "passengers": [
        {
            "birthday": "19630113",
            "cardType": "PP",
            "firstName": "NATTHAKANTEST",
            "lastName": "KANPACHAITEST",
            "nationality": "TH",
            "passengerIndex": 1,
            "psgType": "ADT"
        },
        {
            "birthday": "19611109",
            "cardType": "PP",
            "firstName": "SAISAKTEST",
            "lastName": "KANPACHAITEST",
            "nationality": "TH",
            "passengerIndex": 2,
            "psgType": "ADT"
        },
        {
            "birthday": "19860518",
            "cardType": "PP",
            "firstName": "DITTITATEST",
            "lastName": "KANPACHAITEST",
            "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
        }
    ],
    "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": "WD91AA",
    "currency": "CNY",
    "feeList": [
        {
            "arrival": "DMK",
            "changeFee": 650.0,
            "currency": "CNY",
            "departure": "KIX",
            "passengerId": 1,
            "passengerName": "KANPACHAITEST/NATTHAKANTEST",
            "segmentId": 1,
            "taxDiffFee": 150.0,
            "ticketDiffFee": 325.0,
            "totalPricePer": 1125.0
        },
        {
            "arrival": "DMK",
            "changeFee": 650.0,
            "currency": "CNY",
            "departure": "KIX",
            "passengerId": 2,
            "passengerName": "KANPACHAITEST/SAISAKTEST",
            "segmentId": 1,
            "taxDiffFee": 150.0,
            "ticketDiffFee": 325.0,
            "totalPricePer": 1125.0
        },
        {
            "arrival": "DMK",
            "changeFee": 650.0,
            "currency": "CNY",
            "departure": "KIX",
            "passengerId": 3,
            "passengerName": "KANPACHAITEST/DITTITATEST",
            "segmentId": 1,
            "taxDiffFee": 150.0,
            "ticketDiffFee": 325.0,
            "totalPricePer": 1125.0
        }
    ],
    "informType": "Change_Price",
    "orderNum": "236176712322222",
    "parentOrderNum": "311067909722222",
    "passengers": [
        {
            "birthday": "19630113",
            "cardType": "PP",
            "firstName": "NATTHAKANTEST",
            "lastName": "KANPACHAITEST",
            "nationality": "TH",
            "passengerIndex": 1,
            "psgType": "ADT"
        },
        {
            "birthday": "19611109",
            "cardType": "PP",
            "firstName": "SAISAKTEST",
            "lastName": "KANPACHAITEST",
            "nationality": "TH",
            "passengerIndex": 2,
            "psgType": "ADT"
        },
        {
            "birthday": "19860518",
            "cardType": "PP",
            "firstName": "DITTITATEST",
            "lastName": "KANPACHAITEST",
            "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
        }
    ],
    "totalFee": 3375.0
}'

ChangePricePush

Description#

Function#

Basic Parameter#

feeList#

Passengers#

segmentList#

pnrList#

ticketNums#