Shopping Links Confirmation

ITCO Deep Links - Shopping Links Confirmation

ITCO deep links lead you/your customer to the booking screen of respective Lufthansa Hub Airlines with the flights already in the shopping cart.

This service accepts same search parameters and same encryption logic for all the Lufthansa Hub Airlines. Hence the target URL alone would be different for each Airlines. Below target URLs would be used to generate deeplinks specific to airlines based on search parameters.

The target URL for the deeplink is tenant specific as follows:

  • LH: https://www.lufthansa.com/deeplink/partner
  • LX: https://www.swiss.com/deeplink/partner
  • OS: https://www.austrian.com/deeplink/partner
  • SN: https://partner.brusselsairlines.com/deeplink/partner

ITCO Request URI

Code snippet: URL
/v2/customer-deeplinks/shopping-links/confirmation?&airlineCode={airlineCode}&originCode={originCode}&destinationCode={destinationCode}&travelDate={outboundDate}[&returnDate={returnDate}][&cabinClass={cabinClassCode}][&outboundSegments={outboundSegment}][&returnSegments={returnSegment}][&travelers=([adult={numberOfPassengers}];[child={numberOfPassengers}];[infant={numberOfPassengers}][&fare=totalFare}][&fareCurrency=fareCurrency}]&[partnerId={partnerID}][&encrytpionKey{encryptionKey}]&partnerName={partnerName}&languageCode={language}&countryCode={countryCode}

ITCO input parameters

VariableDescriptionFormat
{airlineCode} Airline Code - LH,LX,OS,SN 2 letter airline code
{originCode} Origin airport/city code - Mandatory 3-letter IATA code, e.g. “FRA”.
{destinationCode} Destination airport/city code- Mandatory 3-letter IATA code, e.g. "MUC".
{travelDate} Outbound travel date- Mandatory yyyy-MM-dd. e.g. '2016-10-27'
{returnDate} Return travel date - Optional yyyy-MM-dd. e.g. '2016-10-27'
{cabinClass} Cabin Class Code - Optional Cabin class: 'economy', 'premium_economy', 'business', first'
{outboundSegments} Enter outbound flight segments in the sequence of outbound travel - Mandatory e.g. 'e.g. LH096;LH480'
{returnSegments} Enter return flight segments in the sequence of return travel - Mandatory for return journey e.g. 'LH7465;LH431'
{travelers} Number of passengers of the corresponding type - Optional (adult=1 will be used as default) Two digit number
Adult=2
Child=2
Infant=1
{fare} Total fare - Mandatory e.g 100.50
{fareCurrency} Fare currency - Mandatory three letter currency code e.g. 'EUR'
{partnerId} Partner identification - Optional integer e.g.1071
{encryptionKey} Encryption key - Optional AES key
{partnerName} partnerName - Optional.  alpha numeric string e.g. 'MYDummyID'
{languageCode} Language code - Mandatory 2 letter language code e.g. "DE"
{countryCode} Country code - Mandatory 2 letter country code e.g. "DE"

Request Examples

Code snippet: URL
/v2/customer-deeplinks/shopping-links/confirmation?airlineCode=LH&fareCurrency=EUR&returnSegments=LH401&originCode=FRA&fare=1018.34&cabinClass=Economy&countryCode=de&partnerId=13100&encryptionKey=C49A99BBF61C2992A14E60D3F21ABCF&travelDate=2016-10-12&returnDate=2016-11-12&languageCode=de&outboundSegments=LH400&travelers=(adult=3;child=2;infant=1)&partnerName=dummy

Response Structure Definition:

KeyDescription
deepLinkResponse Root element
.deepLinks
..deepLink[] Array repeat for each deeplink
...@id Unique id 
...@type Type of link. Format: "booking-<AirlineCode in small case>". Example: "booking-lh"
...@link Encrypted booking deeplink for provided sensitive data.

Response Examples

{
  "deepLinkResponse": {
    "deepLinks": {
      "deepLink": {
        "@id": "7aa845b608e72785",
        "@type": "booking-lh",
        "@link": "https://www.lufthansa.com/deeplink/partner?partnerId=13701&amp;Language=en&amp;Country=de&amp;ENC=86bd58eedeffeda1d5bab325236fa77d2f3e40bd7344e4153636149e99558bb1ad68df08f59d110f75bcb7a4ff42d5ffa17eff0301b68d6fbbe831c14fa0a7afebff0e3fb4474a3bee79cddcaae93f21567ea26126bdbef06c5dfe97eeaf08d625cb4c8b077063e74051d42faacf72dc8c68dc91d0e7ef043059d93b7761ebd181e01b9c2e8da56833684ec22338de875f64173bf20c276a1259f72829204055c17152420df02ec89188dc33a219dbe385d44d40522a51dd170e75bbd10eefade01bd2acaee60985f2d67bed7590f8bbc4e7647403c2f5ab3d228c617b3d6b837ec323d7dcea68cf4dc0c3af7c11a09340ba0d83a07f8a93077294f8d4c6df0fad32a9b07f97aa5d37ff89113ca5c68396a667b00b7d9ff2e8578dcb3bea5b83&amp;dwmwr=utm_medium%3Dfse%26utm_source%3DKayak%26utm_term%3DKayak%26utm_campaign%3Dlh_de_en_fra-mad_desktop"
      }
    }
  }
}