Change Reshop - PKFARE Flight Buyer API

Function

This API is used for a change reshop. User can indicate order number, origin, destination, and departure date to check flight availability by using relevant parameters. Order number is refer to PKFARE order number, the change is able to raise base on issued order or change order.

Error Code List

errorCode	errorMessage	description
0	ok	Request has been processed successfully.
S001	System error	System error.
P001	xxx is illegal	Parameter in the request is illegal. xxx will be replaced by the element name
P002	xxx is missing	Parameter is not in the request, which is mandatory. xxx will be replaced by the element name.
P006	Invalid parameter	Invalid parameter.
B002	Partner is not exists	Partner is not exists.
B003	Illegal sign	Illigal sign, please check signature session
B009	Order status is invalid	Order status is not allow to change.
B037	Order is not exist.	Order number is not exists.
B038	Departure date must be today to a year.	Departure date must be today to a year.
B048	Invalid buyer	Buyer is invalid, please contact with PKFARE administrator
B135	Passenger or ticket number is not in the order	Passenger or ticket number in the request is not in the order.
B148	UploadedFileId is not exist.	UploadedFileIds in the request is not exist.
B150	The order was changed, please kindly use change order number.	The order was changed before. Please use the latest order number to raise change.
B152	pnrList information is not same as order, please kindly check.	pnrList information is not same as order, please kindly check.
B156	Order#[Order number] is not applicable for change	The order is neither origin order nor change order. Change request is not allowed.
B157	Duplicate change has been found for passenger[passenger name] in order [order number]	A duplicated request is found, and order for previous request was created succesfully. You are able to use order number in the message to request OrderDetails API for more information.
B160	You have the option to select any day within a {x}-day window prior to the original departure date or {x} days window following the original departure date as the new departure date, but not allow change to {Blackout date range}.	According to airline rules, the change is only allowed in a time window.
B162	Change is not applicable for passenger xxx/xxx	Passenger has requested for void or refund, change is not allowed.
B163	Ticket(s) [ticket number] is No-show, change is not applicable.	The ticket is noshow per airline rules, change is not allowed.
B164	Passenger(s) must has same routing and request to change. If routing isvaries, please request per passenger.	One of multiple Passenger(s) in the request has requested to change the routing. Change is not allow to raise togther.
B165	Uncompleted segmentList, it should contain segments of whole journey	Itinerary in the request is part of the journey, change by segment is not support for this order.
B174	Reason is not match with voluntary type.	Reason is not match with voluntary type.
B175	Reason is not match with involuntary type.	Reason is not match with involuntary type.
B176	Infant is not support for change. Please kindly contact online service for help.	Infant is not support for change. Please kindly contact online service for help.

Cabin Class

Value	Description
Economy	Enconomy class
PremiumEconomy	Premium Economy class
Business	Business class
First	First class

Request

Body Params application/json

Example

{
	"authentication": {
		"sign": "{{sign}}",
		"partnerId": "{{partnerId}}"
	},
	"data": {
		"orderNum": "916958958684833601",
		"voluntaryType": 0,
		"changeReason": 0,
		"passengerList": [
			{
				"birthday": "2003-09-28",
				"cardNum": "",
				"cardType": "PP",
				"firstName": "yi",
				"lastName": "bao",
				"nationality": "CN",
				"sex": "M"
			},
			{
				"birthday": "2017-09-28",
				"cardNum": "",
				"cardType": "PP",
				"firstName": "san",
				"lastName": "bao",
				"nationality": "CN",
				"sex": "M"
			}
		],
		"changeAirLegs": [
			{
				"journeySeq": 0,
				"airportOrCity": 1,
				"destination": "BKK",
				"origin": "HKG",
				"departureDate": "2024-10-07"
			},
			{
				"journeySeq": 1,
				"airportOrCity": 1,
				"destination": "HKG",
				"origin": "BKK",
				"departureDate": "2024-10-20"
			}
		]
	}
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Bodyapplication/json

Examples

Instant Repricing for ChangesAsync Repricing for ChangesChange rejected

{
    "data": {
        "flights": [
            {
                "flightId": "a26d645b1d2d5c71ba0749fa9fd96f01",
                "journeyTime": "1525",
                "segmentIds": [
                    "f77a96773b837d0f86d19b5458a4b9c3",
                    "fa2296922596330db9db53a7e2607432"
                ],
                "transferCount": "1"
            },
            {
                "flightId": "6815cbebca0cf5ba590967ee438d573d",
                "journeyTime": "1145",
                "segmentIds": [
                    "370004a702073eeec91c6e4324d0fc39",
                    "fa2296922596330db9db53a7e2607432"
                ],
                "transferCount": "1"
            },
            {
                "flightId": "14c6b6bf0287e9705a04e7665e120f95",
                "journeyTime": "1690",
                "segmentIds": [
                    "4bd7b30e064883d5f76045ecd5d1dddb",
                    "fa2296922596330db9db53a7e2607432"
                ],
                "transferCount": "1"
            }
        ],
        "solutions": [
            {
                "adtChangeAmount": 0,
                "adtChangeFee": 0,
                "baggageMap": {
                    "ADT": [
                        {
                            "baggageWeight": "20KG",
                            "segmentIndexList": [
                                "1",
                                "2"
                            ]
                        }
                    ],
                    "CHD": []
                },
                "chdChangeAmount": 0,
                "chdChangeFee": 0,
                "currency": "CNY",
                "fareType": "PUBLIC",
                "journeys": {
                    "journey_1": [
                        "a26d645b1d2d5c71ba0749fa9fd96f01"
                    ]
                },
                "lastTktTime": "2023-10-07 23:59:00",
                "merchantFee": 0,
                "miniRuleMap": {
                    "CHD": [
                        {
                            "miniRules": [],
                            "segmentIndex": [
                                "1"
                            ]
                        },
                        {
                            "miniRules": [],
                            "segmentIndex": [
                                "2"
                            ]
                        }
                    ]
                },
                "platingCarrier": "OD",
                "solutionKey": "de43c371998ad3b809401b78cb09f16d",
                "totalChangeAmount": 0
            },
            {
                "adtChangeAmount": 0,
                "adtChangeFee": 0,
                "baggageMap": {
                    "ADT": [
                        {
                            "baggageWeight": "20KG",
                            "segmentIndexList": [
                                "1",
                                "2"
                            ]
                        }
                    ],
                    "CHD": []
                },
                "chdChangeAmount": 0,
                "chdChangeFee": 0,
                "currency": "CNY",
                "fareType": "PUBLIC",
                "journeys": {
                    "journey_1": [
                        "6815cbebca0cf5ba590967ee438d573d"
                    ]
                },
                "lastTktTime": "2023-10-07 23:59:00",
                "merchantFee": 0,
                "miniRuleMap": {
                    "CHD": [
                        {
                            "miniRules": [],
                            "segmentIndex": [
                                "1"
                            ]
                        },
                        {
                            "miniRules": [],
                            "segmentIndex": [
                                "2"
                            ]
                        }
                    ]
                },
                "platingCarrier": "OD",
                "solutionId": "a211f7574da54aae7d0a6f0bbf5742c6",
                "solutionKey": "a211f7574da54aae7d0a6f0bbf5742c6",
                "totalChangeAmount": 0
            },
            {
                "adtChangeAmount": 0,
                "adtChangeFee": 0,
                "baggageMap": {
                    "ADT": [
                        {
                            "baggageWeight": "20KG",
                            "segmentIndexList": [
                                "1",
                                "2"
                            ]
                        }
                    ],
                    "CHD": []
                },
                "chdChangeAmount": 0,
                "chdChangeFee": 0,
                "currency": "CNY",
                "fareType": "PUBLIC",
                "journeys": {
                    "journey_1": [
                        "14c6b6bf0287e9705a04e7665e120f95"
                    ]
                },
                "lastTktTime": "2023-10-07 23:59:00",
                "merchantFee": 0,
                "miniRuleMap": {
                    "CHD": [
                        {
                            "miniRules": [],
                            "segmentIndex": [
                                "1"
                            ]
                        },
                        {
                            "miniRules": [],
                            "segmentIndex": [
                                "2"
                            ]
                        }
                    ]
                },
                "platingCarrier": "OD",
                "solutionId": "0c62b654ef24bbb8dd4c6295bf34198c",
                "solutionKey": "0c62b654ef24bbb8dd4c6295bf34198c",
                "totalChangeAmount": 0
            }
        ],
        "passengers": [
            {
                "birthday": "2020-03-04",
                "cardExpiredDate": "2025-06-07",
                "cardNum": "E12345678",
                "cardType": "PP",
                "firstName": "TIFFANY",
                "lastName": "YANGC",
                "nationality": "CN",
                "psgType": "CHD",
                "sex": "M"
            },
            {
                "birthday": "1990-08-23",
                "cardExpiredDate": "2024-03-17",
                "cardNum": "E07700466",
                "cardType": "PP",
                "firstName": "TIFFANY",
                "lastName": "YANGA",
                "nationality": "CN",
                "psgType": "ADT",
                "sex": "M"
            }
        ],
        "segments": [
            {
                "airline": "OD",
                "arrival": "KUL",
                "arrivalDate": "1697472000000",
                "arrivalTerminal": "1",
                "availabilityCount": 9,
                "bookingCode": "X",
                "cabinClass": "ECONOMY",
                "codeShare": "N",
                "departure": "DMK",
                "departureDate": "1697472000000",
                "departureTerminal": "0",
                "equipment": "738",
                "flightNum": "525",
                "flightTime": 135,
                "opFltAirline": "",
                "segmentId": "4bd7b30e064883d5f76045ecd5d1dddb",
                "strArrivalDate": "2023-10-17",
                "strArrivalTime": "12:20",
                "strDepartureDate": "2023-10-17",
                "strDepartureTime": "09:05"
            },
            {
                "airline": "OD",
                "arrival": "HKG",
                "arrivalDate": "1697558400000",
                "arrivalTerminal": "2",
                "availabilityCount": 9,
                "bookingCode": "X",
                "cabinClass": "ECONOMY",
                "codeShare": "N",
                "departure": "KUL",
                "departureDate": "1697558400000",
                "departureTerminal": "1",
                "equipment": "738",
                "flightNum": "605",
                "flightTime": 240,
                "opFltAirline": "",
                "segmentId": "fa2296922596330db9db53a7e2607432",
                "strArrivalDate": "2023-10-18",
                "strArrivalTime": "14:15",
                "strDepartureDate": "2023-10-18",
                "strDepartureTime": "10:15"
            },
            {
                "airline": "OD",
                "arrival": "KUL",
                "arrivalDate": "1697472000000",
                "arrivalTerminal": "1",
                "availabilityCount": 9,
                "bookingCode": "X",
                "cabinClass": "ECONOMY",
                "codeShare": "N",
                "departure": "DMK",
                "departureDate": "1697472000000",
                "departureTerminal": "0",
                "equipment": "738",
                "flightNum": "523",
                "flightTime": 135,
                "opFltAirline": "",
                "segmentId": "370004a702073eeec91c6e4324d0fc39",
                "strArrivalDate": "2023-10-17",
                "strArrivalTime": "21:25",
                "strDepartureDate": "2023-10-17",
                "strDepartureTime": "18:10"
            },
            {
                "airline": "OD",
                "arrival": "KUL",
                "arrivalDate": "1697472000000",
                "arrivalTerminal": "1",
                "availabilityCount": 9,
                "bookingCode": "X",
                "cabinClass": "ECONOMY",
                "codeShare": "N",
                "departure": "DMK",
                "departureDate": "1697472000000",
                "departureTerminal": "0",
                "equipment": "738",
                "flightNum": "521",
                "flightTime": 135,
                "opFltAirline": "",
                "segmentId": "f77a96773b837d0f86d19b5458a4b9c3",
                "strArrivalDate": "2023-10-17",
                "strArrivalTime": "15:05",
                "strDepartureDate": "2023-10-17",
                "strDepartureTime": "11:50"
            }
        ]
    },
    "errorCode": "0",
    "errorMsg": "ok"
}

🟢200Error