PolarHub Release Note
2026/08/06 Sandbox Release 4.2.0
Release Notes Details
QR change/refund penalty — minimum amount now provided
For Qatar Airways (QR, NDC 18.1), change/refund penalties were previously provided as the maximum amount only. From this release, the minimum amount is provided together with the maximum, so the penalty range (min ~ max) is conveyed accurately.Detail.Amounts array now includes an additional entry with AmountApplication = "MIN", in addition to the existing "MAX".2026/07/27 Production Release 4.1.0
Release Notes Details
New credit card (FOP CC) payment support
PolarHub now supports credit-card payment (Form of Payment = Credit Card).Before using 3DS2 credit card payment — prerequisites & flow
PrerequisitesRequest schema & carrier field mapping
Card body (PaymentCard) — required (all payment types)| Field | Description | Example |
|---|---|---|
CardNumber | Card number (PAN) | 4149xxxxxxxxxxxx |
SeriesCode | Security code (CVC/CVV) | 123 |
CardCode | Card brand | VI / CA / AX / DC / JC |
EffectiveExpireDate/Expiration | Expiry date (MMYY) | 0128 |
CardHolderName | Cardholder name | KIM MIN SU |
PayerName/IndividualName/Surname & GivenName | Payer name | — |
PayerPhoneNumber/CountryDialingCode & AreaCode & PhoneNumber | Payer phone number | — |
CardholderAddress/Street & PostalCode & CityName & CountrySubdivisionName & CountryCode | Billing address (incl. country code) | — |
PaymentCard → SecurePaymentVersion2) — SQ / TR only| Field | Description | Example | Status |
|---|---|---|---|
AuthenticationValue | 3DS cryptogram (CAVV/AAV, base64) | S8v1+GGi… | existing |
ElectronicCommerceInd | Electronic Commerce Indicator (ECI) | 05 | existing |
DirectoryServerTrxID | Directory Server Transaction ID | (UUID) | existing |
TrxStatusText | Authentication status (Y / A / N) | Y | existing |
AuthenticationTokenValue | Authentication token | — | existing |
PaymentTrxChannelCode | Transaction channel | EC | existing |
ProgramProtocolText | 3DS protocol version | 2.2.0 | new |
TrxStatusText = N(authentication failed) → payment is declined.
2026/07/24 Sandbox Release 4.1.0
Release Notes Details
New credit card (FOP CC) payment support
PolarHub now supports credit-card payment (Form of Payment = Credit Card).Before using 3DS2 credit card payment — prerequisites & flow
PrerequisitesRequest schema & carrier field mapping
Card body (PaymentCard) — required (all payment types)| Field | Description | Example |
|---|---|---|
CardNumber | Card number (PAN) | 4149xxxxxxxxxxxx |
SeriesCode | Security code (CVC/CVV) | 123 |
CardCode | Card brand | VI / CA / AX / DC / JC |
EffectiveExpireDate/Expiration | Expiry date (MMYY) | 0128 |
CardHolderName | Cardholder name | KIM MIN SU |
PayerName/IndividualName/Surname & GivenName | Payer name | — |
PayerPhoneNumber/CountryDialingCode & AreaCode & PhoneNumber | Payer phone number | — |
CardholderAddress/Street & PostalCode & CityName & CountrySubdivisionName & CountryCode | Billing address (incl. country code) | — |
PaymentCard → SecurePaymentVersion2) — SQ / TR only| Field | Description | Example | Status |
|---|---|---|---|
AuthenticationValue | 3DS cryptogram (CAVV/AAV, base64) | S8v1+GGi… | existing |
ElectronicCommerceInd | Electronic Commerce Indicator (ECI) | 05 | existing |
DirectoryServerTrxID | Directory Server Transaction ID | (UUID) | existing |
TrxStatusText | Authentication status (Y / A / N) | Y | existing |
AuthenticationTokenValue | Authentication token | — | existing |
PaymentTrxChannelCode | Transaction channel | EC | existing |
ProgramProtocolText | 3DS protocol version | 2.2.0 | new |
TrxStatusText = N(authentication failed) → payment is declined.
2026/06/10 Production Release 4.0.0
Release Notes Details
Replace SiteCode with SalesBranchID across all PolarHub APIs
The SiteCode request parameter has been removed platform-wide and replaced by SalesBranchID. This applies to every PolarHub API, not a single endpoint. Schedule-level lowest-fare curation that was previously keyed by SiteCode is now keyed by SalesBranchID.1.After the production cutover (2026/06/10), requests carrying the legacy SiteCodefield will be rejected. Clients must complete migration toSalesBranchIDbefore then.2.SalesBranchIDaccepts values01–99. The value00is reserved for Luna internal use and must not be sent by external clients.3.Requests sent without SalesBranchIDwill not receive lowest-fare-applied offers for carriers that rely on this lookup. The field is effectively required for tenants that depend on lowest-fare curation.
SiteCodeSalesBranchID (replaces SiteCode in the same position of the request body)SiteCode to SalesBranchID.SalesBranchID → carrier lowest-fare mapping is currently provisioned by Halo&Co on request.2026.2 to 2026.5. SiteCode is no longer present in 2026.5.SiteCode in request payloads with SalesBranchID.01–99 and is not 00.2026/05/27 Sandbox Release 4.0.0
Release Notes Details
Replace SiteCode with SalesBranchID across all PolarHub APIs
The SiteCode request parameter has been removed platform-wide and replaced by SalesBranchID. This applies to every PolarHub API, not a single endpoint. Schedule-level lowest-fare curation that was previously keyed by SiteCode is now keyed by SalesBranchID.1.After the production cutover (2026/06/10), requests carrying the legacy SiteCodefield will be rejected. Clients must complete migration toSalesBranchIDbefore then.2.SalesBranchIDaccepts values01–99. The value00is reserved for Luna internal use and must not be sent by external clients.3.Requests sent without SalesBranchIDwill not receive lowest-fare-applied offers for carriers that rely on this lookup. The field is effectively required for tenants that depend on lowest-fare curation.
SiteCodeSalesBranchID (replaces SiteCode in the same position of the request body)SiteCode to SalesBranchID.SalesBranchID → carrier lowest-fare mapping is currently provisioned by Halo&Co on request.2026.2 to 2026.5. SiteCode is no longer present in 2026.5.SiteCode in request payloads with SalesBranchID.01–99 and is not 00.2026/05/11 Production Release 3.6.0
Release Notes Details
Introduce AirShoppingPlus endpoint
AirShoppingPlus is a new path for the NDC AirShopping operation. It exposes the same request schema and response shape as the Default endpoint, while applying response-side enhancements beforedelivery.
1.Both the Default ( POST /hub/polarpie/v2/airShopping) and AirShoppingPlus (POST /exp/polarhub/v2/airshopping) endpoints continue to be supported in parallel. The Default
contract is unchanged.2.The importance profile used by AirShoppingPlus is managed centrally by PolarHub. No tenant-side configuration is required.
POST /exp/polarhub/v2/airshoppingpotential.
2026/05/11 Sandbox Release 3.4.0
Release Notes Details
Introduce AirShoppingPlus endpoint
AirShoppingPlus is a new path for the NDC AirShopping operation. It exposes the same request schema and response shape as the Default endpoint, while applying response-side enhancements beforedelivery.
1.Both the Default ( POST /hub/polarpie/v2/airShopping) and AirShoppingPlus (POST /exp/polarhub/v2/airshopping) endpoints continue to be supported in parallel. The Default
contract is unchanged.2.The importance profile used by AirShoppingPlus is managed centrally by PolarHub. No tenant-side configuration is required.
POST /exp/polarhub/v2/airshoppingpotential.
2026/03/11 Production Release 3.5.0
Release Notes Details
Support upsell option in OfferPriceRQ
Enable upsell option in OfferPriceRQ to retrieve additional upsell offers in OfferPriceRS based on the selected offer.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.
2026/02/19 Production Release 3.4.0
Release Notes Details
Integration with the new airline AS
By integrating with the new airline AS, PolarHub V2 provides the following features.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.
AirShoppingRQ → OfferPriceRQ → OrderCreateRQ → OrderRetrieveRQAirShoppingRQ → OfferPriceRQ → OrderCreateRQOrderRetrieveRQ → OrderChangeRQOrderRetrieveRQ → OrderCancelRQOrderRetrieveRQ → OrderReshopRQ → OrderCancelRQAirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → OrderCreateRQOrderRetrieveRQ → SeatAvailabilityRQ → OrderChangeRQOrderRetrieveRQ → SeatAvailabilityRQ → OrderChangeRQOrderRetrieveRQ → SeatAvailabilityRQ → OrderChangeRQOrderRetrieveRQ → SeatAvailabilityRQ → OrderChangeRQOrderChangeNotif → Acknowledgement2026/02/11 Production Release 3.3.0
Release Notes Details
AFKL PNR Split
By adding support for AFKL PNR split functionality, PolarHub V2 provides the following features.OrderRetrieveRQ → OrderChangeRQAdd Payer schema in PaymentList
PayerTypeAdd CardholderAddress schema in PaymentCardMethod
PostalAddressType2026/01/21 Sandbox Release 3.3.0
Release Notes Details
AFKL PNR Split
By adding support for AFKL PNR split functionality, PolarHub V2 provides the following features.OrderRetrieveRQ → OrderChangeRQAdd Payer schema in PaymentList
PayerTypeAdd CardholderAddress schema in PaymentCardMethod
PostalAddressType2026/01/07 Production Release 3.2.0
Release Notes Details
Modified BaggageAllowance schema
Either 'PaxJourneyRefID' or 'PaxSegmentRefID' is required value.
Added ResultMessage/MessageDetail URL schema
2025/12/10 Sandbox Release 3.2.0
2025/12/03 Sandbox Release 3.2.0
Release Notes Details
Integration with the new airline AS
By integrating with the new airline AS, PolarHub V2 provides the following features.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.
AirShoppingRQ → OfferPriceRQ → OrderCreateRQ → OrderRetrieveRQAirShoppingRQ → OfferPriceRQ → OrderCreateRQOrderRetrieveRQ → OrderChangeRQOrderRetrieveRQ → OrderCancelRQOrderRetrieveRQ → OrderReshopRQ → OrderCancelRQAirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → OrderCreateRQOrderRetrieveRQ → SeatAvailabilityRQ → OrderChangeRQOrderRetrieveRQ → SeatAvailabilityRQ → OrderChangeRQOrderRetrieveRQ → SeatAvailabilityRQ → OrderChangeRQOrderRetrieveRQ → SeatAvailabilityRQ → OrderChangeRQOrderChangeNotif → Acknowledgement2025/11/12 Production Release 3.1.0
Release Notes Details
Airshopping cutoff time setting
PolarHub V2 provides the following features.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
StringAdded Sender/TravelAgency/salesBranchID schema
String2025/11/06 Sandbox Release 3.1.0
Release Notes Details
Airshopping cutoff time setting
PolarHub V2 provides the following features.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
String2025/10/15 Sandbox Release 3.1.0
Release Notes Details
Added Sender/TravelAgency/salesBranchID schema
String2025/10/15 Production Release 3.0.0
Release Notes Details
Integration with the new airline TK
By integrating with the new airline TK, PolarHub V2 provides the following features.1.It is not possible to set INF Contact Info. 2.When splitting a PNR before ticketing, Extend Reserve TL must be performed first.
AirShoppingRQ → OfferPriceRQ → OrderCreateRQAirShoppingRQ → OfferPriceRQ → OrderCreateRQOrderRetrieveRQ → OrderQuoteRQ → OrderChangeRQOrderRetrieveRQ → OrderCancelRQOrderRetrieveRQ → OrderReshopRQ → OrderCancelRQOrderRetrieveRQ → OrderChangeRQAirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → OrderCreateRQ → OrderChangeRQAirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → OrderCreateRQ → OrderQuoteRQ → OrderChangeRQOrderRetrieveRQ → SeatAvailabilityRQ → OrderQuoteRQ → OrderChangeRQOrderRetrieveRQ → SeatAvailabilityRQ → OrderQuoteRQ → OrderQuoteRQ → OrderChangeRQAirShoppingRQ → OfferPriceRQ → ServiceListRQ → OrderCreateRQ → OrderChangeRQFree & Pay group unit (ALL * with FOP)
AirShoppingRQ → OfferPriceRQ → ServiceListRQ → OrderCreateRQ → OrderChangeRQPay group unit & Pay 1 unit ,
Free & Pay 1 unit (ALL * with FOP)
AirShoppingRQ → OfferPriceRQ → ServiceListRQ → OrderCreateRQ → OrderQuoteRQ → OrderChangeRQOrderRetrieveRQ → ServiceListRQ → OrderChangeRQFree & Pay group unit (ALL * with FOP)
OrderRetrieveRQ → ServiceListRQ → OrderChangeRQPay group unit & Pay 1 unit ,
Free & Pay 1 unit (ALL * with FOP)
OrderRetrieveRQ → ServiceListRQ → OrderQuoteRQ → OrderChangeRQAirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → ServiceListRQ → OrderCreateRQ → OrderChangeRQAirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → ServiceListRQ → OrderCreateRQ → OrderChangeRQPay Seat & Pay Service group unit ,
Pay Seat & Pay Service 1 unit (ALL * with FOP)
AirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → ServiceListRQ → OrderQuoteRQ → OrderCreateRQ → OrderChangeRQOrderRetrieveRQ → ServiceListRQ → SeatAvailabilityRQ → OrderChangeRQOrderRetrieveRQ → OrderChangeRQOrderRetrieveRQ → OrderChangeRQOrderChangeNotif → AcknowledgementOrderViewRS Commission schema Type changed to array
Object → ArrayAdded FareDetail/PenaltyAmount schema
SimpleAmountTypeAdded OrderQuoteRQ/Query/Affect schema
OrderServicingDeleteType (List)Add OfferItem, OrderItem schema in SeatAvailabilityRQ, ServiceListRQ
RequestOfferItemTypeRequestOrderItemType2025/09/10 Sandbox Release 3.0.0
Release Notes Details
Integration with the new airline TK
By integrating with the new airline TK, PolarHub V2 provides the following features.1.It is not possible to set INF Contact Info. 2.When splitting a PNR before ticketing, Extend Reserve TL must be performed first.
AirShoppingRQ → OfferPriceRQ → OrderCreateRQAirShoppingRQ → OfferPriceRQ → OrderCreateRQOrderRetrieveRQ → OrderQuoteRQ → OrderChangeRQOrderRetrieveRQ → OrderCancelRQOrderRetrieveRQ → OrderReshopRQ → OrderCancelRQOrderRetrieveRQ → OrderChangeRQAirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → OrderCreateRQ → OrderChangeRQAirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → OrderCreateRQ → OrderQuoteRQ → OrderChangeRQOrderRetrieveRQ → SeatAvailabilityRQ → OrderQuoteRQ → OrderChangeRQOrderRetrieveRQ → SeatAvailabilityRQ → OrderQuoteRQ → OrderQuoteRQ → OrderChangeRQAirShoppingRQ → OfferPriceRQ → ServiceListRQ → OrderCreateRQ → OrderChangeRQFree & Pay group unit (ALL * with FOP)
AirShoppingRQ → OfferPriceRQ → ServiceListRQ → OrderCreateRQ → OrderChangeRQPay group unit & Pay 1 unit ,
Free & Pay 1 unit (ALL * with FOP)
AirShoppingRQ → OfferPriceRQ → ServiceListRQ → OrderCreateRQ → OrderQuoteRQ → OrderChangeRQOrderRetrieveRQ → ServiceListRQ → OrderChangeRQFree & Pay group unit (ALL * with FOP)
OrderRetrieveRQ → ServiceListRQ → OrderChangeRQPay group unit & Pay 1 unit ,
Free & Pay 1 unit (ALL * with FOP)
OrderRetrieveRQ → ServiceListRQ → OrderQuoteRQ → OrderChangeRQAirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → ServiceListRQ → OrderCreateRQ → OrderChangeRQAirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → ServiceListRQ → OrderCreateRQ → OrderChangeRQPay Seat & Pay Service group unit ,
Pay Seat & Pay Service 1 unit (ALL * with FOP)
AirShoppingRQ → OfferPriceRQ → SeatAvailabilityRQ → ServiceListRQ → OrderQuoteRQ → OrderCreateRQ → OrderChangeRQOrderRetrieveRQ → ServiceListRQ → SeatAvailabilityRQ → OrderChangeRQOrderRetrieveRQ → OrderChangeRQOrderRetrieveRQ → OrderChangeRQOrderChangeNotif → AcknowledgementOrderViewRS Commission schema Type changed to array
Object → ArrayAdded FareDetail/PenaltyAmount schema
SimpleAmountTypeAdded OrderQuoteRQ/Query/Affect schema
OrderServicingDeleteType (List)Add OfferItem, OrderItem schema in SeatAvailabilityRQ, ServiceListRQ
RequestOfferItemTypeRequestOrderItemType2025/08/13 Production Release 2.5.0
Release Notes Details
Introduction of fare search cache feature
1.
2.
3.
4.
AirShoppingRQ/RS → OfferPriceRQ → (Internal AirShoppingRQ/RS → Match Offer) → OfferPriceRS → OrderCreateRQ/RS5.
6.
| Category | Control Condition | Example |
|---|---|---|
| AirShoppingRQ | Per client | TSTV001 |
| Per airline | LH | |
| Per route | ICNLHR | |
| OfferPriceRQ | Airline-specific retry setting | KE |
50332: OfferPrice request failed due to cache control being disabled.KE VOID/Refund restriction
50261The KE Order has not been cancelled, please proceed with the manual refund process.I or ALModified at 2026-08-11 02:15:17