PreciseBooking V7

Function

Through the most updated version PreciseBooking_V5 API, Seat selection in the bookings are supported based on the results from AncillaryPricing_V3.

It's not supported that multiple paid checked bags or multiple paid carry-on bags are added for the same passenger on a single journey, but it's allowed to add a checked bag and a carry-on baggage on a single journey at the same time.

Besides, it's not allowed to add multiple seats for the same passenger in a flight or select the same seat for multiple passengers in a flight.

It is necessary to use PrecisePricing service before using this interface. The whole process should be limited to 30 mins.

Versioning

Version	Sandbox Invoking Address	Update
PreciseBooking	https://api.pkfare.com/preciseBooking
PreciseBooking_V2	https://api.pkfare.com/preciseBooking_V2	It is capable of buying ancillaries
PreciseBooking_V3	https://api.pkfare.com/preciseBooking_V3	Support infant (no seat) bookings.
PreciseBooking_V4	https://api.pkfare.com/preciseBooking_V4	support seat selection in the initial booking
PreciseBooking_V5	https://api.pkfare.com/preciseBooking_V5	Add solutionId to enhance tracebility and visibility
PreciseBooking_V5(json format)	https://api.pkfare.com/json/preciseBooking_V5	Add solutionId to enhance tracebility and visibility; Support json formatted requesting structure
PreciseBooking_V6(json format)	https://api.pkfare.com/json/preciseBooking_V6	Add solutionId to enhance tracebility and visibility; Support json formatted requesting structure
PreciseBooking_V7(json format)	https://api.pkfare.com/json/preciseBooking_V7	support booking prices for different product tags, including PKFARE-defined special product types and airline-standard branded fares, etc.

Below is the most updated version

Error Code List

erroCode	erroMsg	Description
0	ok	Request has been processed successfully.
S001	System error.	System error.
B002	Partner is not exists.	PartnerID does not exist.
B003	Illegal sign.	Illegal sign. Please check your signature.
B035	Concurrency limited. Please contact PKFARE API support team for assistant.	Concurrency exceeded system limits.
P001	XXX is illegal.	The field of XXX is illegal.
P002	XXX is missing.	The field of XXX is missing.
P006	Invalid parameter.	Value of request cannot pass the validation, please check on the request.
0307	Reservation failed - Booking class is sold out.	Reservation failed. Seats have been sold out.
B004	There are errors in the passenger type of Adults.	Adult passenger's age does not meet the requirements.
B005	Can not find any matching precisePricing result within 30 minutes.	Can not find the corresponding precisePricing record. Please check the itinerary and passenger numbers. PreciseBooking has to be invoked within 30 minutes after pricing.
B006	Reservation failed - Other. OrderNum is XXX.	Booking fail for other reason. The order has been created which is indicated in Other.OrderNum field
B006	Reservation failed.	Booking fail for other reason.
B007	Reservation failed - Segment status is not HK.	Segment status is invalid from GDS. Please select other flight options.
B008	Itinerary is different between PNR and order.	Itinerary in reservation is different from precisePricing. There might be a flight re-schedule. Please select other flight options.
B011	Reservation failed - Fare is unavailable.	Fare is unavailable form GDS. Please select other flight options.
B012	Reservation failed - Create PNR time out.	Create PNR time out from GDS. Please wait some minutes or select other flight options.
B017	Price is changed.	Price is changed.
B023	Reservation failed - Save price fail.	Fail to save price from GDS.
B022	There are errors in the passenger type of Children	Child passenger's age does not meet the requirements.
B025	Reservation failed - RT PNR fail.	Fail to retieve PNR from GDS.
B027	Airline PNR is missing.	Airline PNR is missing from GDS.
B028	Reservation failed - Time out.	Booking time out from GDS.
B029	Duplicate reservations have been found for passenger XXX/XXX in order XXX, in pnr XXX.	Duplicated reservation is not allowed. If there is an order with same segment and passenger, system will block the second reservation and return error. Please cancel the last duplicated order or pay the last order directly.
B030	Illegal passenger name, please use Chinese character.	Wrong passenger name. If passengers use Chinese ID card to make reservation for China domestic flight, please use Chinese character.
B031	Illegal passenger name, please use correct Chinese character.	Wrong passenger name. If passengers use chinese ID card to make reservation, the chinese name length is over the limitation.
B032	Illegal passport, please use 'N' as document type if you are using Chinese ID card to make reservation.	Illegal passport. If passengers book Chinese flight, please use correct passport.
B043	Reservation failed: Create PNR failed.	Booking failed from GDS.
B044	Reservation failed - Create PNR failed, end transaction failed.	Booking failed from GDS.
B062	The length of passenger name should be 40 English alphabet including / between last name and first name.	Passenger's name should be within 40 English alphabet, including "/" between last name and first name.
B064	The lastName of passegner should be within 2-30 English alphabet.	Passenger's last name should be within 2-30 English alphabet.
B065	Passenger's document information must be filled in for this trip. Passenger's document information contains cardType, cardNum, cardExpiredDate and nationality.	Passenger's document information must be filled in for this trip. Passenger's document information contains cardType, cardNum, cardExpiredDate and nationality.Please contact PKFARE API support.
B069	Reservation failed, this fare has passenger age limitation.	Reservation failed, because this fare has a passenger age limition.
B077	There are erros in the passenger type of infants.	Infant passenger's age does not meet the requirements.
B078	Lack of passengerIndex.	For bookings contain infant(s) , passengerIndex is required for each passenger.
B079	Each infant must be associated to one adult and each adult can only be associated to one infant maximum.	Each infant must be associated to one adult and each adult can only be associated to one infant maximum.
B080	Invalid or duplicated or discontinuous passengerIndex	PassengerIndex must be positive and continuous integers starting from 1.
B081	Error in ancillary passenger info.	Error in ancillary passenger info.
B087	Booking Failed. System has recognized possible churning.	Churning booking behaviour were detected and booking request with the same passenger will be restricted.
B192	Duplicate baggages are not allowed in the same journey.	Only one baggage purchase is allowed for the same journey, all subsequent attempts will be granted with this response.
B193	Multiple seat selection is not allowed in the same flight.	Only one seat selection is allowed for the same journey, all subsequent attempts will be granted with this response.

application/json

Bodyapplication/json

Examples

Success(Response without ancillary)Success(Response with baggage)Success(Response with seat)Success(Response with baggage and seat)Success(Response With Fare Family)

{
    "errorCode": "0",
    "errorMsg": "ok",
    "data": {
        "orderNum": "917132752968703001",
        "pnr": "WC7JP4",
        "solution": {
            "solutionKey": "0bbef6a2cfbaf9188b344fbb7229dd2b",
            "solutionId": "OqDCC1j2GhG9XTKOd0/KF+6M/7Mn+gurPNfAlXIf00HtDIJIZmfk2/NfuNJ8U2NS4KZ5IHjxWoNYHt7SgOgt+PwbtwEji+tazJ+2u2Gmmtxr0fPZjbWUBzlNkMCRhoB3Rzt0Av7jBdhCM4LocbIrD0YzA4S6SxfrTr0woQVRPS1WLvZhJwx7IzWEctrqdnv7TOEK5QbnBDh8RalKJoykngem8SOx/0E4p6mjulWQH8XYvBwaq+THRi7ZdDLHgOLvAWpM+ja0R8Rzzu3yPfD5iNXaG1LUs87R+yDEjYQH7fY0BkctfLCoLVVZSMVyyA2UgwLRCazQwDXmYe29tsiNAg==",
            "fareType": "PRIVATE",
            "currency": "USD",
            "adtFare": 117.25,
            "adtTax": 59.11,
            "chdFare": 108.87,
            "chdTax": 59.11,
            "infFare": 28.45,
            "infTax": 0,
            "qCharge": 0,
            "tktFee": 0,
            "platformServiceFee": 0,
            "journeys": {
                "journey_0": [
                    "3ca255ac07063fd19f13a4c4055aade2"
                ]
            },
            "platingCarrier": "FD",
            "merchantFee": 0,
            "adults": 1,
            "children": 1,
            "infants": 1,
            "baggageMap": {
                "CHD": [
                    {
                        "segmentIndexList": [
                            1
                        ],
                        "baggageAmount": "0PC",
                        "carryOnAmount": "1PC",
                        "carryOnWeight": "7KG"
                    }
                ],
                "INF": [
                    {
                        "segmentIndexList": [
                            1
                        ]
                    }
                ],
                "ADT": [
                    {
                        "segmentIndexList": [
                            1
                        ],
                        "baggageAmount": "0PC",
                        "carryOnAmount": "1PC",
                        "carryOnWeight": "7KG"
                    }
                ]
            }
        },
        "flights": [
            {
                "flightId": "3ca255ac07063fd19f13a4c4055aade2",
                "journeyTime": 180,
                "transferCount": 0,
                "segmengtIds": [
                    "ea3506f2711c19a82c12bf157fa6b153"
                ]
            }
        ],
        "segments": [
            {
                "segmentId": "ea3506f2711c19a82c12bf157fa6b153",
                "airline": "FD",
                "flightNum": "503",
                "equipment": "320",
                "cabinClass": "ECONOMY",
                "bookingCode": "A",
                "availabilityCount": 5,
                "departure": "HKG",
                "arrival": "DMK",
                "departureTerminal": "1",
                "arrivalTerminal": "2",
                "departureDate": 1735568400000,
                "arrivalDate": 1735575600000,
                "flightTime": 180,
                "codeShare": "N",
                "strDepartureDate": "2024-12-30",
                "strDepartureTime": "22:20",
                "strArrivalDate": "2024-12-31",
                "strArrivalTime": "00:20"
            }
        ]
    }
}

Function

Versioning

Error Code List

Request

Request Code Samples

Responses