HaloSync
Production(3.1.0)
  • Sandbox(3.1.0)
  • Production(3.1.0)
HomeLunaAlbus
HomeLunaAlbus
Production(3.1.0)
  • Sandbox(3.1.0)
  • Production(3.1.0)
  1. Release Notes
  • Overview
  • Release Notes
    • PolarHub Release Note
    • Luna Release Note
    • Albus Release Note
  • Get Started
    • What is HaloSync?
    • Supported Airlines
    • PolarHub Credential
  • Airline Integration Guide
    • Carrier Support Matrix
    • Operational Notes
  • PolarHub API
    • 🔑 Transaction ID Guidelines
    • 🔐 Authentication: HMAC Guide
    • AirShopping
    • OfferPrice
    • OrderCreate
    • OrderRetrieve
    • ServiceList
    • SeatAvailability
    • OrderChange
    • OrderReshop
    • OrderQuote
    • OrderCancel
  • Support & Contact
    • General FAQ
    • Contact (Integration & Support)
  • PolarHub Errors&Troubleshooting
    • Common Error Codes
  • Schemas
    • 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
      • OrderChangeRQ
      • AirShoppingRS
      • OrderReshopRS
      • AirShoppingRQ
      • OfferPriceRQ
      • OfferPriceRS
      • OrderCreateRQ
      • OrderViewRS
      • SeatAvailabilityRQ
      • SeatAvailabilityRS
      • ServiceListRQ
      • ServiceListRS
      • OrderRetrieveRQ
      • OrderReshopRQ
      • OrderQuoteRQ
      • OrderCancelRQ
      • OrderCancelRS
    • PolarHub Schema 2025.7
      • comm
        • ResponseParameterType
        • TravelAgencyType
        • OriginDestType
        • PaxCodeType
        • CriteriaType
        • ResultMessageType
        • DataListsType
        • OrderOfferType
        • OfferType
        • OfferItemInfoType
        • PaxType
        • PaymentType
        • ContactInfoType
        • OrderViewOrderType
        • OfferType_Extend
      • OrderChangeRQ
      • AirShoppingRS
      • OfferPriceRS
      • OrderViewRS
      • SeatAvailabilityRS
      • ServiceListRS
      • OrderReshopRS
      • OrderCancelRS
      • OrderCancelRQ
      • OrderQuoteRQ
      • OfferPriceRQ
      • AirShoppingRQ
      • OrderCreateRQ
      • SeatAvailabilityRQ
      • OrderRetrieveRQ
      • OrderReshopRQ
      • ServiceListRQ
  1. Release Notes

PolarHub Release Note

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 2025-11-10 08:40:49
Previous
Release Notes
Next
Luna Release Note
Built with