Change Passenger Info - PKFARE Flight Buyer API

Function

This API is used for raising change request for changing passenger information. User can indicate order number, booked passenger(s) and new passenger(s) to create a change request. 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	errorMsg	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.
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.
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 is varies, 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.
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.

Request

Body Params application/json

Example

{
    "authentication": {
        "partnerId": "{{partnerId}}",
        "sign": "{{sign}}"
    },
    "data": {
        "voluntaryType": 1,
        "changeReason": 1,
        "uploadedFileIds": [
            "975b70c89f0ed3e3e1555729c11745eb",
            "a98c63e1f9371ccce1555729c11745eb"
        ],
        "changeJourney": {
            "journey_0": [
                {
                    "airline": "OD",
                    "flightNum": "606",
                    "departure": "HKG",
                    "departureDate": "2023-09-29",
                    "departureTime": "15:15",
                    "bookingCode": "T",
                    "cabinClass": "ECONOMY",
                    "arrival": "KUL",
                    "arrivalDate": "2023-09-29",
                    "arrivalTime": "19:05"
                },
                {
                    "airline": "OD",
                    "flightNum": "520",
                    "departure": "KUL",
                    "departureDate": "2023-09-30",
                    "departureTime": "09:55",
                    "bookingCode": "X",
                    "cabinClass": "ECONOMY",
                    "arrival": "DMK",
                    "arrivalDate": "2023-09-30",
                    "arrivalTime": "11:05"
                }
            ],
            "journey_1": [
                {
                    "airline": "OD",
                    "flightNum": "521",
                    "departure": "DMK",
                    "departureDate": "2023-10-20",
                    "departureTime": "11:50",
                    "bookingCode": "X",
                    "cabinClass": "ECONOMY",
                    "arrival": "KUL",
                    "arrivalDate": "2023-10-20",
                    "arrivalTime": "15:05"
                },
                {
                    "airline": "OD",
                    "flightNum": "605",
                    "departure": "KUL",
                    "departureDate": "2023-10-21",
                    "departureTime": "10:15",
                    "bookingCode": "X",
                    "cabinClass": "ECONOMY",
                    "arrival": "HKG",
                    "arrivalDate": "2023-10-21",
                    "arrivalTime": "14:15"
                }
            ]
        },
        "buyerOrder": "buyerOrder1",
        "solutionKey": "",
        "orderNum": "916958798364810031",
        "passengerList": [
            {
                "birthday": "1999-09-09",
                "cardNum": "",
                "cardType": "PP",
                "firstName": "yang",
                "lastName": "zhang",
                "nationality": "CN",
                "sex": "F"
            }
        ],
        "contactInfo": {
            "telNum": "15691012314",
            "name": "amy",
            "email": "amy.zhang@pkfare.com"
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.pkfare.com/json/change/changePassengerInfo' \
--header 'Content-Type: application/json' \
--data-raw '{
    "authentication": {
        "partnerId": "",
        "sign": ""
    },
    "data": {
        "voluntaryType": 1,
        "changeReason": 1,
        "uploadedFileIds": [
            "975b70c89f0ed3e3e1555729c11745eb",
            "a98c63e1f9371ccce1555729c11745eb"
        ],
        "changeJourney": {
            "journey_0": [
                {
                    "airline": "OD",
                    "flightNum": "606",
                    "departure": "HKG",
                    "departureDate": "2023-09-29",
                    "departureTime": "15:15",
                    "bookingCode": "T",
                    "cabinClass": "ECONOMY",
                    "arrival": "KUL",
                    "arrivalDate": "2023-09-29",
                    "arrivalTime": "19:05"
                },
                {
                    "airline": "OD",
                    "flightNum": "520",
                    "departure": "KUL",
                    "departureDate": "2023-09-30",
                    "departureTime": "09:55",
                    "bookingCode": "X",
                    "cabinClass": "ECONOMY",
                    "arrival": "DMK",
                    "arrivalDate": "2023-09-30",
                    "arrivalTime": "11:05"
                }
            ],
            "journey_1": [
                {
                    "airline": "OD",
                    "flightNum": "521",
                    "departure": "DMK",
                    "departureDate": "2023-10-20",
                    "departureTime": "11:50",
                    "bookingCode": "X",
                    "cabinClass": "ECONOMY",
                    "arrival": "KUL",
                    "arrivalDate": "2023-10-20",
                    "arrivalTime": "15:05"
                },
                {
                    "airline": "OD",
                    "flightNum": "605",
                    "departure": "KUL",
                    "departureDate": "2023-10-21",
                    "departureTime": "10:15",
                    "bookingCode": "X",
                    "cabinClass": "ECONOMY",
                    "arrival": "HKG",
                    "arrivalDate": "2023-10-21",
                    "arrivalTime": "14:15"
                }
            ]
        },
        "buyerOrder": "buyerOrder1",
        "solutionKey": "",
        "orderNum": "916958798364810031",
        "passengerList": [
            {
                "birthday": "1999-09-09",
                "cardNum": "",
                "cardType": "PP",
                "firstName": "yang",
                "lastName": "zhang",
                "nationality": "CN",
                "sex": "F"
            }
        ],
        "contactInfo": {
            "telNum": "15691012314",
            "name": "amy",
            "email": "amy.zhang@pkfare.com"
        }
    }
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "errorCode": "0",
    "errorMsg": "ok",
    "data": {
        "parentOrderNum": "916974267198317218",
        "orderNum": "916974267198317240",
        "refOrderNum": "9169742671983172",
        "createTime": "2023-10-16T20:21:55+08:00",
        "orderStatus": "Under review",
        "pnr": "5BDWCY",
        "platingCarrier": "UO",
        "passengers": [
            {
                "lastName": "YANGA",
                "firstName": "TIFFANY",
                "cardType": "PP",
                "cardNum": "E07700466",
                "cardExpiredDate": "2024-03-17",
                "nationality": "US",
                "psgType": "ADT",
                "sex": "F",
                "birthday": "1990-08-23"
            }
        ]
    }
}

🟢200Error