HaloSync
Sandbox(3.1.0)
  • Sandbox(3.1.0)
  • Production(3.1.0)
HomeLunaAlbus
HomeLunaAlbus
Sandbox(3.1.0)
  • Sandbox(3.1.0)
  • Production(3.1.0)
  1. Airline Integration Guide
  • Overview
  • 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
  • PolarHub Errors&Troubleshooting
    • Common Error Codes
  • Release Notes
    • PolarHub Release Note
    • Albus Release Note
    • Luna Release Note
  • Support & Contact
    • General FAQ
    • Contact (Integration & Support)
  • 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
      • OrderChangeRQ
      • OrderCancelRS
      • OrderCancelRQ
      • OrderReshopRS
      • OrderQuoteRQ
      • OrderReshopRQ
      • OrderRetrieveRQ
      • ServiceListRS
      • ServiceListRQ
      • SeatAvailabilityRS
      • SeatAvailabilityRQ
      • OrderViewRS
      • OrderCreateRQ
      • OfferPriceRS
      • OfferPriceRQ
      • AirShoppingRS
      • AirShoppingRQ
    • PolarHub Schema 2025.3
      • comm
        • TravelAgencyType
        • OriginDestType
        • PaxCodeType
        • CriteriaType
        • ResponseParameterType
        • ResultMessageType
        • DataListsType
        • OrderOfferType
        • OfferType
        • OfferItemInfoType
        • PaxType
        • PaymentType
        • ContactInfoType
        • OrderViewOrderType
        • OfferType_Extend
      • AirShoppingRS
      • OrderChangeRQ
      • OrderCancelRQ
      • OfferPriceRS
      • OrderCreateRQ
      • OrderViewRS
      • SeatAvailabilityRQ
      • SeatAvailabilityRS
      • ServiceListRQ
      • ServiceListRS
      • OrderRetrieveRQ
      • OrderReshopRQ
      • OrderQuoteRQ
      • OrderReshopRS
      • OrderCancelRS
      • OfferPriceRQ
      • AirShoppingRQ
    • PolarHub Schema 2025.7
      • comm
        • TravelAgencyType
        • OriginDestType
        • PaxCodeType
        • CriteriaType
        • ResponseParameterType
        • ResultMessageType
        • DataListsType
        • OrderOfferType
        • OfferType
        • OfferItemInfoType
        • PaxType
        • PaymentType
        • ContactInfoType
        • OrderViewOrderType
        • OfferType_Extend
      • AirShoppingRS
      • OfferPriceRS
      • OrderViewRS
      • SeatAvailabilityRS
      • ServiceListRS
      • OrderReshopRS
      • OrderCancelRS
      • OrderChangeRQ
      • OrderCancelRQ
      • OrderQuoteRQ
      • OfferPriceRQ
      • AirShoppingRQ
      • OrderCreateRQ
      • SeatAvailabilityRQ
      • OrderRetrieveRQ
      • OrderReshopRQ
      • ServiceListRQ
  1. Airline Integration Guide

Operational Notes

πŸ’‘
This page offers crucial operational details and best practices for working with each airline. It includes important information on unique behaviors, specific requirements, and any known limitations to help ensure smooth and successful transactions.
The following content is subject to change by each airline. Please always confirm with the airline before applying in production.

Void & Refund Time#

All (except the airlines listed below)
VOID: Same-day cancellation (POS based)
Refund: After the same day (POS based)
πŸ“Œ
SQ: Even if the booking is created and cancelled on the same day, VOID is not allowed if the NDC booking was modified via another channel. (Even if you revert the change, once the booking has lost the VOID capability, VOID remains unavailable even when OrderReshopRS shows a full refundable amount / OrderCancel may return an error.)
TR
VOID/Refund not supported
QR
VOID: Same-day cancellation (GMT/UTC ~23:59)
Refund: After the same day (GMT/UTC)
BA
VOID: Within 24 hours after ticketing
Refund: After 24 hours
AF, KE, KL
VOID: Same-day cancellation (POS based)
Refund (no penalty): Within 24 hours after ticketing (POS based)
Refund (penalty applies): After 24 hours (POS based)
πŸ“Œ
Cases where NDC VOID/Refund is NOT allowed:
Partially used ticket, reissued ticket, involuntary refund after OCN, or region-specific refund restrictions.
Detailed conditions: when all ticket coupon statuses are not I or AL & NZ origin itineraries.
If a refund is not allowed under these conditions, Hub returns the following error in OrderCancelRS:
50261 β€” β€œThe KE Order has not been canceled, please proceed with the manual refund process.”
If a refund is not allowed, manual refund is required:
Operator manually validates the penalty amount in OrderReshopRS.
If valid, process refund via SPRK.
If issues, process manual refund via BSP Link.
Waiver for change/refund fees & ops request process:
Fee waiver: possible per the Travel Agency Involuntary Ticket Handling Guide.
Ops request: register via KE board for real-time handling (detailed process to be announced).
AY
VOID: By GMT ~22:45 (07:45 KST)
Refund (POS KR only-no penalty): From after the VOID cut-off ~ within 24 hours after ticketing
Refund (POS KR only-penalty applies): After 24 hours
πŸ“Œ
Errors may occur if attempting VOID within the allowable time window (higher likelihood within 6 hours after ticketing).
When attempting a refund, the same errors that occur during a VOID can also occur; handle them in the same way.
Errors:
"ERROR AT END OF TRANSACTION TIME: NEED TICKETING ARRANGEMENT, NEED NAME, NEED ITINERARY, NEED TELEPHONE"
"ERROR AT END OF TRANSACTION TIME: SIMULTANEOUS CHANGES TO PNR - USE WRA/RT TO PRINT OR IGNOR"
In the OrderCancel response, the above errors can appear, but the ticket is actually VOIDed and the PNR will be cancelled after some time.
PNR cancellation may take more than 24 hours (no issue report needed).
If billing occurs due to missing ticket VOID or PNR cancel, distinguish based on whether booking cancellation was confirmed within 24 hours after ticketing:
1.
Cancellation confirmed β†’ proceed RA refund via BSPlink.
2.
Cancellation not confirmed β†’ request penalty waiver from Finnair Korea (korea@finnair.com) (Required info: PNR, BSP billing history, logs).
To check if VOID/Cancel completed normally, contact via:
Finnair Agent Support chatbot, Email korea@finnair.com, Phone 00308640115
Penalty-free refund within 24 hours after ticketing (if departure β‰₯7 days) is waived for the following:
Eligible:
Finnair ticket (105~).
Entirely unused, Korea-origin itinerary, agency-issued.
Before departure (no-show excluded).
Note) OB fee is not auto-refunded by system; process manually.
TK
VOID: Same-day cancellation (POS based)
*However, if 18 hours from the ticketing is sooner, then 18 hours from the ticketing is VOID window.
Refund: After the VOID window

Change, VOID & Refund Policy for Ancillary#

Change#

Not allowed
LH, LX(LH), OS(LH), SQ, TR, TK
Allowed
AY: Only via the airline portal
HA, KE: Repurchase after cancel (Only up to 48 hours before departure)

VOID & Refund#

Allowed
EMD standalone VOID
LH, LX(LH), OS(LH): must be done via the airline portal (not supported by PolarHub)
HA, KE: Only up to 48 hours before departure
Ticket & EMD simultaneous VOID
AF, AY, HA, KE, KL, LH, LX(LH), OS(LH)
Refund
HA, KE: Only up to 48 hours before departure
LH, LX(LH), OS(LH): If a booking created via NDC is refunded via NDC, the ancillary is refunded together as well. (Refund is temporarily possible until this issue is fixed.)
Partially allowed
AY: (e.g.) Fully Flex class refund via BSP, refund possible
Not allowed
VOID & Refund
SQ, TR
Refund only
AF, AY, HA, KE, KL, TK

OCN ActionType, Context#

Case
1.
Schedule change - flight number change
2.
Schedule change - flight retimed
3.
Flight cancelled
4.
Changes to booked services
5.
Passenger name change (name, PTC, DOB)
6.
Passenger contact change (SSR CTCM/CTCE/CTCR)
7.
Flight Cancelled outside itinerary change situation
8.
Flight canceled due to TTL
9.
Voluntary changes to flights done by Airline
10.
No-show
11.
etc.

OCN Details by Airline Case
AA, EK, HA, KE, LH, LX(LH), OS(LH)
AY, QR, SQ
BA
AF, KL
TK
Case 1 ActionType = ASC & Context = 1
Case 2 ActionType = ASC & Context = 2
Case 3 ActionType = ASC & Context = 3
Case 4 ActionType = ASC & Context = 4
Case 11
ActionType = ASC & Context = 5
ActionType = ASC & Context = 9
ActionType = ASC & Context = Null
ActionType β‰  ASC

Limitation#

Itinerary Change#

πŸ“Œ
AY: When upgrading seats on partial segments during itinerary change, all seats are upgraded (NDC issue)
HA: Refund case not supported when itinerary change occurs (= cannot change to an itinerary with a lower fare β†’ not displayed during search)
🟒: Supported
❌: Not supported
QR
Ticketing StatusTrip TypeSectionOnDDateOnD & Date
Before Ticketing--❌❌❌
After TicketingOWALL🟒🟒🟒
RTALL🟒🟒🟒
RTPartial🟒🟒🟒
MTALL🟒🟒🟒
MTPartial🟒🟒🟒
HA, KE
Ticketing StatusTrip TypeSectionOnDDateOnD & Date
Before Ticketing--❌❌❌
After TicketingOWALL🟒🟒🟒
RTALL🟒🟒🟒
RTPartial🟒🟒🟒
MTALL🟒🟒🟒
MTPartial🟒🟒🟒
AF, KL
Ticketing StatusTrip TypeSectionOnDDateOnD & Date
Before TicketingOWALL❌❌❌
RTALL❌❌❌
Partial🟒🟒🟒
MTALL❌❌❌
Partial❌❌❌
After TicketingOWALL🟒🟒🟒
RTALL🟒🟒🟒
Partial🟒🟒🟒
MTALL🟒🟒🟒
Partial🟒🟒🟒
AY, SQ
Ticketing StatusTrip TypeSectionOnDDateOnD & Date
Before TicketingOWALL🟒🟒🟒
RTALL🟒🟒🟒
Partial🟒🟒🟒
MTALL🟒🟒🟒
Partial🟒🟒🟒
After TicketingOWALL🟒🟒🟒
RTALL🟒🟒🟒
Partial🟒🟒🟒
MTALL🟒🟒🟒
Partial🟒🟒🟒

Ancillary & Itinerary Change#

AF, KL
Ticketing StatusTrip TypeSectionOnDDateOnD & Date
Before TicketingOWALL❌❌❌
RTALL❌❌❌
Partial🟒🟒🟒
MTALL❌❌❌
Partial❌❌❌
After TicketingOWALL🟒🟒🟒
RTALL🟒🟒🟒
Partial🟒🟒🟒
MTALL🟒🟒🟒
Partial🟒🟒🟒

Change Information#

Individual
CTCM, CTCE
APIS, FFN, etc.
Note
Change
GivenName: AF, HA, KE, KL(Held booking only)
Surname: AF, HA(Held booking only), KE(Held booking only), KL
Title: AF, HA, KL
AF, KL: PTC-matching Title required
ADT: MR ↔ MRS
CHD/INF: MSTR ↔ MISS
Birthday: HA, KE
Gender: HA
Add
N/A
Delete
N/A

Special Note#

Ticketing
Train, Bus Schedule
Currency
Ancillary
Upsell
ALL
If infant fare is 0, ticket may not be issued
No Tickets (PNR only)
TR
Payment status (Successful) + Order Status (OK) determine completion
Information
CTCM, CTCE
per passenger required (ticketing error if missing): AY
Passport
Mandatory for U.S. routes: AF, KL
Optional, but if provided β†’ residence info also mandatory: BA
When entering DOCS, Nationality required (error if missing): HA, KE
DOCA/DOCS - Not mandatory in NDC, but recommended: AY, HA, KE
Other
LX(LH), OS(LH)
LX, OS also provided via LH API
First SEG airline (Ticketing Carrier) = issuing carrier
LH:220 / LX:724 / OS:257
BA
Ticketing for young Adult (12–15 yrs), DOB required at search even with adult
AF, KL
International Flight: Under 15 cannot book without adult
AF domestic: Under 12 cannot book without adult
Reservation will fail with CHD PTC if CHD’s age becomes ADT age during the flight.
If INF’s age becomes CHD during the flight, booking must be made with CHD PTC.
TR
ScootPlus (Premium Econ): 30kg baggage + meal included β†’ must add via ServiceList
Economy (Fly, JED only): 20kg baggage + meal included β†’ must add via ServiceList
If missed, auto-assign every 3 hours OR can also add via TR Agency Hub
TK
Interline
It is not possible to change itinerary or ancillary services.
Mandatory data at the time of booking
ContactInfo(Phone,PostAddress)
Only PostalAddress/CountryCode needs to be set.
Available values for ContactTypeText:
Mobile Phone : M
E-mail address : E
INF contact information must not be set.
Extend Reserve TL feature has been added.
After OrderCreate: TL is 15 minutes
After Extend Reserve TL: TL extends until roughly 3 weeks before departure
Ancillary service change/refund
Cannot be changed or refunded separately
Must be processed through the Sales Office
Orders including paid ancillary services cannot be refunded
PNR split before ticketing
Extend Reserve TL is mandatory
Splitting is possible with at least one passenger (INF must be split together with the associated ADT)
Modified atΒ 2025-11-10 08:21:21
Previous
Carrier Support Matrix
Next
πŸ”‘ Transaction ID Guidelines
Built with