OfferPrice

Overview

The OfferPrice API is used to verify the actual price and detailed fare conditions of a selected Offer retrieved from the AirShopping step.
The airline returns information including the total fare amount, fare class details, baggage allowance, and fare rules.

Usage Guidelines

FFN (Loyalty program)

Supported: AF, KL

Additional Baggage Purchase

When purchasing additional baggage, call ServiceList first, then proceed with OfferPrice.

In OfferPriceRQ/Query/Offers{1…*}, include as many baggage service Offers as needed.

If the value of ServiceListRS/AlaCarteOffer/AlaCarteOfferItem/Service/ServiceCode is "XBAG",
you must specify the baggage weight in BookingInstructions/Text (e.g., TTL10KG).

For "BULK", "PIEC", or "HEAV" codes, no BookingInstructions input is required.

Additional Seat Selection Purchase

When purchasing or confirming seat selections, call SeatAvailability first to retrieve seat map offers, then proceed with OfferPrice.

In OfferPriceRQ/Query/Offers{1…*}, include the selected seat service Offers.

Use the information from SeatAvailabilityRS/ALaCarteOffer/SeatMap/Layout to populate seat details.

Each OfferItem must contain a SeatSelection object specifying the chosen seat:
Column: seat column (e.g., "G")
Row: seat row number (e.g., "20")

MatchResult behavior for RT / MT Offers

MatchResult and how it affects OfferPriceRQ selection

For Round Trip (RT) and Multi Trip (MT) shopping flows, AirShoppingRS/Offer/MatchResult indicates whether the airline returned pricing as a single combined Offer or as separate Offers per journey.

MatchResult = FULL

The airline provides a single Offer that already covers all journeys in the search request.

You can proceed with OfferPrice using exactly one Offer (select 1 OfferID and its OfferItems).

MatchResult = PARTIAL

The airline provides separate Offers, each matching only part of the itinerary (typically one journey / one origin-destination).

To price the full itinerary, you must include multiple Offers in OfferPriceRQ, selecting as many Offers as the number of journeys (ODs) in the request.

Example: For an ICN–LHR round trip, if the response is PARTIAL, you typically need to select 2 Offers (one for outbound and one for return). If the response is FULL, select 1 Offer only.

Combining Partial Offers via AugmentationPoint

When pricing a round-trip (or multi-trip) request built from per-leg
Partial offers (e.g., LH, EK), the selected offers must satisfy
the combinability rule provided in the AirShopping response's
AugmentationPoint (AugPoint). Combinations that are not permitted by
the carrier's rule will be rejected at OfferPrice.

How to read the rule

Each AugPoint belongs to one offer/leg, identified by Owner and
Association (the offer's own PriceClassRefID or FareBasisCode).

Combinability.Association[].Type indicates the identifier basis
(PriceClass or FareBasisCode).

Combinability.Association[].ReferenceValue lists the IDs/codes from
other legs that this offer is allowed to be combined with.

How to build a valid OfferPrice request

Pick one offer per leg (e.g., one outbound, one inbound).

For each selected offer, read its AugPoint.Association identifier
(PriceClass ID or FareBasis code).

Verify that every other selected leg's identifier appears inside the
first offer's Combinability.Association[].ReferenceValue list — and
vice versa.

Only when all selected legs are mutually referenced should the
combination be sent to OfferPrice.

Example — valid combination (LH, PriceClass)

Outbound offer's AugPoint:

{
  "Owner": "LH",
  "Association": { "PriceClassRefID": ["Xpc09003ad0a7c35"] },
  "Combinability": {
    "Association": [
      {
        "Type": "PriceClass",
        "ReferenceValue": [
          "Xpc09003ad0a7c35",
          "Xpc13003ad0a7c35",
          "Xpc1c003ad0a7c35"
        ]
      }
    ]
  }
}

Selecting an inbound offer whose PriceClassRefID is Xpc13003ad0a7c35
is permitted (it appears in ReferenceValue). Selecting an inbound
offer whose PriceClassRefID is not in that list will be rejected
at OfferPrice.

:highlight gray 📌 The combinability rule is currently expressed as
either PriceClass or FareBasisCode. PolarHub does not validate
the combination on behalf of the tenant — selection of valid pairs
based on AugmentationPoint is the tenant's responsibility. For
details on which carriers provide AugmentationPoint and the response
shape, refer to the AirShopping API documentation.

Upsell

OfferPrice supports retrieving additional upsell offers based on the selected Offer.

In OfferPriceRQ/Query/ResponseParameter/PricingParameter/IncludeUpsellOffersInd the value must be set to true

To select an upsell offer, choose one from OfferPriceRS/OtherOffers.

Not supported : AS, EK, HA, TR

TK supports upsell offers only under a specific Offer Flow configuration.
Please contact us separately to enable upsell support.

For LH and AA, upsell offers are returned with MatchResult = PARTIAL, but the actual offer status is MatchResult = FULL (MatchResult = PARTIAL is an airline-side error).

application/json

Bodyapplication/json

Example

{
    "ResultMessage": {
        "Code": "00000",
        "Message": "SUCCESS",
        "MessageDetail": {
            "Errors": [],
            "Warnings": []
        }
    },
    "Recipient": {
        "TravelAgency": {
            "AgencyID": "TSDV001",
            "SiteCode": "01",
            "ContactInfoRefID": []
        }
    },
    "PointOfSale": "KR",
    "TransactionID": "d444699d5cec4de5b04da94557b3bbcc",
    "PricedOffer": {
        "ResponseID": "d444699d5cec4de5b04da94557b3bbcc",
        "OfferID": "47b196ddee1b44e29570fbd95cc01f3e17.2-1",
        "Owner": "LH",
        "TotalPrice": {
            "TotalAmount": {
                "Amount": 3303000,
                "CurCode": "KRW"
            },
            "TravelAgencyServiceFee": [],
            "TotalBaseAmount": {
                "Amount": 451000,
                "CurCode": "KRW"
            },
            "TotalTaxAmount": {
                "Amount": 2852000.0,
                "CurCode": "KRW"
            },
            "FopPromotion": []
        },
        "OfferTimeLimit": "2026-03-25T09:42:51Z",
        "JourneyOverview": [
            {
                "PaxJourneyRefID": "Pflts5k5qsrofbspr",
                "PriceClassInfo": {
                    "PriceClass": "Ppcqu6syvh95xw0u",
                    "Code": "ESV00",
                    "Name": "Economy Basic Plus",
                    "Descriptions": [
                        {
                            "Text": "Food and Beverages"
                        },
                        {
                            "Text": "1 Hand Baggage"
                        },
                        {
                            "Text": "Checked Baggage Included"
                        },
                        {
                            "Text": "Warning: all services may not be delivered as the requested itinerary may include flights operated by our partner airlines"
                        }
                    ]
                }
            },
            {
                "PaxJourneyRefID": "Pflt3jo4p59osedgs",
                "PriceClassInfo": {
                    "PriceClass": "Ppcqu6syvh95xw0u",
                    "Code": "ESV00",
                    "Name": "Economy Basic Plus",
                    "Descriptions": [
                        {
                            "Text": "Food and Beverages"
                        },
                        {
                            "Text": "1 Hand Baggage"
                        },
                        {
                            "Text": "Checked Baggage Included"
                        },
                        {
                            "Text": "Warning: all services may not be delivered as the requested itinerary may include flights operated by our partner airlines"
                        }
                    ]
                }
            }
        ],
        "MatchResult": "Full",
        "BaggageAllowance": [
            {
                "PaxJourneyRefID": "Pflts5k5qsrofbspr",
                "PaxRefID": [
                    "T1",
                    "T2",
                    "T3",
                    "T1.1"
                ],
                "TypeCode": "Checked",
                "Desc": [
                    "CHECKED ALLOWANCE"
                ],
                "PieceAllowance": "1",
                "MaximumWeightAllowance": {
                    "Value": 23.0,
                    "UnitCode": "KG"
                }
            },
            {
                "PaxJourneyRefID": "Pflts5k5qsrofbspr",
                "PaxRefID": [
                    "T1",
                    "T1",
                    "T2",
                    "T2",
                    "T3",
                    "T3"
                ],
                "TypeCode": "CarryOn",
                "Desc": [
                    "CARRYON HAND BAGGAGE ALLOWANCE",
                    "CARRY8KG 18LB UPTO46LI 118LCM"
                ],
                "PieceAllowance": "1",
                "MaximumWeightAllowance": {
                    "Value": 8.0,
                    "UnitCode": "KG"
                }
            },
            {
                "PaxJourneyRefID": "Pflt3jo4p59osedgs",
                "PaxRefID": [
                    "T1",
                    "T2",
                    "T3",
                    "T1.1"
                ],
                "TypeCode": "Checked",
                "Desc": [
                    "CHECKED ALLOWANCE"
                ],
                "PieceAllowance": "1",
                "MaximumWeightAllowance": {
                    "Value": 23.0,
                    "UnitCode": "KG"
                }
            },
            {
                "PaxJourneyRefID": "Pflt3jo4p59osedgs",
                "PaxRefID": [
                    "T1",
                    "T1",
                    "T2",
                    "T2",
                    "T3",
                    "T3"
                ],
                "TypeCode": "CarryOn",

Overview

Usage Guidelines

FFN (Loyalty program)

Additional Baggage Purchase

Additional Seat Selection Purchase

MatchResult behavior for RT / MT Offers

MatchResult and how it affects OfferPriceRQ selection

Combining Partial Offers via AugmentationPoint

Upsell

Request

Request Code Samples

Responses

OfferPrice

Overview#

Usage Guidelines#

FFN (Loyalty program)#

Additional Baggage Purchase#

Additional Seat Selection Purchase#

MatchResult behavior for RT / MT Offers#

MatchResult and how it affects OfferPriceRQ selection#

Combining Partial Offers via AugmentationPoint#

Upsell#

Request

Request Code Samples

Responses

Overview

Usage Guidelines

FFN (Loyalty program)

Additional Baggage Purchase

Additional Seat Selection Purchase

MatchResult behavior for RT / MT Offers

MatchResult and how it affects OfferPriceRQ selection

Combining Partial Offers via AugmentationPoint

Upsell