Checkin Deeplinks

Checkin Deeplinks describes the fuctionality to check in their passagner using encrypted links.

This operation creates the encryption of sensitive data and provide as orders (PNR or ticket number ) with encrypted checkin deep links to align with GDPR requirements for any mobile or web or chatbot use cases.

Request URI (SN - Brussels Airline)

POST https://api.lufthansa.com/v2/customer-deeplinks/checkin-links/sn
Content-Type: application/x-www-form-urlencoded

POST ParameterDescriptionFormatMandatory/Optional/Conditional
type Type of checkin. It should be either ETICKET or PNR.
String Mandatory
pnr PNR/Booking reference value to checkin. String Conditional: Mandatory when type=PNR.
ticketNumber Ticket number to checkin. String Conditional: Mandatory when type=ETICKET.
lastName customer last name String Mandatory
firstName customer first name String Optional
languageCode Language code. Single character language code should be 1 or 2 or 3 or 4 or 9 or 10 (1 = English, 2 = German, 3 = French, 4 = Italian, 9 = Dutch, 10 = Spanish). Example: languageCode=2. String(Single character) Mandatory
departureAirportCode Departure Airport Code. Example: departureAirportCode=BRU. 3-letter IATA departure airport code Mandatory
airlineCode Airline code. Example: airlineCode=SN 2-letter IATA airline code Optional
departureFlightNumber Departure flight number. Example departureFlightNumber=2093 String Optional
departureFlightDate Departure flight date in yyyyMMdd format. Example departureFlightDate=20200108 String with yyyyMMdd format Optional
email Customer email address. String Optional
contactNumber Customer contact number. String Optional

Request Example

https://api.lufthansa.com/v2/customer-deeplinks/checkin-links/sn HTTP/1.1 
Content-Type: application/x-www-form-urlencoded
type=ETICKET&ticketNumber=0822184232525&lastName=WOLFE&languageCode=1&departureAirportCode=BRU&airlineCode=SN&departureFlightNumber=2093&departureFlightDate=20200109&email=opat-zrh%40dxc.com"

Response Structure Definition:

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

Resposne Example :

JSON Response :

{
  "DeepLinkResponse": {
    "DeepLinks": {
      "DeepLink": {
        "@id": "ca38dd7db90a5498",
        "@type": "orders-checkin-SN",
        "@link": "https://webcheckintest.svcs.entsvcs.com/WebCheckInOLCITest/WebForms/Default.aspx?cname=BEL&amp;data=RKJnIMIioQxkIT1Ta6Bk3YOQcSuGvs6agrBmF1XNznEw4kKfKxNtwZKvzPa5Cc81xtVmVkUsER_265JkEmRIMy5Rtq-0UNzNKT-M3wqPir7-TkQrZT5zyVQted7r9PwKGhE7hkigGsw-S-50ctsysg2"
      }
    }
  }
}

Request URI (LH - Lufthansa)

POST https://api.lufthansa.com/v2/customer-deeplinks/checkin-links
Content-Type: application/x-www-form-urlencoded
POST ParameterDescriptionFormatMandatory/optional
airlineCode airline code supported for "LH"  or "OS" or "LX" 
2-character IATA airline designator code. Mandatory
languageCode language code with 2 character. 2-letter ISO 639-1 language code, e.g. “EN”. Optional
lastName customer last name / surname String Mandatory
firstName customer first name String Mandatory
ticketNumber ticket number : Numeric number 13-character Mandatory
countryCode country code 2-character language code. e.g. "us" Optional
partnerId partner id of registered partner on web & mobile deeplinks Optional
encryption-key ecryption key for the given partner id. this is conditional madatory if you send partner id Optional

Request Example

https://api.lufthansa.com/v2/customer-deeplinks/checkin-links HTTP/1.1 
Content-Type: application/x-www-form-urlencoded
airlineCode=lh&languageCode=en&lastName=FOGEL&firstName=IRENE&ticketNumber=7242691541233

Response Structure Definition (LH, LX, OS):

KeyDescription
DeepLinkResponse root element
.DeepLinks
..DeepLink[] array repeat for each deeplink
...@id unique id 
...@type type of link  format ; "<airlineCode>-<cki/g4t>"  where "cki" (check-in) or "g4t" (good 4 train)  for e.g. : "lh-cki" or "os-cki" or "lx-cki"
...@link Checkin deeplink "PNR" or "Ticket" check-in with-in 24 hours

Resposne Example :

JSON Response :

{"DeepLinkResponse":{
    "DeepLinks":{
	 "DeepLink":[{
		 "@id": "fc685a1a-b49b-4516-be15-a27b541a138f",
		 "@type":"lh-cki",
		 "@link": "https://mobile.lufthansa.com/lp/cki?ENC=655157ac1eff4792a5344aa604a4b05072a90dfcc2fb1456673233f87d507677438805bfbb1621da7bcbb032ffea46e8&c=us&l=en&partnerId=13701"
  	    },{
		 "@id": "79dbabd0-ce41-4c6e-ac9a-198df735756d",
		 "@type":"lh-g4t",
		 "@link": "https://mobile.lufthansa.com/lp/g4t?ENC=655157ac1eff4792a5344aa604a4b05087f79ba06b9d79cdfc098b35a70430b8fff32323bc1c5a39b26b09ed799db84e&l=en&partnerId=13701"  
	    }]
	}
    }
 }

Request URI (OS - Austrian)

POST https://api.lufthansa.com/v2/customer-deeplinks/checkin-links HTTP/1.1
Content-Type: application/x-www-form-urlencoded
POST ParameterDescriptionFormatMandatory/optional
airlineCode airline code supported for "LH"  or "OS" or "LX" 
2-character IATA airline designator code. Mandatory
languageCode language code with 2 character. 2-letter ISO 639-1 language code, e.g. “EN”. Optional
lastName customer last name / surname String Mandatory
firstName customer first name String Optional
ticketNumber ticket number : Numeric number 13-character Mandatory

Request Example

https://api.lufthansa.com/v2/customer-deeplinks/checkin-links 
HTTP/1.1 
Content-Type:application/x-www-form-urlencoded 
airlineCode=lh&languageCode=en&lastName=FOGEL&firstName=IRENE&ticketNumber=7242691541233

Response Example :

JSON Response:

{ "DeepLinkResponse": {
         "DeepLinks": {
             "DeepLink": [
                 {
                     "@id": "ca63afe5-adf9-4fdc-b6fc-ee360d8e1b2a",
                     "@type": "os-cki",
                     "@link": "https://wci.austrian.com/app/ck.fly?documentType=ETIX&retrievalData=Ba9s5VrIw7AGUtVyAsZulcgnZFrmzAC5dbnBqGoI
			 qekAYiyYhVD4zFk7gA3dkM35XHaeADI5MkYUABBA4FHuXkKmGP9%2BNRCWpkLtYap%2FVN8se9oUfAVpUsB0GYBm6plYnzSLjRa8N18olHZANL8WnIB%2BTd2AT%2F
			 NIIH9po8MubzPD6dWfSpoWlg%2FBPke3M%2FxRnC7F2H0PxlWm47Lv%2BnKeKix9Udd%2BIGj7vH84EriYKWpTtG73Ved5%2BzY1cBqELj0C9TFkRv7xZeTBzXYOOW
			 q9iHZeXU66It3YyFyClcfTknIBwGxwTE1EEaBX5pkhFsbzXigZ57%2FiRTzCjGq89koqCQ%3D%3D&l=en"
                 }
             ]
         }
     }
 }

 

Request URI (LX - Swiss Airlines)

POST https://api.lufthansa.com/v2/customer-deeplinks/checkin-links
Content-Type: application/x-www-form-urlencoded

POST ParameterDescriptionFormatMandatory/optional
airlineCode airline code supported for "LH"  or "OS" or "LX" 
2-character IATA airline designator code. Mandatory
languageCode language code with 2 character. 2-letter ISO 639-1 language code, e.g. “EN”. Optional
lastName customer last name / surname String Mandatory
firstName customer first name String Mandatory
ticketNumber ticket number : Numeric number 13- digit number number Mandatory
departureAirlineCode Departure Airline code  2-character IATA airline designator code. e.g : "LH" Mandatory
departureFlightNumber Departure Flight number without airline code   Numerice digit with 0 to 4 digit  e.g : "1231" Mandatory
departureFlightDate Departure date in the local time of the departure airport.  yyyy-MM-dd Mandatory
departureAirportCode Departure aiport code 3 letter IATA airport code, e.g. “FRA” Mandatory

Request Example

https://api.lufthansa.com/v2/customer-deeplinks/checkin-links
Content-Type: application/x-www-form-urlencoded
airlineCode=LX&languageCode=en&lastName=MOYSES&firstName=VALERIE&ticketNumber=2202950268327&departureAirlineCode=LX&departureFlightNumber=1068&departureFlightDate=2018-10-23&departureAirportCode=ZRH

Response Example

JSON Response :

{"DeepLinkResponse":{
	"DeepLinks":{
		"DeepLink":[{
			"@id":"6b93fadf-97e4-45bb-8d91-5cf7bc7e6e5a",
			"@type":"lx-cki",
			"@link":"https://checkin.swiss.com/ck.fly?paxflight=gVfoJ79ph7I%2BHgIxdAel%2FMENaPOoD2QM2BgXP%2FHkh%2BJ0h4BHAM5EuBmcCGjnsAuiXUMzUin0TTqvG%2FX1SQWJAmDRKP
			31%2Ba2zPTXxLIUi1%2FWWh7w%2F2At%2B4wqcy%2FMatpZBvVWCh%2FfZOf3nLkIZQGpczu6%2F59SrsHIJrtPtnEZoFFT1MlruqwFBBbU21cpOFfJ4&group=Yes&locale=en"
			}]
		}
	 }
}