AirOrderCreateV2 endpoint can be used to create a new airline reservation by specifying various parameters, such as Offer ID, Shopping Response ID, Offer Response ID, Seat Response ID, Itinerary ID, and a few more parameters.
In the context of airline reservations, a PNR (Passenger Name Record) is a unique identifier used to manage a traveller’s reservation and it contains all the information related to a particular reservation, such as the passenger’s name, flight itinerary, seat assignments, and pricing information.
Once the user specifies the necessary parameters and submits the AirOrderCreateV2 request, the system will create a new PNR to manage the reservation.
In addition to this, we can use Multiple Forms Of Payment (MFOP) with card, check, or payment gateway to order the booking confirmation for the same or different passenger types.
We also provide 3DS support for credit and debit card transactions, which acts as a additional layer of security and to reduce the risk of unauthorized charges during online transactions. The api continues to provide response without these parameters.
Schema
- Name: Provide the name for the request. This is a String value.
- ReferenceVersion: Provide the version number. This is a Numeric value.
-
Travel Agency Sender:
-
Name: Provide the name for the request. This is a String value.
-
IATA Number: Provide the IATA number for the request. This is a String value.
-
Agency ID: Provide the agency ID for the request. This is a String value.
-
Contacts: This is an Array.
- EmailContact: Provide the email contact for the request. This is a String value.
-
The Shopping Response ID is a unique identifier that is generated when a customer performs a search for flights and receives a list of available options.
This is the required field and the value will be Numeric.
The airline booking system generates an OfferResponseID to identify the specific offer. This ID is unique to that particular offer so that it is important to provide the correct numeric value to ensure that the system can identify the correct offer
This is the required field, and the value will be Numeric.
-
Tracking: Valid values are
YandN. This is a String value. -
PassengerMetadata:
-
SpecialServiceRequest: This is an Array.
-
PassengerID: This is the Passenger ID. This is a String value.
-
Origin: This is the Origin. This is a String value.
-
Destination: This is the Destination. This is a String value.
-
DepartureDateTime: This is the Departure date and time. This is a String value.
-
MarketingFlightNumber: This is the Marketing flight number. This is a Numeric value.
-
MarketingCarrier: This is the Marketing carrier. This is a String value.
-
SsrType: This is the Ssr type. This is a String value.
-
SsrCode: This is the Ssr code. This is a String value.
-
FreeText: This is the Free text. This is a String value.
-
-
-
OfferID: When a customer performs a search for flights, the airline generates a list of available offers that meet the customer’s search criteria. Each offer within that list is assigned a unique OfferID.It is important to provide the correct numeric value to ensure that the system can identify the correct offer.This is the required field, and the value will be Numeric.
-
ServiceList: This is an Array and optional field.
-
OptinalServiceId: Provide the optional service ID. This is a String value.
-
PassengerID: Provide the passenger ID. This is a String value.
-
-
Seat: This is an Array and optional field.
-
SeatId: Provide the seat ID. This is a String value.
-
PassengerID: Provide the passenger ID. This is a String value.
-
Book and Hold. If the value selected is Hold then payment has to be confirmed before confirming the order.
-
SecurePayment: This is a required field. This object is needed if 3D-Secure payment is required. (New Proposed Object for 3DS).
-
WebpushURL: This is a required field. Provide a custom endpoint URL, the response for the AirOrderCreateV2 will be supplied to this endpoint.
-
SecurePaymentVersion2: This is a required field. This object is needed if 3D-Secure payment is required.
-
DeviceDetails: This is a required field. Supply the device details in this object.
-
Method:
- challengeWindowSize: Provide the browser window size. This is a String value.
- browserUserAgent: Provide the browser being used. This is a String value.
- browserJavaEnabled: Provide whether Java is enabled in the browser or not. This is a String value. The value is either true or false.
- browserScreenHeight: Provide the screen height of the browser window. This is a String value.
- browserScreenWidth: Provide the screen width of the browser window. This is a String value.
- browserLanguage: Provide the language currently being used in the browser. This is a String value.
- ipAddress: Provide the IP address of the client system. This is a String value.
-
-
-
Payment:
This is an Array
-
Type: This is a required field. Provide the payment type. Valid values are
CardandCheque. -
Amount: This is a required field. Provide the amount. This is a Numeric value.
-
Method:
- CardCode: Provide the card code. This is a String value.
For Card Type CC possible Card Codes are AX, DC, DI, DUS, JC, MA, MC, VI.
For Card Type DC possible Card Codes are MC, RU, and VI.
-
CardNumber: Provide the card number. This is a String value.
-
SeriesCode: Provide the card number. This is a String value.
-
CardHolderName: Provide the card holder’s name. This is a String value.
-
EffectiveExpireDate: Provide the Effective date and Expiration date. This is a String value.
-
Payer:
- ContactInfoRefs:
-
Passenger: This is an Array.
Note: This is a required field. The passenger list must have at least one adult. Infant object count should be less than or equal to adult count. Total pax should be less than or eqaul to 9.
-
PassengerID: Provide the passenger ID for the request. This is a String value.
-
PTC: Valid values are
ADT,CHD, andINF. This is a String value. -
OnflyMarkup: This is an optional field. This is a String value.
-
OnflyDiscount: This is an optional field. This is a String value.
-
OnFlyPenalty: This is an optional field. This is a String value.
-
BirthDate: Provide the birth date. This is a Numeric value.
-
NameTitle: Provide the title for the given name. This is a String value. Valid values are,
- ADT/Male:
Mr - ADT/Female:
MrsandMs - CHD/Male:
Mstr - CHD/Female:
Miss - INF/Male:
Mstr - INF/Female:
Miss
- ADT/Male:
-
FirstName: Provide the first name. This is a String value.
-
MiddleName: Provide the middle name. This is a String value.
-
LastName: Provide the last name. This is a String value. .
-
Gender: Provide the gender of the passenger. Valid values are
MaleandFemale. This is a String value. -
TravelDocument: This is an Array. Provide the details of travel document. This is an optional field.
-
DocumentNumber: This is the document number of your passport. This is a String value.
-
DocumentType: This is the document type of your passport (P). This is a String value.
-
IssueDate: This is the Issue date of your passport. This is a Date value.
-
ExpiryDate: This is the Expiry date of your passport. This is a Date value. The selected date must be greater than six months after the last travel date.
-
IssuingCountry: This is the Issuing country of your passport. This is a String value.
-
-
ContactInfoRef: Provide the contact information details.
-
Nationality: Nationality of the Passenger. This is a String value (e.g., IN, CA) 2-Letter Country Code. This is an required field.
-
This is an Array. This is a required field. Provide all the contact information here.
-
ContactID: Provide the contact ID.
-
AgencyName: Provide the agency name.
-
EmailAddress: Provide the email address.
-
Phone:
-
CountryCode: Provide the country code.
-
AreaCode: Provide the area code.
-
PhoneNumber: Provide the phone number.
-
-
Mobile:
-
CountryCode: Provide the country code.
-
MobileNumber: Provide the mobile number.
-
-
Address:
- Street: This is an Array. Provide the street details.
- CityName: Provide the city name.
- StateProv: Provide the state or province name.
- PostalCode: Provide the postal code.
- CountryCode: Provide the country code.
-
PassengerContact: Provide the contact details.
-
EmailAddress: Provide your email ID. This is a String value.
-
Phone:
-
CountryCode: Provide the country code. This is a String value.
-
AreaCode: Provide the area code. This is a String value.
-
PhoneNumber: Provide the phone number. This is a Numeric value.
-
-
Payments
The Payments section contains details about the payment transactions associated with the booking.
- Payment: List of payment details.
- Type: The payment method used (e.g.,
CARD,CHECK). - Amount: The total payment amount.
- Method: Details of the payment method used.
- PaymentCard: Information related to the payment card.
- CardType: Type of card used (e.g.,
CCfor credit card,DCfor debit card). - CardCode: Card network code (e.g.,
MCfor Mastercard,VIfor Visa). - CardNumber: The card number used for payment.
- SeriesCode: The CVV/CVC security code of the card.
- CardHolderName: The name of the cardholder.
- EffectiveExpireDate: Card validity details.
- Effective: The effective start date of the card (if applicable).
- Expiration: The expiry date of the card (
YYYY-MMformat).
- CardType: Type of card used (e.g.,
- PaymentCard: Information related to the payment card.
- Payer: Information about the person making the payment.
- ContactInfoRefs: Reference ID for the payer’s contact information.
- Type: The payment method used (e.g.,
Order
The Order section provides details about the booking order and its status.
-
OrderID: Unique identifier for the booking order.
-
GdsBookingReference: The Global Distribution System (GDS) booking reference.
-
OrderStatus: The status of the Booking (e.g.,
SUCCESS,FAILED). -
PnrStatus: The status of the Passenger Name Record (PNR).
-
ScheduleChangeIndicator: Indicates whether there has been a schedule change.
true: Schedule change exists.false: No schedule change.
-
ScheduleChangeStatus: The status of the schedule change (e.g.,
Initiated,Completed). -
NeedToTicket: Indicates if ticket issuance is required.
"Y": Ticket needs to be issued."N": No ticket issuance required.
-
OptionalServiceStatus: The status of additional services (e.g., baggage, meal selection).
"SUCCESS": Additional services were processed successfully."FAILED": Additional services could not be processed.
-
SeatSelectionStatus: The status of seat selection.
"SUCCESS": Seats were selected successfully."FAILED": Seat selection was not successful.
-
OfferID: Unique identifier for the Air Itinerary.
-
Owner: Airline code of the offer provider.
-
OwnerName: Airline name.
-
TicketType: Type of ticket (e.g., Single, Round-trip).
-
IsBrandedFare: Indicates if the fare is part of a branded fare category.
-
BrandedFareOptions - List of branded fare options available for the booking (Array).
-
CabinOptions - List of available cabin options (Array).
-
IsAdditionalCabinType - Indicates whether an additional cabin type is available.
-
Eticket: Specifies if the ticket is electronic.
-
AllowHold: Indicates if the booking can be put on hold(e.g.,
YorN). -
TimeLimits: Defines expiration times for the offer.
- OfferExpirationDateTime: Time when the offer expires.
- PaymentExpirationDateTime: Deadline for payment.
-
PassportRequired: Specifies if a passport is needed for booking.
-
BookingCurrencyCode: Currency code used for booking.
-
EquivCurrencyCode : Requested Currency code for booking.
-
BookingFeeInfo : Additional transaction fees.
- FeeType : Type of the transaction fee applied.
- BookingCurrencyPrice: BookingFee Amount in the booking currency.
- EquivCurrencyPrice: BookingFee Amount in the equivalent currency.
-
TotalPrice: Total price breakdown(Base+Tax).
- BookingCurrencyPrice: Total price in the booking currency.
- EquivCurrencyPrice: Total price in the equivalent currency.
-
BasePrice: Base fare excluding taxes.
- BookingCurrencyPrice: Base price in the booking currency.
- EquivCurrencyPrice: Base price in the equivalent currency.
-
TaxPrice: Tax fare from the airline
- BookingCurrencyPrice: Tax price in the booking currency.
- EquivCurrencyPrice: Tax price in the equivalent currency.
-
Commission: Commission details.
- AgencyCommission : The commission given for the agency
- BookingCurrencyPrice:Commission in the booking currency.
- EquivCurrencyPrice: Commission in the equivalent currency.
- AgencyYqCommission : : The commission given for the YQ tax fare.
- BookingCurrencyPrice: Commission in the booking currency.
- EquivCurrencyPrice: Commission in the equivalent currency.
- AgencyCommission : The commission given for the agency
-
PortalCharges : Defines additional charges applied to the booking(Portal level).
- Markup: Extra charges added to the booking..
- BookingCurrencyPrice: Markup amount in the booking currency.
- EquivCurrencyPrice: Markup amount in the equivalent currency.
- Surcharge: Additional service fees.
- BookingCurrencyPrice: Surcharge in the booking currency.
- EquivCurrencyPrice:Surcharge in the equivalent currency.
- Discount: Reduction in ticket price, either as a percentage or fixed amount.
- BookingCurrencyPrice: Discount Amount in the booking currency.
- EquivCurrencyPrice: Discount Amount in the equivalent currency.
- Markup: Extra charges added to the booking..
-
AgentMarkupInfo : The amount given in the Booking Process.
- OnflyMarkup: Represents markup charges applied to the booking.
- BookingCurrencyPrice: The price in the booking currency.
- EquivCurrencyPrice: The price in the requested currency.
- OnflyDiscount: Discounts applied on the booking.
- BookingCurrencyPrice: Discount in booking currency.
- EquivCurrencyPrice: Discount in requested currency.
- OnflyHst: Harmonized Sales Tax (HST) applied.
- BookingCurrencyPrice: Tax amount in booking currency.
- EquivCurrencyPrice: Tax amount in requested currency.
- PromoDiscount: Promo discount details.
- BookingCurrencyPrice: Promo discount in booking currency.
- EquivCurrencyPrice: Promo discount in requested currency.
- PromoCode: The applied promotional code (if any).
- OnflyMarkup: Represents markup charges applied to the booking.
-
Penalty: Fees for changes or cancellations.
- ChangeFee:Represents the fee charged for modifying a booking.
- Before: Change fee applicable before the specified deadline.
- BookingCurrencyPrice: Change fee in the booking currency. (
NAmeans no fee specified) - EquivCurrencyPrice: Change fee in the equivalent currency.(
NAmeans no fee specified)
- BookingCurrencyPrice: Change fee in the booking currency. (
- After:Change fee applicable after the specified deadline.
- BookingCurrencyPrice: Change fee in the booking currency.(
NAmeans no fee specified) - EquivCurrencyPrice: Change fee in the equivalent currency. (
NAmeans no fee specified)
- BookingCurrencyPrice: Change fee in the booking currency.(
- Before: Change fee applicable before the specified deadline.
- CancelationFee: Represents the fee charged for cancelling a booking.
- Before: Cancellation fee applicable before the specified deadline.
- BookingCurrencyPrice: Cancellation fee in the booking currency. (
NAmeans no fee specified) - EquivCurrencyPrice: Cancellation fee in the equivalent currency.(
NAmeans no fee specified)
- BookingCurrencyPrice: Cancellation fee in the booking currency. (
- After: Cancellation fee applicable after the specified deadline.
- BookingCurrencyPrice: Cancellation fee in the booking currency.(
NAmeans no fee specified) - EquivCurrencyPrice: Cancellation fee in the equivalent currency. (
NAmeans no fee specified)
- BookingCurrencyPrice: Cancellation fee in the booking currency.(
- Before: Cancellation fee applicable before the specified deadline.
- ChangeFee:Represents the fee charged for modifying a booking.
-
OfferItem: Contains pricing and service details.
- OfferItemID: Unique identifier for the offer item.
- Refundable: Indicates whether the offer is refundable (
trueorfalse). - PassengerType: Passenger type (e.g.,
ADTfor adult,CHDfor child). - PassengerQuantity: Number of passengers for this offer.
- TotalPriceDetail: Contains total price details of the offer.
- TotalAmount: Total amount including all charges.
- BookingCurrencyPrice: Price in booking currency.
- EquivCurrencyPrice: Price in equivalent currency.
- TotalAmount: Total amount including all charges.
- Service: List of additional services linked to the offer.
- ServiceID: Unique identifier for the service.
- PassengerRefs: References the passenger receiving the service.
- FlightRefs: References the flight linked to this service.where you can find the flight details from the FlightList by mapping this FlightRefs Key.
-
FareDetail: Contains price breakdown, taxes, and commissions.
- PassengerRefs: References the passenger for the fare details.
- Price: Price details.
- TotalAmount: Total amount including all charges.
- BookingCurrencyPrice: Price in booking currency.
- EquivCurrencyPrice: Price in equivalent currency.
- BaseAmount: The base fare price.
- BookingCurrencyPrice: Price in booking currency.
- EquivCurrencyPrice: Price in equivalent currency.
- TaxAmount: Total taxes applied.
- BookingCurrencyPrice: Tax price in booking currency.
- EquivCurrencyPrice: Tax price in equivalent currency.
- Commission: Commission details.
- AgencyCommission: Agency Commission details.
- BookingCurrencyPrice: Commission amount in booking currency.
- EquivCurrencyPrice: Commission amount in equivalent currency.
- AgencyYqCommission: Additional agency commission.
- BookingCurrencyPrice: Commission amount in booking currency.
- EquivCurrencyPrice: Commission amount in equivalent currency.
- AgencyCommission: Agency Commission details.
- BookingFee: Additional transaction fees.
- BookingCurrencyPrice: Fee amount in booking currency.
- EquivCurrencyPrice: Fee amount in equivalent currency.
- PortalCharges: Defines additional charges applied to the booking(portal level).
- Markup: Extra charges added to the booking.
- BookingCurrencyPrice: Markup amount in booking currency.
- EquivCurrencyPrice: Markup amount in equivalent currency.
- Surcharge: Additional service fees.
- BookingCurrencyPrice: Surcharge amount in booking currency.
- EquivCurrencyPrice: Surcharge amount in equivalent currency.
- Discount: Price reductions applied.
- BookingCurrencyPrice: Discount amount in booking currency.
- EquivCurrencyPrice: Discount amount in equivalent currency.
- Markup: Extra charges added to the booking.
- TotalAmount: Total amount including all charges.
-
Taxes: List of individual taxes applied.
- TaxCode: Code identifying the type of tax.
- BookingCurrencyPrice: Tax amount in booking currency.
- EquivCurrencyPrice: Tax amount in equivalent currency.
-
FareComponent: Describes the fare class, booking class, and cabin type for each segment.
- PriceClassRef: References the price class.
- SegmentRefs: References flight segments.
- FareBasis: Details about fare basis codes
- FareBasisCode: Code representing the fare basis.
- Refs: Reference codes. where you can see the details in FareList by mapping this code
- Code: Fare basis code for each code.
- RBD: Reservation booking designator.This code is used to identify the specific booking class of a flight
- CabinType: Cabin class (e.g.,
Y: ECONOMY,S: PREM ECONOMY,C: BUSINESS,D: PREMBUSINESS,F: FIRSTCLASS, andP: PREMFIRSTCLASS). - SeatLeft: Number of available seats.
- FareBasisCode: Code representing the fare basis.
-
OfferItemID - Unique identifier for each service offer item.
-
Service - Contains passenger and segment references.
- PassengerRefs: Identifies the passenger eligible for the service.
- SegmentRefs: Identifies the flight segment applicable to the service.
-
Price - Contains pricing details for the service.
- Total: Total amount including all charges.
- BookingCurrencyPrice: Price in booking currency.
- EquivCurrencyPrice: Price in equivalent currency.
- Base: The base fare price.
- BookingCurrencyPrice: Price in booking currency.
- EquivCurrencyPrice: Price in equivalent currency.
- Tax: Total taxes applied.
- BookingCurrencyPrice: Tax price in booking currency.
- EquivCurrencyPrice: Tax price in equivalent currency.
- Total: Total amount including all charges.
-
ServiceDefinitionRef - Reference to the service definition, linking the offer item to a specific service type (e.g., baggage, seat selection).
-
DataLists - Contains structured lists of relevant entities.
-
PassengerList - List of Passenger details
-
Passengers - contains the passengers details(Array of objects)
- PassengerID: Unique identifier for the passenger.
- PTC: Passenger Type Code.
- OnflyMarkup: Markup amount applied.
- OnflyDiscount: Discount amount applied.
- BirthDate: Passenger’s date of birth.
- NameTitle: Title of the passenger (Mr/Ms/etc.).
- FirstName: First name.
- MiddleName: Middle name (if any).
- LastName: Last name.
- Gender: Passenger’s gender.
- TravelDocument Passport details of the passenger(Array of objects)
- DocumentNumber: Passport or travel document number.
- DocumentType: Type of travel document (e.g., Passport “P”).
- IssueDate: Issue date of the document.
- ExpiryDate: Expiration date of the document.
- IssuingCountry: Country that issued the document.
- ContactInfoRef: Reference to the contact information.
- attributes: Additional attributes related to the passenger.
- Nationality: Nationality of the passenger (e.g., IN, CA) 2-Letter Country.
DisclosureList
- Disclosures: An array containing disclosure-related information (empty in this response).
FareList
-
FareGroup (Array of objects)
- FareGroupRef: Reference to the fare group.
- FareCode: Code representing the fare.
- FareBasisCode: Basis code for the fare.
-
FlightSegmentList: Contains a list of flight segments.
- FlightSegment: Array of individual flight segment details.
- SegmentKey: Unique identifier for the flight segment.
- Departure: Contains details of the departure location and time.
- AirportCode: IATA code of the departure airport.
- Date: Departure date in
YYYY-MM-DDformat. - Time: Departure time in
HH:MM:SSformat. - AirportName: Full name of the departure airport.
- Terminal: Terminal details.
- Name: Terminal number (if applicable).
- Arrival: Contains details of the arrival location and time.
- AirportCode: IATA code of the arrival airport.
- Date: Arrival date in
YYYY-MM-DDformat. - Time: Arrival time in
HH:MM:SSformat. - AirportName: Full name of the arrival airport.
- Terminal: Terminal details.
- Name: Terminal name or number (if applicable).
- MarketingCarrier: The airline that sells the flight.
- AirlineID: Airline IATA code.
- Name: Name of the airline.
- FlightNumber: The flight number assigned by the marketing carrier.
- OperatingCarrier: The airline that actually operates the flight.
- AirlineID: Airline IATA code.
- Name: Name of the airline.
- FlightNumber: The flight number assigned by the operating carrier.
- Equipment: Aircraft information.
- AircraftCode: Aircraft type code.
- Name: Aircraft model name.
- Code: Additional flight segment-related codes.
- MarriageGroup: Grouping information for married flight segments.
- FlightDetail: Additional flight-related details.
- FlightDuration: Total flight duration.
- Value: Duration in
H Mformat.
- Value: Duration in
- Stops: Number of stops in the flight segment.
- Value: Number of stops.
- InterMediate: List of intermediate stops (if applicable).
- AirMilesFlown: Total miles flown for the segment.
- FlightDuration: Total flight duration.
- BrandId: Brand associated with the flight segment.
- FlightSegment: Array of individual flight segment details.
-
FlightList: Lists complete flight journeys.
- FlightKey: Identifier for the flight.
- Journey: Total time and number of stops.
- SegmentReferences: List of segments that form the journey.
-
OriginDestinationList: Defines the travel routes.
- OriginDestination: Origin and destination pair.
- OriginDestinationKey: Unique key for the origin-destination pair.
- DepartureCode: IATA airport code for departure.
- ArrivalCode: IATA airport code for arrival.
- FlightReferences: Flights available for this route.
- OriginDestination: Origin and destination pair.
-
PriceClassList: Lists price classes.
- PriceClass: Defines pricing categories.
- PriceClassID: Unique identifier for the price class.
- Name: Name of the price class.
- Code: Code associated with the price class.
- PriceClass: Defines pricing categories.
-
BaggageAllowanceList: Contains baggage allowance details.
- BaggageAllowance: Baggage policy for a segment.
- BaggageAllowanceID: Unique ID for baggage rule.
- BaggageCategory: Type of baggage (e.g., Checked).
- AllowanceDescription: Explanation of baggage allowance.
- PieceAllowance: Number of baggage pieces allowed.
- BaggageAllowance: Baggage policy for a segment.
-
ServiceDefinitionList
-
ServiceDefinition (Array of objects)
- ServiceDefinitionID: Unique identifier for the service.
- ServiceType: Type of service (e.g., BAG for baggage services).
- ServiceCode: Service code.
- ServiceName: Name of the service.
FopList (Form of Payment List)
- CC (Credit Card)
- Allowed: Whether credit cards are allowed (Y/N).
- Types
- AX, MC, VI, etc.: Different credit card types.
- F: Booking currency price.
- P: Payment amount.
- AX, MC, VI, etc.: Different credit card types.
- DC (Debit Card)
- Allowed: Whether debit cards are allowed.
- Types
- MC, VI, RU, etc.: Different debit card types.
- F: Booking currency price.
- P: Payment amount.
- MC, VI, RU, etc.: Different debit card types.
- CASH: Whether cash payment is allowed.
- CHEQUE: Whether cheque payment is allowed.
- ACH: Whether ACH (Automated Clearing House) payment is allowed.
- PG: Whether payment gateway is allowed.
- FopKey: Unique identifier for the form of payment.
MetaData
- MetaData: Reserved for additional metadata (currently empty).
Request URL
curl --location --request POST 'https://newapi.tltid.com/AirOrderCreateV2' \
--header 'x-api-key: <your key here>' \
--header 'Authorization: <YOUR_ACCESS_TOKEN>' \
--header 'Accept-Encoding: gzip, deflate, br'\
Request Body Sample
{
"OrderCreateRQ": {
"Document": {
"Name": "test portal",
"ReferenceVersion": "1.0"
},
"Party": {
"Sender": {
"TravelAgencySender": {
"Name": "test agency",
"IATA_Number": "",
"AgencyID": "",
"Contacts": {
"Contact": [
{
"EmailContact": "test@email.com"
}
]
}
}
}
},
"ShoppingResponseId": "1678884980680630342",
"OfferResponseId": "1678885043771812579",
"SeatResponseId": "1678885123663146513",
"ServiceListResponseId": "1678885102048509620",
"MetaData": {
"Tracking": "Y",
"PassengerMetadata": {
"SpecialServiceRequest": []
}
},
"Query": {
"Order": {
"Offer": [
{
"OfferID": "137211721101678884984951212459"
}
],
"ServiceList": [
{
"OptinalServiceId": "1678885110745738541",
"PassengerID": "ADT1"
}
],
"Seat": [
{
"SeatId": "1678885127063445420",
"PassengerID": "ADT1"
}
]
}
},
"BookingType": "BOOK",
"PromoCode": "",
"PromoDiscount": 0,
"threeDs_required": "false",
"PartnerCode": "",
"PartnerClickID": "",
"BookingReqId": "DA7798F6",
"Platform": "",
"SiteBrand": "",
"LowCostCarrierType": true,
"BookingSource": "",
"Payments": {
"SecurePayment": {
"WebpushURL": ""https://caller_domain/../api_endpoint"",
"SecurePaymentVersion2": {
"DeviceDetails": {
"challengeWindowSize": "03",
"browserUserAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.132 Safari/537.36",
"browserJavaEnabled": "true",
"browserScreenHeight": "1000",
"browserScreenWidth": "1920",
"browserLanguage": "en-GB",
"ipAddress": "11.22.333.444"
}
}
},
"Payment": [
{
"Type": "CARD",
"Amount": 298.2,
"Method": {
"PaymentCard": {
"CardType": "CC",
"CardCode": "MC",
"CardNumber": "5299920210000277",
"SeriesCode": "411",
"CardHolderName": "Priya",
"EffectiveExpireDate": {
"Effective": "",
"Expiration": "2024-05"
}
}
},
"Payer": {
"ContactInfoRefs": "CTC1"
}
}
]
},
"DataLists": {
"PassengerList": {
"Passenger": [
{
"PassengerID": "ADT1",
"PTC": "ADT",
"OnflyMarkup": "0.00",
"OnflyDiscount": "0.00",
"BirthDate": "2000-07-21",
"NameTitle": "Mr",
"FirstName": "downey",
"MiddleName": "",
"LastName": "Robert",
"Gender": "Male",
"TravelDocument": [
{
"DocumentNumber": "9658745",
"DocumentType": "P",
"IssueDate": "2015-01-01",
"ExpiryDate": "2024-01-01",
"IssuingCountry": "CA"
}
],
"ContactInfoRef": "CTC1",
"Nationality": "CA"
}
]
},
"ContactList": {
"ContactInformation": [
{
"ContactID": "CTC1",
"AgencyName": "kathir",
"EmailAddress": "kathir@gmail.com",
"Phone": {
"ContryCode": "+91",
"AreaCode": "",
"PhoneNumber": "9854785465"
},
"Mobile": {
"ContryCode": "+91",
"MobileNumber": "9854785465"
},
"Address": {
"Street": [
"kovil Street",
null
],
"CityName": "chennai",
"StateProv": "AX",
"PostalCode": "600028",
"CountryCode": "CA"
},
"PassengerContact": {
"EmailAddress": "mosris@gmail.com",
"Phone": {
"ContryCode": "",
"AreaCode": "",
"PhoneNumber": "9856325698"
}
}
}
]
}
}
}
}
Response Sample
{
"OrderViewRS": {
"Document": {
"Name": "API GATEWAY",
"ReferenceVersion": "1.2"
},
"Party": {
"Sender": {
"TravelAgencySender": {
"Name": "Lucky Travels",
"IATA_Number": "",
"AgencyID": "",
"Contacts": {
"Contact": [
{
"EmailContact": "pst@claritytts.com"
}
]
}
}
}
},
"ShoppingResponseId": "1678884980680630342",
"Success": {},
"Payments": {
"Payment": [
{
"Type": "CARD",
"Amount": 298.2,
"Method": {
"PaymentCard": {
"CardType": "CC",
"CardCode": "MC",
"CardNumber": "5299920210000277",
"SeriesCode": "411",
"CardHolderName": "Priya",
"EffectiveExpireDate": {
"Effective": "",
"Expiration": "2024-05"
}
}
},
"Payer": {
"ContactInfoRefs": "CTC1"
}
}
]
},
"Order": [
{
"OrderID": "BLW764U6",
"GdsBookingReference": "NELGSX",
"OrderStatus": "SUCCESS",
"NeedToTicket": "N",
"OptionalServiceStatus": "SUCCESS",
"OfferID": "137211721101678884984951212459",
"Owner": "WS",
"OwnerName": "Westjet",
"IsBrandedFare": "N",
"BrandedFareOptions": [],
"CabinOptions": [],
"IsAdditionalCabinType": "N",
"Eticket": "true",
"TimeLimits": {
"OfferExpirationDateTime": "2023-03-15T15:01:19",
"PaymentExpirationDateTime": "2023-03-16 12:57:00"
},
"BookingCurrencyCode": "CAD",
"EquivCurrencyCode": "CAD",
"HstPercentage": "",
"RewardSettings": {
"RewardAvailable": "N",
"PointTypes": [],
"PointValues": {}
},
"BookingFeeInfo": {
"FeeType": "AIF",
"BookingCurrencyPrice": 15,
"EquivCurrencyPrice": 15
},
"TotalPrice": {
"BookingCurrencyPrice": 232.35,
"EquivCurrencyPrice": 232.35
},
"BasePrice": {
"BookingCurrencyPrice": 195,
"EquivCurrencyPrice": 195
},
"TaxPrice": {
"BookingCurrencyPrice": 37.35,
"EquivCurrencyPrice": 37.35
},
"Commission": {
"AgencyCommission": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"AgencyYqCommission": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"PortalCharges": {
"Markup": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Surcharge": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Discount": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"AgentMarkupInfo": {
"OnflyMarkup": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"OnflyDiscount": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"OnflyHst": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"PromoDiscount": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0,
"PromoCode": ""
}
},
"Penalty": {
"ChangeFee": {
"Before": {
"BookingCurrencyPrice": "NA",
"EquivCurrencyPrice": "NA"
},
"After": {
"BookingCurrencyPrice": "NA",
"EquivCurrencyPrice": "NA"
}
},
"CancelationFee": {
"Before": {
"BookingCurrencyPrice": "NA",
"EquivCurrencyPrice": "NA"
},
"After": {
"BookingCurrencyPrice": "NA",
"EquivCurrencyPrice": "NA"
}
}
},
"PaxSeatInfo": [
{
"SeatNumber": "04A",
"SegmentNumber": 1,
"Origin": "YKF",
"Destination": "YYC",
"PaxRef": "ADT1",
"Status": "HRS"
}
],
"OfferItem": [
{
"OfferItemID": "OFFERITEMID1",
"Refundable": false,
"PassengerType": "ADT",
"PassengerQuantity": 1,
"TotalPriceDetail": {
"TotalAmount": {
"BookingCurrencyPrice": 232.35,
"EquivCurrencyPrice": 232.35
}
},
"Service": [
{
"ServiceID": "SV1",
"PassengerRefs": "ADT1",
"FlightRefs": "Flight1"
}
],
"FareDetail": {
"PassengerRefs": "ADT1",
"Price": {
"TotalAmount": {
"BookingCurrencyPrice": 232.35,
"EquivCurrencyPrice": 232.35
},
"BaseAmount": {
"BookingCurrencyPrice": 195,
"EquivCurrencyPrice": 195
},
"TaxAmount": {
"BookingCurrencyPrice": 37.35,
"EquivCurrencyPrice": 37.35
},
"Commission": {
"AgencyCommission": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"AgencyYqCommission": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"BookingFee": {
"BookingCurrencyPrice": 15,
"EquivCurrencyPrice": 15
},
"PortalCharges": {
"Markup": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Surcharge": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Discount": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"Taxes": [
{
"TaxCode": "RC",
"BookingCurrencyPrice": 15.23,
"EquivCurrencyPrice": 15.23
},
{
"TaxCode": "SQ",
"BookingCurrencyPrice": 15,
"EquivCurrencyPrice": 15
},
{
"TaxCode": "CA",
"BookingCurrencyPrice": 7.12,
"EquivCurrencyPrice": 7.12
}
]
}
},
"FareComponent": [
{
"PriceClassRef": "PCR_1",
"SegmentRefs": "Segment1 Segment2",
"FareBasis": {
"FareBasisCode": {
"Refs": "FG_1 FG_1",
"Code": "ACUD0ZBJ ACUD0ZBJ"
},
"RBD": "A A",
"CabinType": "Y Y",
"SeatLeft": "9 1"
}
}
]
},
{
"OfferItemID": "SRV-OfferItem-1",
"Service": {
"PassengerRefs": "ADT1",
"SegmentRefs": "Segment1"
},
"Price": {
"Base": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Tax": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Total": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"ServiceDefinitionRef": "SRV-1"
},
{
"OfferItemID": "SRV-OfferItem-2",
"Service": {
"PassengerRefs": "ADT1",
"SegmentRefs": "Segment2"
},
"Price": {
"Base": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Tax": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Total": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"ServiceDefinitionRef": "SRV-1"
},
{
"OfferItemID": "SRV-OfferItem-3",
"Service": {
"PassengerRefs": "ADT1",
"SegmentRefs": "Segment1"
},
"Price": {
"Base": {
"BookingCurrencyPrice": 30,
"EquivCurrencyPrice": 30
},
"Tax": {
"BookingCurrencyPrice": 3.8999999999999986,
"EquivCurrencyPrice": 3.8999999999999986
},
"Total": {
"BookingCurrencyPrice": 33.9,
"EquivCurrencyPrice": 33.9
}
},
"ServiceDefinitionRef": "SRV-2"
},
{
"OfferItemID": "SRV-OfferItem-4",
"Service": {
"PassengerRefs": "ADT1",
"SegmentRefs": "Segment2"
},
"Price": {
"Base": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Tax": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Total": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"ServiceDefinitionRef": "SRV-2"
},
{
"OfferItemID": "SRV-OfferItem-5",
"Service": {
"PassengerRefs": "ADT1",
"SegmentRefs": "Segment1"
},
"Price": {
"Base": {
"BookingCurrencyPrice": 50,
"EquivCurrencyPrice": 50
},
"Tax": {
"BookingCurrencyPrice": 6.5,
"EquivCurrencyPrice": 6.5
},
"Total": {
"BookingCurrencyPrice": 56.5,
"EquivCurrencyPrice": 56.5
}
},
"ServiceDefinitionRef": "SRV-3"
},
{
"OfferItemID": "SRV-OfferItem-6",
"Service": {
"PassengerRefs": "ADT1",
"SegmentRefs": "Segment2"
},
"Price": {
"Base": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Tax": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"Total": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
}
},
"ServiceDefinitionRef": "SRV-3"
}
],
"BaggageAllowance": [
{
"SegmentRefs": "Segment1 Segment2",
"PassengerRefs": "ADT1",
"BaggageAllowanceRef": "Bag1"
}
],
"SplitPaymentInfo": [
{
"AirItineraryId": "137211721101678884984951212459",
"MultipleFop": "Y",
"MaxCardsPerPax": 2,
"MaxCardsPerPaxInMFOP": 1
}
],
"BookingToEquivExRate": 1,
"FopRef": "FOP_429_0_1172_0_ALL_PUB"
}
],
"DataLists": {
"PassengerList": {
"Passengers": [
{
"PassengerID": "ADT1",
"PTC": "ADT",
"OnflyMarkup": "0.00",
"OnflyDiscount": "0.00",
"BirthDate": "2000-07-21",
"NameTitle": "Mr",
"FirstName": "downey",
"MiddleName": "",
"LastName": "Robert",
"Gender": "Male",
"TravelDocument": [
{
"DocumentNumber": "9658745",
"DocumentType": "P",
"IssueDate": "2015-01-01",
"ExpiryDate": "2024-01-01",
"IssuingCountry": "CA"
}
],
"ContactInfoRef": "CTC1",
"attributes": {
"PassengerID": "ADT1"
},
"PassengerRefID": "ADT1"
"Nationality": "CA"
}
]
},
"DisclosureList": {
"Disclosures": []
},
"FareList": {
"FareGroup": [
{
"FareGroupRef": "FG_1",
"FareCode": "70J",
"FareBasisCode": "ACUD0ZBJ"
}
]
},
"FlightSegmentList": {
"FlightSegment": [
{
"SegmentKey": "Segment1",
"Departure": {
"AirportCode": "YKF",
"Date": "2023-05-20",
"Time": "16:25:00",
"AirportName": "Waterloo Airport",
"Terminal": {
"Name": ""
}
},
"Arrival": {
"AirportCode": "YYC",
"Date": "2023-05-20",
"Time": "18:30:00",
"AirportName": "Calgary International Airport",
"Terminal": {
"Name": ""
}
},
"MarketingCarrier": {
"AirlineID": "WS",
"Name": "Westjet",
"FlightNumber": "557"
},
"OperatingCarrier": {
"AirlineID": "WS",
"Name": "Westjet",
"FlightNumber": "557"
},
"Equipment": {
"AircraftCode": "73W",
"Name": "73W"
},
"Code": {
"MarriageGroup": "O"
},
"FlightDetail": {
"FlightDuration": {
"Value": "4 H 5 M"
},
"Stops": {
"Value": ""
},
"InterMediate": [],
"AirMilesFlown": 1646
},
"BrandId": "BASIC"
},
{
"SegmentKey": "Segment2",
"Departure": {
"AirportCode": "YYC",
"Date": "2023-05-20",
"Time": "20:00:00",
"AirportName": "Calgary International Airport",
"Terminal": {
"Name": ""
}
},
"Arrival": {
"AirportCode": "YVR",
"Date": "2023-05-20",
"Time": "20:32:00",
"AirportName": "Vancouver International Airport",
"Terminal": {
"Name": "M"
}
},
"MarketingCarrier": {
"AirlineID": "WS",
"Name": "Westjet",
"FlightNumber": "66"
},
"OperatingCarrier": {
"AirlineID": "WS",
"Name": "Westjet",
"FlightNumber": "66"
},
"Equipment": {
"AircraftCode": "7M8",
"Name": "7M8"
},
"Code": {
"MarriageGroup": "I"
},
"FlightDetail": {
"FlightDuration": {
"Value": "1 H 32 M"
},
"Stops": {
"Value": ""
},
"InterMediate": [],
"AirMilesFlown": 428
},
"BrandId": "BASIC"
}
]
},
"FlightList": {
"Flight": [
{
"FlightKey": "Flight1",
"Journey": {
"Time": "7 H 7 M",
"Stops": 1
},
"SegmentReferences": "Segment1 Segment2"
}
]
},
"OriginDestinationList": {
"OriginDestination": [
{
"OriginDestinationKey": "OD1",
"DepartureCode": "YKF",
"ArrivalCode": "YVR",
"FlightReferences": "Flight1"
}
]
},
"PriceClassList": {
"PriceClass": [
{
"PriceClassID": "PCR_1",
"Name": "",
"Code": "",
"Descriptions": {
"Description": []
}
}
]
},
"BaggageAllowanceList": {
"BaggageAllowance": [
{
"BaggageAllowanceID": "Bag1",
"BaggageCategory": "Checked",
"AllowanceDescription": {
"ApplicableParty": "Traveler",
"Description": "CHECKED ALLOWANCE"
},
"PieceAllowance": {
"ApplicableParty": "Traveler",
"TotalQuantity": "0",
"Unit": "kg"
}
}
]
},
"ServiceDefinitionList": {
"ServiceDefinition": [
{
"ServiceDefinitionID": "SRV-1",
"ServiceType": "BAG",
"ServiceCode": "ASSISTIVE DEVICE",
"ServiceName": "ASSISTIVE DEVICE"
},
{
"ServiceDefinitionID": "SRV-2",
"ServiceType": "BAG",
"ServiceCode": "FIRST CHARGEABLE BAG_ASVC",
"ServiceName": "FIRST CHARGEABLE BAG"
},
{
"ServiceDefinitionID": "SRV-3",
"ServiceType": "BAG",
"ServiceCode": "SECOND CHARGEABLE BAG_ASVC",
"ServiceName": "SECOND CHARGEABLE BAG"
}
]
},
"FopList": [
{
"CC": {
"Allowed": "Y",
"Types": {
"AX": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0
},
"MC": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0
},
"VI": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0
},
"JC": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0
},
"DC": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0
},
"DUS": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0
},
"MA": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0
},
"DS": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0
},
"TP": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0
}
}
},
"DC": {
"Allowed": "Y",
"Types": {
"MC": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0
},
"VI": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0
},
"RU": {
"F": {
"BookingCurrencyPrice": 0,
"EquivCurrencyPrice": 0
},
"P": 0
}
}
},
"CASH": {
"Allowed": "N",
"Types": {}
},
"CHEQUE": {
"Allowed": "Y",
"Types": {}
},
"ACH": {
"Allowed": "Y",
"Types": {}
},
"PG": {
"Allowed": "N",
"Types": {}
},
"FopKey": "FOP_1341_0_1987_0_ALL_PRI"
}
]
},
"MetaData": {}
}
}
Reprice Response
When the order creation attempt fails during booking (for example, the selected booking class is no longer available at the confirmed price), the Reprice flow is automatically triggered. The response returns the original OrderViewRS error alongside an AllPricedOfferRS envelope that lists alternative priced offers the traveller can rebook against.
Note: This response is only returned when the reprice flow is successfully triggered after a booking failure. If the order is created successfully, only the standard OrderViewRS block with the confirmed order is returned.
Reprice Response Schema
Echoes the original OrderCreate result. When reprice is triggered, this block always carries the booking failure that caused the reprice.
-
Document:
- Name: Name of the responding system. This is a String value.
- ReferenceVersion: Response schema version. This is a String value.
-
Party.Sender.TravelAgencySender: Agency details echoed from the request.
- Name, IATA_Number, AgencyID: String values.
- Contacts.Contact[].EmailContact: String value.
-
ShoppingResponseId: The shopping session ID that produced the original offer. This is a String value.
-
OfferResponseId: The priced offer response ID against which the order was attempted. Empty string when the failure occurs before an offer response is bound. This is a String value.
-
Errors.Error: The booking failure that triggered the reprice flow.
- ShortText: Short label for the error (for example, Order View Error). This is a String value.
- Code: Numeric error code (for example, 109). This is a Numeric value.
- Value: Human-readable description of the failure. This is a String value.
Container for the reprice results. It groups the alternatives into three mutually exclusive buckets so the client can decide which fallback to offer the traveller before retrying AirOrderCreateV2.
-
ShoppingResponseId: The shopping session ID that the reprice was performed against. This is a String value.
-
SameFlightOptions: A repriced offer for the same itinerary and same booking class as originally selected, at a revised total price. Empty object ({}) when this fallback is not available.
-
DifferentBookingClassOptions: An Array of repriced offers for the same itinerary in a different booking class (RBD). Empty array when this fallback is not available.
-
DifferentFlightOptions: Repriced offers on alternate itineraries (different flights, different dates, or different carriers). See OffersGroup below.
-
Warnings: An Array of advisory messages. Each entry indicates a bucket that came back empty — for example, “Same Flight Option Not availbale” or “DifferentBookingClass Options Not availbale”.
Each entry in OffersGroup is a complete OfferPriceRS payload for one alternate priced offer. Clients should treat each entry as an independently bookable option — retry AirOrderCreateV2 with the chosen OfferID and its ShoppingResponseId.
-
OfferPriceRS.Success: Empty object confirming the alternate offer priced cleanly.
-
OfferPriceRS.PricedOffer: An Array. Each priced offer contains:
- OfferID: Unique identifier for the alternate offer. Use this when placing the order. This is a String value.
- Owner / OwnerName: Airline code and name that owns the offer.
- IsBrandedFare: Y or N. Whether the offer is a branded fare.
- InstantTicket: Y or N. Whether the offer supports instant ticketing.
- Eticket: true or false. E-ticket eligibility.
- AllowHold: Y or N. Whether the offer can be held without payment.
- TimeLimits:
- OfferExpirationDateTime: ISO datetime — offer must be booked before this. This is a String value.
- PaymentExpirationDateTime: Deadline for payment. This is a String value.
- PassportRequired: Y or N.
- BookingCurrencyCode / EquivCurrencyCode: ISO 4217 currency codes.
- BookingFeeInfo: Booking fee applied to the offer.
- FeeType: For example, AIF. This is a String value.
- BookingCurrencyPrice / EquivCurrencyPrice: Numeric values.
- TotalPrice, BasePrice, TaxPrice: Aggregate pricing across all passengers. Each has BookingCurrencyPrice and EquivCurrencyPrice.
- Commission: Agency and YQ commission blocks.
- PortalCharges: Markup, Surcharge, Discount — portal-side adjustments.
- Penalty:
- ChangeFee.Before / ChangeFee.After: Change fee before and after departure.
- CancelationFee.Before / CancelationFee.After: Cancellation fee before and after departure.
- OfferItem: An Array, one entry per passenger type.
- OfferItemID: Unique item ID (for example, OFFERITEMID1). This is a String value.
- Refundable: true or false. This is a Boolean value.
- PassengerType: ADT, CHD, or INF. This is a String value.
- PassengerQuantity: Number of passengers of this type. This is a Numeric value.
- TotalPriceDetail.TotalAmount: Per-passenger-type total.
- Service: Links the offer item to passengers and flight segments (PassengerRefs, FlightRefs).
- FareDetail: Full price breakdown — TotalAmount, BaseAmount, TaxAmount, Commission, BookingFee, PortalCharges, and Taxes[] (each with TaxCode, BookingCurrencyPrice, EquivCurrencyPrice).
- FareComponent: Segment-level fare basis — PriceClassRef, SegmentRefs, FareBasis (FareBasisCode, RBD, CabinType, SeatLeft).
- BaggageAllowance: An Array mapping passengers to segments and baggage allowance references.
- SplitPaymentInfo: Payment split configuration for the itinerary.
- BookingToEquivExRate: Exchange rate between booking and equivalent currencies. This is a Numeric value.
- FopRef: Reference key into DataLists.FopList for allowed forms of payment. This is a String value.
- RescheduleAllowed, PaxWiseVoidAllowed, PostSeatAllowed, PostAncillaryAllowed: Y or N flags describing post-booking capabilities.
-
OfferPriceRS.DataLists: Reference data for the alternate offer. Contains AirShoppingRS with:
- PassengerList.Passengers[]: Passenger IDs, PTC, name, birth date, gender, and ContactInfoRef.
- FareList.FareGroup[]: FareGroupRef, FareCode, FareBasisCode.
- FlightSegmentList.FlightSegment[]: Departure/Arrival airports and times, Marketing and Operating carrier, Equipment, MarriageGroup, and FlightDetail (duration, stops).
- FlightList.Flight[]: FlightKey, Journey.Time, Journey.Stops, SegmentReferences.
- OriginDestinationList.OriginDestination[]: OriginDestinationKey, DepartureCode, ArrivalCode, FlightReferences.
- PriceClassList.PriceClass[]: Branded fare / price class metadata.
- BaggageAllowanceList.BaggageAllowance[]: BaggageAllowanceID, BaggageCategory, AllowanceDescription, PieceAllowance.
- FopList[]: Allowed forms of payment (CC, DC, CASH, CHEQUE, ACH, PG, VCC) with per-type surcharge/fee structures, keyed by FopKey.
Reprice Response Sample
{
"OrderViewRS": {
"Document": {
"Name": "Skyroute B2B Portal",
"ReferenceVersion": "1.0"
},
"Party": {
"Sender": {
"TravelAgencySender": {
"Name": "Skyroute B2B",
"IATA_Number": "1111111111",
"AgencyID": "1111111111",
"Contacts": {
"Contact": [
{ "EmailContact": "pst@claritytts.com" }
]
}
}
}
},
"ShoppingResponseId": "1783346319740454268",
"OfferResponseId": "",
"Errors": {
"Error": {
"ShortText": "Order View Error",
"Code": 109,
"Value": "Unable to confirm availability for the selected booking class at this moment"
}
}
},
"AllPricedOfferRS": {
"ShoppingResponseId": "1783346319740454268",
"SameFlightOptions": {},
"DifferentBookingClassOptions": [],
"DifferentFlightOptions": {
"OffersGroup": [
{
"OfferPriceRS": {
"Success": {},
"OfferResponseId": "1783346419676169296",
"PricedOffer": [
{
"OfferID": "3973247511783346333584571633",
"Owner": "QR",
"OwnerName": "Qatar Airways",
"AllowHold": "Y",
"TimeLimits": {
"OfferExpirationDateTime": "2026-07-06T21:30:25",
"PaymentExpirationDateTime": "2026-07-7 07:00:00"
},
"BookingCurrencyCode": "CAD",
"TotalPrice": { "BookingCurrencyPrice": 2302.18, "EquivCurrencyPrice": 2302.18 },
"BasePrice": { "BookingCurrencyPrice": 1423.38, "EquivCurrencyPrice": 1423.38 },
"TaxPrice": { "BookingCurrencyPrice": 878.8, "EquivCurrencyPrice": 878.8 }
}
]
}
}
]
},
"Warnings": [
{ "Message": "Same Flight Option Not availbale" },
{ "Message": "DifferentBookingClass Options Not availbale" }
]
}
}
Client integration tip: Inspect Warnings[] first to know which buckets are empty, then iterate DifferentFlightOptions.OffersGroup[] to surface the alternate itineraries. Use each PricedOffer.OfferID (and its ShoppingResponseId) when retrying AirOrderCreateV2 to book the fallback.