AncillaryPricing V5
POST
/json/ancillaryPricingV5
Function
same time or search them separately.
AncillaryPricing is the same as that of PrecisePricing. It is necessary to use PrecisePricing service before using this
interface. The whole process should be limited to 30 mins.
Ancillarypricing request when adding ancillary after the booking. AncillaryPricing Results are valid within half an hour.
Versioning
| Version | Sandbox Invoking Address | Update |
|---|---|---|
| ancillaryPricing | https://api.pkfare.com/ancillaryPricing | Support in-booking paid baggage |
| ancillaryPricing_V3 | http://api.pkfare.com/ancillaryPricingV3 | Support in-booking seat selection |
| ancillaryPricing_V4 | http://api.pkfare.com/ancillaryPricingV4 | Support postbooking paid bag |
| ancillaryPricing_V5 | http://api.pkfare.com/ancillaryPricingV5 | Add solutionId to enhance tracebility and visibility |
| ancillaryPricing_V5(json format) | http://api.pkfare.com/json/ancillaryPricingV5 | Add solutionId to enhance tracebility and visibility;Support json formatted requesting parameter |
Request Example
1.
{
"authentication": {
"partnerId":"partnerId",
"sign":"sign"
},
"pricing": {
"adults": 1,
"children": 0,
"ancillary": [
1
],
"solutionId": "1",
"journeys": {
"journey_0": [
{
"airline":"TR",
"arrival":"HKG",
"arrivalDate":"2022-04-23",
"arrivalTime":"10:05",
"bookingCode":"O",
"departure":"SIN",
"departureDate":"2022-04-23",
"departureTime":"06:00",
"flightNum":"980"
}
]
}
}
}2.
{
"authentication": {
"partnerId":"partnerId",
"sign":"sign"
},
"pricing": {
"adults": 1,
"children": 0,
"ancillary": [
2
],
"solutionId": "1",
"journeys": {
"journey_0": [
{
"airline":"TR",
"arrival":"HKG",
"arrivalDate":"2022-04-23",
"arrivalTime":"10:05",
"bookingCode":"O",
"departure":"SIN",
"departureDate":"2022-04-23",
"departureTime":"06:00",
"flightNum":"980"
}
]
}
}
}{
"authentication": {
"partnerId":"partnerId",
"sign":"sign"
},
"pricing": {
"adults": 1,
"children": 0,
"ancillary": [
1
],
"solutionId": "1",
"journeys": {
"journey_0": [
{
"airline":"TR",
"arrival":"HKG",
"arrivalDate":"2022-04-23",
"arrivalTime":"10:05",
"bookingCode":"O",
"departure":"SIN",
"departureDate":"2022-04-23",
"departureTime":"06:00",
"flightNum":"980"
}
],
"journey_1": [
{
"airline":"TR",
"arrival":"SIN",
"arrivalDate":"2022-04-25",
"arrivalTime":"14:50",
"bookingCode":"W",
"departure":"HKG",
"departureDate":"2022-04-25",
"departureTime":"10:55",
"flightNum":"981"
}
]
}
}
}4.
{
"authentication": {
"sign": "sign",
"partnerId": "partnerId"
},
"pricing": {
"journeys": {
"journey_1": [
{
"departureTime": "09:20",
"flightNum": "625",
"arrival": "SGN",
"arrivalTime": "10:45",
"bookingCode": "S",
"departure": "DAD",
"departureDate": "2023-12-10",
"airline": "VJ",
"arrivalDate": "2023-12-10"
},
{
"departureTime": "19:00",
"flightNum": "895",
"arrival": "DEL",
"arrivalTime": "22:50",
"bookingCode": "S",
"departure": "SGN",
"departureDate": "2023-12-10",
"airline": "VJ",
"arrivalDate": "2023-12-10"
}
],
"journey_0": [
{
"departureTime": "00:05",
"flightNum": "896",
"arrival": "SGN",
"arrivalTime": "06:20",
"bookingCode": "I",
"departure": "DEL",
"departureDate": "2023-11-30",
"airline": "VJ",
"arrivalDate": "2023-11-30"
},
{
"departureTime": "17:20",
"flightNum": "632",
"arrival": "DAD",
"arrivalTime": "18:35",
"bookingCode": "I",
"departure": "SGN",
"departureDate": "2023-11-30",
"airline": "VJ",
"arrivalDate": "2023-11-30"
}
]
},
"children": "1",
"solutionId": "1",
"adults": "2",
"ancillary": [
1,
2
]
}
}5. Open Jaw (Search Baggage)
{
"authentication": {
"partnerId":"partnerId",
"sign":"sign"
},
"pricing": {
"adults": 1,
"children": 0,
"ancillary": [
1
],
"solutionId": "1",
"journeys": {
"journey_0": [
{
"airline":"TR",
"arrival":"HKG",
"arrivalDate":"2022-04-23",
"arrivalTime":"10:05",
"bookingCode":"O",
"departure":"SIN",
"departureDate":"2022-04-23",
"departureTime":"06:00",
"flightNum":"980"
}
],
"journey_1": [
{
"airline":"TR",
"arrival":"CNX",
"arrivalDate":"2022-04-25",
"arrivalTime":"14:50",
"bookingCode":"W",
"departure":"HKG",
"departureDate":"2022-04-25",
"departureTime":"10:55",
"flightNum":"981"
}
]
}
}
}6.
{
"authentication": {
"sign": "sign",
"partnerId": "partnerId"
},
"pricing": {
"airOrderNum": "917049521951368301",
"ancillary": [
1
]
}
}Error Code List
| errorCode | errorMsg | Description |
|---|---|---|
| 0 | ok | Request has been processed successfully. |
| S001 | System error | System error. |
| P001 | XXX is illegal | Parameter is illegal. |
| P002 | XXX is missing | Parameter is missing. |
| P006 | Invalid parameter | Wrong parameter, please check. |
| B002 | Partner is not exists | Partner ID does not exist. |
| B003 | Illegal sign | Illegal sign, please check your signature. |
| 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. AncillaryPricing has to be invoked within 30 minutes after pricing. |
| B009 | Order status is invalid | air order status doesn't meet the requirement. |
| B010 | The order was not found. | The air order number was not correct. |
| B069 | AncillaryPricing is offline-1 | The AncillaryPricing API is offline, please contact PKFARE to enable it. |
| B070 | No ancillary price on this routing | No ancillary price for this routing. |
| B085 | The journey infomation of AncillaryPricing is not consistent with that of air order | The journey infomation of AncillaryPricing is not correct |
| B086 | The number of ancillary passenger type outnumbers that of air order. | The number of ancillary passenger type is not correct. |
Request
Body Params application/json
Request Code Samples
Responses
Modified at 2025-04-24 04:10:18