HaloSync
Sandbox
  • Sandbox
  • Production
Home
LunaAlbus
Home
LunaAlbus
Sandbox
  • Sandbox
  • Production
Sandbox
  • Sandbox
  • Production
  1. Release Notes
  • HaloSync Portal
  • Getting Started
    • About HaloSync
    • Supported Airlines & Onboarding
  • Product Guides
    • Luna User Guide
      • Login
      • Main Screen & Lists
      • Booking & Ticketing
      • Booking Cancellation
      • PNR Detail
      • Booking Change
      • Ancillary Services
      • User Management
  • Integration with PolarHub
    • 🔐 Authentication: HMAC Guide
    • Integration Errors & Troubleshooting
    • 🔑 Transaction ID Guidelines
    • Carrier Support Matrix
    • AirShopping
    • OfferPrice
    • OrderCreate
    • OrderRetrieve
    • ServiceList
    • SeatAvailability
    • OrderChange
    • OrderReshop
    • OrderQuote
    • OrderCancel
    • OrderChangeNotif
  • Operations & Support
    • Airline Operational Notes
    • FAQ & Contact
  • Release Notes
    • PolarHub Release Note
    • Albus Release Note
    • Luna Release Note
  • Schemas
    • PolarHub Schema 2026.2
      • comm
        • PayerType
        • TravelAgencyType
        • ResponseParameterType
        • OrderViewOrderType
        • OfferType
        • OfferType_Extend
        • PaymentType
        • OriginDestType
        • PaxCodeType
        • CriteriaType
        • ResultMessageType
        • DataListsType
        • OrderOfferType
        • OfferItemInfoType
        • PaxType
        • ContactInfoType
      • OrderViewRS
      • AirShoppingRS
      • OfferPriceRS
      • OrderReshopRS
      • OrderCreateRQ
      • OrderChangeRQ
      • SeatAvailabilityRS
      • ServiceListRS
      • OrderCancelRS
      • OrderCancelRQ
      • OrderQuoteRQ
      • OfferPriceRQ
      • AirShoppingRQ
      • SeatAvailabilityRQ
      • OrderRetrieveRQ
      • OrderReshopRQ
      • ServiceListRQ
      • OrderChangeNotif
      • Acknowledgement
    • PolarHub Schema 2026.3
      • comm
        • TravelAgencyType
        • ResponseParameterType
        • OrderViewOrderType
        • OfferType
        • OfferType_Extend
        • PaymentType
        • OriginDestType
        • PaxCodeType
        • CriteriaType
        • ResultMessageType
        • DataListsType
        • OrderOfferType
        • OfferItemInfoType
        • PaxType
        • ContactInfoType
        • PayerType
      • AirShoppingRS
      • OrderViewRS
      • OfferPriceRS
      • OrderReshopRS
      • OrderCreateRQ
      • OrderChangeRQ
      • SeatAvailabilityRS
      • ServiceListRS
      • OrderCancelRS
      • OrderCancelRQ
      • OrderQuoteRQ
      • OfferPriceRQ
      • AirShoppingRQ
      • SeatAvailabilityRQ
      • OrderRetrieveRQ
      • OrderReshopRQ
      • ServiceListRQ
      • OrderChangeNotif
      • Acknowledgement
    • PolarHub Schema 2026.1
      • comm
        • TravelAgencyType
        • ResponseParameterType
        • OrderViewOrderType
        • OfferType
        • OfferType_Extend
        • PaymentType
        • OriginDestType
        • PaxCodeType
        • CriteriaType
        • ResultMessageType
        • DataListsType
        • OrderOfferType
        • OfferItemInfoType
        • PaxType
        • ContactInfoType
      • OrderViewRS
      • AirShoppingRS
      • OfferPriceRS
      • OrderReshopRS
      • OrderCreateRQ
      • OrderChangeRQ
      • SeatAvailabilityRS
      • ServiceListRS
      • OrderCancelRS
      • OrderCancelRQ
      • OrderQuoteRQ
      • OfferPriceRQ
      • AirShoppingRQ
      • SeatAvailabilityRQ
      • OrderRetrieveRQ
      • OrderReshopRQ
      • ServiceListRQ
    • PolarHub Schema 2025.9
      • Acknowledgement
      • OrderChangeNotif
    • PolarHub Schema 2025.7
      • comm
        • TravelAgencyType
        • ResponseParameterType
        • OrderViewOrderType
        • OfferType
        • OfferType_Extend
        • PaymentType
        • OriginDestType
        • PaxCodeType
        • CriteriaType
        • ResultMessageType
        • DataListsType
        • OrderOfferType
        • OfferItemInfoType
        • PaxType
        • ContactInfoType
      • OrderViewRS
      • AirShoppingRS
      • OfferPriceRS
      • OrderReshopRS
      • OrderCreateRQ
      • OrderChangeRQ
      • SeatAvailabilityRS
      • ServiceListRS
      • OrderCancelRS
      • OrderCancelRQ
      • OrderQuoteRQ
      • OfferPriceRQ
      • AirShoppingRQ
      • SeatAvailabilityRQ
      • OrderRetrieveRQ
      • OrderReshopRQ
      • ServiceListRQ
    • PolarHub Schema 2025.6
      • comm
        • RequestOfferItemType
        • RequestOrderItemType
        • OrderServicingDeleteType
        • TravelAgencyType
        • OriginDestType
        • PaxCodeType
        • CriteriaType
        • ResponseParameterType
        • ResultMessageType
        • DataListsType
        • OrderOfferType
        • OfferType
        • OfferItemInfoType
        • PaxType
        • PaymentType
        • ContactInfoType
        • OrderViewOrderType
        • OfferType_Extend
      • AirShoppingRQ
      • AirShoppingRS
      • OfferPriceRQ
      • OfferPriceRS
      • OrderCreateRQ
      • OrderViewRS
      • SeatAvailabilityRQ
      • SeatAvailabilityRS
      • ServiceListRQ
      • ServiceListRS
      • OrderRetrieveRQ
      • OrderReshopRQ
      • OrderQuoteRQ
      • OrderReshopRS
      • OrderCancelRQ
      • OrderCancelRS
      • OrderChangeRQ
    • PolarHub Schema 2025.3
      • comm
        • TravelAgencyType
        • OriginDestType
        • PaxCodeType
        • CriteriaType
        • ResponseParameterType
        • ResultMessageType
        • DataListsType
        • OrderOfferType
        • OfferType
        • OfferItemInfoType
        • PaxType
        • PaymentType
        • ContactInfoType
        • OrderViewOrderType
        • OfferType_Extend
      • AirShoppingRQ
      • AirShoppingRS
      • OfferPriceRQ
      • OfferPriceRS
      • OrderCreateRQ
      • OrderViewRS
      • SeatAvailabilityRQ
      • SeatAvailabilityRS
      • ServiceListRQ
      • ServiceListRS
      • OrderRetrieveRQ
      • OrderReshopRQ
      • OrderQuoteRQ
      • OrderReshopRS
      • OrderCancelRQ
      • OrderCancelRS
      • OrderChangeRQ
  1. Release Notes

PolarHub Release Note

2026/03/11 Production Release 3.5.0#

Release Notes Details
Current release version
3.5.0
Production release date
2026/03/11
Schema version change
Yes ( Current schema version : 2026.3 )

🚀 Changes
Support upsell option in OfferPriceRQ
Enable upsell option in OfferPriceRQ to retrieve additional upsell offers in OfferPriceRS based on the selected offer.
Request
OfferPriceRQ with upsell option
IncludeUpsellOffersInd set to true to request additional upsell offers in OfferPriceRS.
Response
OfferPriceRS returns the requested Offer with additional upsell Offers, if available.
Impacted Service: OfferPrice
🗒️ Special Notes :
1.
Not supported : AS, EK, HA, TR
2.
TK supports upsell offers only under a specific Offer Flow configuration.
Please contact us separately to enable upsell support.
📑 Schema Updates
💡
PolarHub V2: 2026.3 [PolarHub v2 Schema]
Add PricingParameter/IncludeUpsellOffersInd schema in OfferPriceRQ
Description
Add PricingParameter/IncludeUpsellOffersInd schema in OfferPriceRQ.
Type : boolean
XPath - OfferPriceRQ
OfferPriceRQ/Query/ResponseParameter/PricingParameter/IncludeUpsellOffersInd
Add OtherOffers schema in OfferPriceRS
Description
Add OtherOffers schema in OfferPriceRS
Type : Object
XPath - OfferPriceRS
OfferPriceRS/OtherOffers

2026/02/19 Production Release 3.4.0#

Release Notes Details
Current release version
3.4.0
Production release date
2026/02/19
Schema version change
No ( Current schema version : 2026.2 )

🚀 Changes
Integration with the new airline AS
By integrating with the new airline AS, PolarHub V2 provides the following features.
🗒️ Special Notes :
1.
Supported PTCs: ADT, CHD, INS (INF not supported).
2.
TicketInfo is not returned immediately after ticket issuance. it becomes available only after performing OrderRetrieve a few seconds later.
3.
Held booking functionality is available only to Travel Management Companies (TMCs) handling business trips.
Booking
Instant Booking - Flights only (with FOP)
AirShoppingRQ → OfferPriceRQ → OrderCreateRQ → OrderRetrieveRQ
Delay Ticketing - Flights only (without FOP)
AirShoppingRQ → OfferPriceRQ → OrderCreateRQ
Confirm Held Booking
OrderRetrieveRQ → OrderChangeRQ
Cancel
Cancellation of a non-ticketed booking
OrderRetrieveRQ → OrderCancelRQ
VOID / Refund
Ticketed Booking VOID/Refund
OrderRetrieveRQ → OrderReshopRQ → OrderCancelRQ
Seat
Prime Booking
Seat Assignment (with FOP)
AirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → OrderCreateRQ
Post Booking (Ticketed Booking)
Assign Free Seats (without FOP)
OrderRetrieveRQ → SeatAvailabilityRQ → OrderChangeRQ
Assign Paid Seats (with FOP)
OrderRetrieveRQ → SeatAvailabilityRQ → OrderChangeRQ
Free -> Free Seat Change (without FOP)
OrderRetrieveRQ → SeatAvailabilityRQ → OrderChangeRQ
Free -> Paid Seat Change (with FOP)
OrderRetrieveRQ → SeatAvailabilityRQ → OrderChangeRQ
OCN
OrderChangeNotif → Acknowledgement
Impacted Service: AirShopping, OfferPrice, OrderCreate, OrderChange, OrderReshop, OrderCancel, OrderRetrieve, SeatAvailability, OrderChangeNotif
📑 Schema Updates
💡
PolarHub V2: 2026.2 [PolarHub v2 Schema]

2026/02/11 Production Release 3.3.0#

Release Notes Details
Current release version
3.3.0
Production release date
2026/02/11
Schema version change
Yes ( Current schema version : 2026.2 )

🚀 Changes
AFKL PNR Split
By adding support for AFKL PNR split functionality, PolarHub V2 provides the following features.
PNR Split
Post Booking (Held / Ticketed Booking)
OrderRetrieveRQ → OrderChangeRQ
Impacted Service: OrderRetrieve, OrderChange
📑 Schema Updates
💡
PolarHub V2: 2026.2 [PolarHub v2 Schema]
Add Payer schema in PaymentList
Description
Add Payer schema entry in PaymentList to send payer information.
Type : PayerType
XPath - OrderCreateRQ
OrderCreateRQ/Query/PaymentList/Payer
XPath - OrderChangeRQ
OrderChangeRQ/Query/PaymentList/Payer
XPath - OrderViewRS
OrderViewRS/DataLists/PaymentList/Payer
Add CardholderAddress schema in PaymentCardMethod
Description
Add CardholderAddress schema in PaymentCardMethod
Type : PostalAddressType
XPath - OrderCreateRQ
OrderCreateRQ/Query/PaymentList/PaymentCardMethod/CardholderAddress
XPath - OrderChangeRQ
OrderChangeRQ/Query/PaymentList/PaymentCardMethod/CardholderAddress
XPath - OrderViewRS
OrderViewRS/DataLists/PaymentList/PaymentCardMethod/CardholderAddress

2026/01/21 Sandbox Release 3.3.0#

Release Notes Details
Current release version
3.3.0
Sandbox release date
2026/01/21
Production release date
2026/02/11
Schema version change
Yes ( Current schema version : 2026.2 )

🚀 Changes
AFKL PNR Split
By adding support for AFKL PNR split functionality, PolarHub V2 provides the following features.
PNR Split
Post Booking (Held / Ticketed Booking)
OrderRetrieveRQ → OrderChangeRQ
Impacted Service: OrderRetrieve, OrderChange
📑 Schema Updates
💡
PolarHub V2: 2026.2 [PolarHub v2 Schema]
Add Payer schema in PaymentList
Description
Add Payer schema entry in PaymentList to send payer information.
Type : PayerType
XPath - OrderCreateRQ
OrderCreateRQ/Query/PaymentList/Payer
XPath - OrderChangeRQ
OrderChangeRQ/Query/PaymentList/Payer
XPath - OrderViewRS
OrderViewRS/DataLists/PaymentList/Payer
Add CardholderAddress schema in PaymentCardMethod
Description
Add CardholderAddress schema in PaymentCardMethod
Type : PostalAddressType
XPath - OrderCreateRQ
OrderCreateRQ/Query/PaymentList/PaymentCardMethod/CardholderAddress
XPath - OrderChangeRQ
OrderChangeRQ/Query/PaymentList/PaymentCardMethod/CardholderAddress
XPath - OrderViewRS
OrderViewRS/DataLists/PaymentList/PaymentCardMethod/CardholderAddress

2026/01/07 Production Release 3.2.0#

Release Notes Details
Current release version
3.2.0
Production release date
2026/01/07
Schema version change
Yes ( Current schema version : 2026.1 )

🚀 Changes
Modified BaggageAllowance schema
Description
Offers/BaggageAllowance/
Either 'PaxJourneyRefID' or 'PaxSegmentRefID' is required value.
Impacted Service: AirShoppingRS, OfferPriceRS, OrderViewRS, OrderReshopRS
Added ResultMessage/MessageDetail URL schema
Description
ResultMessage/MessageDetail/Errors, Warnings Add a URL schema entry
Impacted Service: AirShoppingRS, OfferPriceRS, OrderViewRS, OrderReshopRS, ServiceListRS, SeatAvailabilityRS, OrderCancelRS
📑 Schema Updates
💡
PolarHub V2: 2026.1 [PolarHub v2 Schema]

2025/12/10 Sandbox Release 3.2.0#

Release Notes Details
Current release version
3.2.0
Sandbox release date
2025/12/10
Production release date
2026/01/07
Schema version change
Yes ( Current schema version : 2025.7 )

🚀 Changes
Modified BaggageAllowance schema
Description
Offers/BaggageAllowance/
Either 'PaxJourneyRefID' or 'PaxSegmentRefID' is required value.
Impacted Service: AirShoppingRS, OfferPriceRS, OrderViewRS, OrderReshopRS
📑 Schema Updates
💡
PolarHub V2: 2025.7 [PolarHub v2 Schema]

2025/12/03 Sandbox Release 3.2.0#

Release Notes Details
Current release version
3.2.0
Sandbox release date
2025/12/03
Production release date
2025/12/10 (TBD)
Schema version change
No ( Current schema version : 2025.7 )

🚀 Changes
Integration with the new airline AS
By integrating with the new airline AS, PolarHub V2 provides the following features.
🗒️ Special Notes :
1.
Supported PTCs: ADT, CHD, INS (INF not supported).
2.
TicketInfo is not returned immediately after ticket issuance. it becomes available only after performing OrderRetrieve a few seconds later.
3.
Held booking functionality is available only to Travel Management Companies (TMCs) handling business trips.
Booking
Instant Booking - Flights only (with FOP)
AirShoppingRQ → OfferPriceRQ → OrderCreateRQ → OrderRetrieveRQ
Delay Ticketing - Flights only (without FOP)
AirShoppingRQ → OfferPriceRQ → OrderCreateRQ
Confirm Held Booking
OrderRetrieveRQ → OrderChangeRQ
Cancel
Cancellation of a non-ticketed booking
OrderRetrieveRQ → OrderCancelRQ
VOID / Refund
Ticketed Booking VOID/Refund
OrderRetrieveRQ → OrderReshopRQ → OrderCancelRQ
Seat
Prime Booking
Seat Assignment (with FOP)
AirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → OrderCreateRQ
Post Booking (Ticketed Booking)
Assign Free Seats (without FOP)
OrderRetrieveRQ → SeatAvailabilityRQ → OrderChangeRQ
Assign Paid Seats (with FOP)
OrderRetrieveRQ → SeatAvailabilityRQ → OrderChangeRQ
Free -> Free Seat Change (without FOP)
OrderRetrieveRQ → SeatAvailabilityRQ → OrderChangeRQ
Free -> Paid Seat Change (with FOP)
OrderRetrieveRQ → SeatAvailabilityRQ → OrderChangeRQ
OCN
OrderChangeNotif → Acknowledgement
Impacted Service: AirShopping, OfferPrice, OrderCreate, OrderChange, OrderReshop, OrderCancel, OrderRetrieve, SeatAvailability, OrderChangeNotif
📑 Schema Updates
💡
PolarHub V2: 2025.7 [PolarHub v2 Schema]

2025/11/12 Production Release 3.1.0#

Release Notes Details
Current release version
3.1.0
Production release date
2025/11/12
Schema version change
Yes ( Current schema version : 2025.7 )

🚀 Changes
Airshopping cutoff time setting
PolarHub V2 provides the following features.
🗒️ Special Notes :
1.
Specify an airline timeout when requesting an AirshoppingRQ via the CutOffTime scheme (seconds).
2.
PolarHub's cutoff time setting has higher priority over Albus setting.
Added Query/ResponseParameter/CutOffTime schema
Description
Query/ResponseParameter/CutOffTime Add Affect Schema entry.
Type : String
Impacted Service: AirShoppingRQ, OfferPriceRQ, ServiceListRQ, SeatAvailabilityRQ, OrderReshopRQ, OrderQuoteRQ
Added Sender/TravelAgency/salesBranchID schema
Description
Sender/TravelAgency/salesBranchID Add Affect Schema entry.
Type : String
Impacted Service: AirShoppingRQ, OfferPriceRQ, OrderCreateRQ, OrderRetrieveRQ, ServiceListRQ, SeatAvailabilityRQ, OrderChangeRQ, OrderReshopRQ, OrderQuoteRQ, OrderCancelRQ
📑 Schema Updates
💡
PolarHub V2: 2025.7 [PolarHub v2 Schema]

2025/11/06 Sandbox Release 3.1.0#

Release Notes Details
Current release version
3.1.0
Sandbox release date
2025/11/06
Production release date
2025/11/12
Schema version change
Yes ( Current schema version : 2025.7 )

🚀 Changes
Airshopping cutoff time setting
PolarHub V2 provides the following features.
🗒️ Special Notes :
1.
Specify an airline timeout when requesting an AirshoppingRQ via the CutOffTime scheme (seconds).
2.
PolarHub's cutoff time setting has higher priority over Albus setting.
Added Query/ResponseParameter/CutOffTime schema
Description
Query/ResponseParameter/CutOffTime Add Affect Schema entry.
Type : String
Impacted Service: AirShoppingRQ, OfferPriceRQ, ServiceListRQ, SeatAvailabilityRQ, OrderReshopRQ, OrderQuoteRQ
📑 Schema Updates
💡
PolarHub V2: 2025.7 [PolarHub v2 Schema]

2025/10/15 Sandbox Release 3.1.0#

Release Notes Details
Current release version
3.1.0
Sandbox release date
2025/10/15
Production release date
2025/11/12
Schema version change
Yes ( Current schema version : 2025.7 )

🚀 Changes
Added Sender/TravelAgency/salesBranchID schema
Description
Sender/TravelAgency/salesBranchID Add Affect Schema entry.
Type : String
Impacted Service: AirShoppingRQ, OfferPriceRQ, OrderCreateRQ, OrderRetrieveRQ, ServiceListRQ, SeatAvailabilityRQ, OrderChangeRQ, OrderReshopRQ, OrderQuoteRQ, OrderCancelRQ
📑 Schema Updates
💡
PolarHub V2: 2025.7 [PolarHub v2 Schema]

2025/10/15 Production Release 3.0.0#

Release Notes Details
Current release version
3.0.0
Production release date
2025/10/15
Schema version change
Yes ( Current schema version : 2025.6 )

🚀 Changes
Integration with the new airline TK
By integrating with the new airline TK, PolarHub V2 provides the following features.
🗒️ Special Notes :
1.
It is not possible to set INF Contact Info.
2.
When splitting a PNR before ticketing, Extend Reserve TL must be performed first.
Booking
Instant Booking - Flights only (with FOP)
AirShoppingRQ → OfferPriceRQ → OrderCreateRQ
Delay Ticketing - Flights only (without FOP)
AirShoppingRQ → OfferPriceRQ → OrderCreateRQ
Confirm Held Booking
OrderRetrieveRQ → OrderQuoteRQ → OrderChangeRQ
Cancel
Cancellation of a non-ticketed booking
OrderRetrieveRQ → OrderCancelRQ
VOID / Refund
Ticketed Booking VOID/Refund
OrderRetrieveRQ → OrderReshopRQ → OrderCancelRQ
Extend Reserve TL
PaymentTL extension (after Booking - without FOP)
OrderRetrieveRQ → OrderChangeRQ
Seat
Prime Booking
Free (with / without FOP)
AirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → OrderCreateRQ → OrderChangeRQ
Pay (with FOP)
AirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → OrderCreateRQ → OrderQuoteRQ → OrderChangeRQ
Post Booking (Held / Ticketed Booking)
Free (with / without FOP)
OrderRetrieveRQ → SeatAvailabilityRQ → OrderQuoteRQ → OrderChangeRQ
Pay (with FOP)
OrderRetrieveRQ → SeatAvailabilityRQ → OrderQuoteRQ → OrderQuoteRQ → OrderChangeRQ
Service
Prime Booking
Free (with / without FOP)
AirShoppingRQ → OfferPriceRQ → ServiceListRQ → OrderCreateRQ → OrderChangeRQ
Pay group unit Only ,
Free & Pay group unit (ALL * with FOP)
AirShoppingRQ → OfferPriceRQ → ServiceListRQ → OrderCreateRQ → OrderChangeRQ
Pay 1 unit Only,
Pay group unit & Pay 1 unit ,
Free & Pay 1 unit (ALL * with FOP)
AirShoppingRQ → OfferPriceRQ → ServiceListRQ → OrderCreateRQ → OrderQuoteRQ → OrderChangeRQ
Post Booking (Held / Ticketed Booking)
Free (with / without FOP)
OrderRetrieveRQ → ServiceListRQ → OrderChangeRQ
Pay group unit Only ,
Free & Pay group unit (ALL * with FOP)
OrderRetrieveRQ → ServiceListRQ → OrderChangeRQ
Pay 1 unit Only,
Pay group unit & Pay 1 unit ,
Free & Pay 1 unit (ALL * with FOP)
OrderRetrieveRQ → ServiceListRQ → OrderQuoteRQ → OrderChangeRQ
Service&Seat
Prime Booking
Free (with / without FOP)
AirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → ServiceListRQ → OrderCreateRQ → OrderChangeRQ
Free Seat & Pay Service group unit (with FOP)
AirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → ServiceListRQ → OrderCreateRQ → OrderChangeRQ
Free Seat & Pay Service 1 unit ,
Pay Seat & Pay Service group unit ,
Pay Seat & Pay Service 1 unit (ALL * with FOP)
AirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → ServiceListRQ → OrderQuoteRQ → OrderCreateRQ → OrderChangeRQ
Post Booking (Held / Ticketed Booking)
Free (with / without FOP)
OrderRetrieveRQ → ServiceListRQ → SeatAvailabilityRQ → OrderChangeRQ
PNR Split
Post Booking (Held / Ticketed Booking)
OrderRetrieveRQ → OrderChangeRQ
Passenger Info. Change
Post Booking (Held / Ticketed Booking)
OrderRetrieveRQ → OrderChangeRQ
OCN
OrderChangeNotif → Acknowledgement
Impacted Service: AirShopping, OfferPrice, OrderCreate, OrderChange, OrderReshop, OrderQuote, OrderCancel, OrderRetrieve, SeatAvailability, OrderChangeNotif
📑 Schema Updates
💡
PolarHub V2: 2025.6 [PolarHub v2 Schema]
AMA: 2025.1 [AMA Schema]
OrderViewRS Commission schema Type changed to array
Description
PolarHub OrderViewRS schema needs to be changed OrderViewRS/Order/OrderItem/Commission to array format
XPath - OrderViewRS
OrderViewRS/Order/OrderItem/Commission
Type : Object → Array
Impacted Service: OrderView
Added FareDetail/PenaltyAmount schema
Description
FareDetail/PenaltyAmount Add a PenaltyAmount schema entry
Type : SimpleAmountType
XPath - AirShoppingRS
AirShoppingRS/Offer/OfferItem/FareDetail/PenaltyAmount
XPath - OfferPriceRS
OfferPriceRS/PricedOffer/OfferItem/FareDetail/PenaltyAmount
XPath - OrderReshopRS
OrderReshopRS/ReshopOffers/AddOfferItem/FareDetail/PenaltyAmount
OrderReshopRS/PricedOffer/RepricedOfferItem/FareDetail/PenaltyAmount
OrderReshopRS/PricedOffer/OriginalOrderItem/FareDetail/PenaltyAmount
XPath - OrderViewRS
OrderViewRS/Order/OrderItem/FareDetail/PenaltyAmount
Impacted Service: AirShoppingRS, OfferRriceRS, OrderReshopRS, OrderViewRS
Added OrderQuoteRQ/Query/Affect schema
Description
OrderQuoteRQ/Query/Affect Add Affect Schema entry (TK Schedule Change Delete).
Type : OrderServicingDeleteType (List)
XPath - OrderQuoteRQ
OrderQuoteRQ/Query/Affect
Impacted Service: OrderQuoteRQ
Add OfferItem, OrderItem schema in SeatAvailabilityRQ, ServiceListRQ
Description
Add OfferItem, OrderItem Schema entry
When searching for TK Airlines Services, only one segmentId, one paxId can be searched.
Type : RequestOfferItemType
XPath - ServiceListRQ
ServiceListRQ/Offer/OfferItem
XPath - SeatAvailabilityRQ
SeatAvailabilityRQ/Offer/OfferItem
Type : RequestOrderItemType
XPath - ServiceListRQ
ServiceListRQ/Order/OrderItem
XPath - SeatAvailabilityRQ
SeatAvailabilityRQ/Order/OrderItem
Impacted Service: ServiceListRQ, SeatAvailabilityRQ

2025/09/10 Sandbox Release 3.0.0#

Release Notes Details
Current release version
3.0.0
Sandbox release date
2025/09/10
Production release date
2025/10/15
Schema version change
Yes ( Current schema version : 2025.6 )

🚀 Changes
Integration with the new airline TK
By integrating with the new airline TK, PolarHub V2 provides the following features.
🗒️ Special Notes :
1.
It is not possible to set INF Contact Info.
2.
When splitting a PNR before ticketing, Extend Reserve TL must be performed first.
Booking
Instant Booking - Flights only (with FOP)
AirShoppingRQ → OfferPriceRQ → OrderCreateRQ
Delay Ticketing - Flights only (without FOP)
AirShoppingRQ → OfferPriceRQ → OrderCreateRQ
Confirm Held Booking
OrderRetrieveRQ → OrderQuoteRQ → OrderChangeRQ
Cancel
Cancellation of a non-ticketed booking
OrderRetrieveRQ → OrderCancelRQ
VOID / Refund
Ticketed Booking VOID/Refund
OrderRetrieveRQ → OrderReshopRQ → OrderCancelRQ
Extend Reserve TL
PaymentTL extension (after Booking - without FOP)
OrderRetrieveRQ → OrderChangeRQ
Seat
Prime Booking
Free (with / without FOP)
AirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → OrderCreateRQ → OrderChangeRQ
Pay (with FOP)
AirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → OrderCreateRQ → OrderQuoteRQ → OrderChangeRQ
Post Booking (Held / Ticketed Booking)
Free (with / without FOP)
OrderRetrieveRQ → SeatAvailabilityRQ → OrderQuoteRQ → OrderChangeRQ
Pay (with FOP)
OrderRetrieveRQ → SeatAvailabilityRQ → OrderQuoteRQ → OrderQuoteRQ → OrderChangeRQ
Service
Prime Booking
Free (with / without FOP)
AirShoppingRQ → OfferPriceRQ → ServiceListRQ → OrderCreateRQ → OrderChangeRQ
Pay group unit Only ,
Free & Pay group unit (ALL * with FOP)
AirShoppingRQ → OfferPriceRQ → ServiceListRQ → OrderCreateRQ → OrderChangeRQ
Pay 1 unit Only,
Pay group unit & Pay 1 unit ,
Free & Pay 1 unit (ALL * with FOP)
AirShoppingRQ → OfferPriceRQ → ServiceListRQ → OrderCreateRQ → OrderQuoteRQ → OrderChangeRQ
Post Booking (Held / Ticketed Booking)
Free (with / without FOP)
OrderRetrieveRQ → ServiceListRQ → OrderChangeRQ
Pay group unit Only ,
Free & Pay group unit (ALL * with FOP)
OrderRetrieveRQ → ServiceListRQ → OrderChangeRQ
Pay 1 unit Only,
Pay group unit & Pay 1 unit ,
Free & Pay 1 unit (ALL * with FOP)
OrderRetrieveRQ → ServiceListRQ → OrderQuoteRQ → OrderChangeRQ
Service&Seat
Prime Booking
Free (with / without FOP)
AirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → ServiceListRQ → OrderCreateRQ → OrderChangeRQ
Free Seat & Pay Service group unit (with FOP)
AirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → ServiceListRQ → OrderCreateRQ → OrderChangeRQ
Free Seat & Pay Service 1 unit ,
Pay Seat & Pay Service group unit ,
Pay Seat & Pay Service 1 unit (ALL * with FOP)
AirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → ServiceListRQ → OrderQuoteRQ → OrderCreateRQ → OrderChangeRQ
Post Booking (Held / Ticketed Booking)
Free (with / without FOP)
OrderRetrieveRQ → ServiceListRQ → SeatAvailabilityRQ → OrderChangeRQ
PNR Split
Post Booking (Held / Ticketed Booking)
OrderRetrieveRQ → OrderChangeRQ
Passenger Info. Change
Post Booking (Held / Ticketed Booking)
OrderRetrieveRQ → OrderChangeRQ
OCN
OrderChangeNotif → Acknowledgement
Impacted Service: AirShopping, OfferPrice, OrderCreate, OrderChange, OrderReshop, OrderQuote, OrderCancel, OrderRetrieve, SeatAvailability, OrderChangeNotif
📑 Schema Updates
💡
PolarHub V2: 2025.6 [PolarHub v2 Schema]
AMA: 2025.1 [AMA Schema]
OrderViewRS Commission schema Type changed to array
Description
PolarHub OrderViewRS schema needs to be changed OrderViewRS/Order/OrderItem/Commission to array format
XPath - OrderViewRS
OrderViewRS/Order/OrderItem/Commission
Type : Object → Array
Impacted Service: OrderView
Added FareDetail/PenaltyAmount schema
Description
FareDetail/PenaltyAmount Add a PenaltyAmount schema entry
Type : SimpleAmountType
XPath - AirShoppingRS
AirShoppingRS/Offer/OfferItem/FareDetail/PenaltyAmount
XPath - OfferPriceRS
OfferPriceRS/PricedOffer/OfferItem/FareDetail/PenaltyAmount
XPath - OrderReshopRS
OrderReshopRS/ReshopOffers/AddOfferItem/FareDetail/PenaltyAmount
OrderReshopRS/PricedOffer/RepricedOfferItem/FareDetail/PenaltyAmount
OrderReshopRS/PricedOffer/OriginalOrderItem/FareDetail/PenaltyAmount
XPath - OrderViewRS
OrderViewRS/Order/OrderItem/FareDetail/PenaltyAmount
Impacted Service: AirShoppingRS, OfferRriceRS, OrderReshopRS, OrderViewRS
Added OrderQuoteRQ/Query/Affect schema
Description
OrderQuoteRQ/Query/Affect Add Affect Schema entry (TK Schedule Change Delete).
Type : OrderServicingDeleteType (List)
XPath - OrderQuoteRQ
OrderQuoteRQ/Query/Affect
Impacted Service: OrderQuoteRQ
Add OfferItem, OrderItem schema in SeatAvailabilityRQ, ServiceListRQ
Description
Add OfferItem, OrderItem Schema entry
When searching for TK Airlines Services, only one segmentId, one paxId can be searched.
Type : RequestOfferItemType
XPath - ServiceListRQ
ServiceListRQ/Offer/OfferItem
XPath - SeatAvailabilityRQ
SeatAvailabilityRQ/Offer/OfferItem
Type : RequestOrderItemType
XPath - ServiceListRQ
ServiceListRQ/Order/OrderItem
XPath - SeatAvailabilityRQ
SeatAvailabilityRQ/Order/OrderItem
Impacted Service: ServiceListRQ, SeatAvailabilityRQ

2025/08/13 Production Release 2.5.0#

Release Notes Details
Current release version
2.5.0
Production release date
2025/08/13
Schema Version change
No ( Current schema version : 2025.3 )

🚀 Changes
Introduction of fare search cache feature
1.
Purpose: Improve response speed and L2B ratio by controlling duplicate fare search requests.
2.
TTL: AirShoppingRS responses are cached for 2 hours.
3.
How it works
When PolarHub receives an AirShoppingRQ request, it checks for duplicate requests.
If a duplicate exists → returns cached AirShoppingRS.
If not → saves the request and calls the airline in real-time.
If a cached Offer is already used or expired → internal business logic will re-match and return proper OfferPriceRS.
Logic is controllable per airline.
4.
Workflow:AirShoppingRQ/RS → OfferPriceRQ → (Internal AirShoppingRQ/RS → Match Offer) → OfferPriceRS → OrderCreateRQ/RS
5.
Cache Flow Diagram
cacheflow.png
6.
Control Conditions:
CategoryControl ConditionExample
AirShoppingRQPer clientTSTV001
Per airlineLH
Per routeICNLHR
OfferPriceRQAirline-specific retry settingKE
Error Code (when retry setting is OFF):
50332: OfferPrice request failed due to cache control being disabled.
KE VOID/Refund restriction
If OrderCancel is requested in cases where KE VOID/Refund is not allowed, the following error will be returned:
ErrorCode: 50261
ErrorMessage: The KE Order has not been cancelled, please proceed with the manual refund process.
KE VOID/Refund Not Allowed Cases
When all coupons in ticket are not in status I or AL
When the first OriginCode is an airport in New Zealand
Impacted Service: OrderCancel
📑 Schema Updates
💡
PolarHub V2: 2025.3 [PolarHub v2 Schema]
AMA: 2025.1 [AMA Schema]
Modified at 2026-04-02 06:47:52
Previous
Release Notes
Next
Albus Release Note
Built with