Getting started
The first step is to gather all the necessary information for generating the final attach link URL.
Here’s a list of the details you’ll need:
| Requirement | Source | Description |
|---|---|---|
| Partner ID | To be shared by Expedia Group. | The Partner ID is a string value used in request parameters. For example: partnerId = partnername_hotel_conf_overlay |
| Secret/Private Key | To be shared by Expedia Group. | A secret key is an alphanumeric string shared securely by Expedia Group for each Partner ID and it's used to generate a signature. This key is 36 characters long. For example: Page 1: • partnerId = partnername_hotel_conf_overlay• secret key = 6f437404-261d-4beb-a7fc-43b92f694831Page 2: • partnerId = partnername_hotel_itin_overlay• secret key = 89f37407-821r-3des-a7f5-ghb92f694294 |
| Tracking Code | To be shared by Expedia Group. | Tracking code used to track revenue attribution for partner site placements. |
| Endpoint | xsell-redirect-pwa | |
| HMAC-SHA1 algorithm library | https://commons.apache.org/crypto/download_crypto.cgi | HMAC-SHA1 algorithm library is used to generate the signature. https://download.java.net/java/early_access/panama/docs/api/java.base/javax/crypto/package-summary.html |
| Encoding URL UTF-8 | http://en.wikipedia.org/wiki/Percent-encoding | |
| Deeplink guide to construct the first URL for hotel results page. | Deeplinks | Instructions on creating standard deeplinks are detailed in this article. Note: Destinations must align with locales supported by your template sites. |
Email attach link URL request parameters
| Parameters | Type | Required/Optional | Description | Sample Values |
|---|---|---|---|---|
partnerId | String | Required | To be provided by Expedia Group. | partnername-POS-Ext-Flight-Conf-EmailDL |
url | String | Required | Create the deeplink request URL for the hotel results page using the partner domain, search parameters, and tracking code, following the deeplink guide. Ensure the tracking code (mdpcid) is included, and the value of the output parameter is properly URL-encoded. | url = https%3A%2F%2Fexpedia.com%2Fgo%2Fhotel%2Fsearch%2FDestination%2F2025-12-22%2F2025-12-25%3Fmdpcid%3DMDPCID=Expedia-IE.DPS.en_IE.confemail.attachDL.Flightl%26CityName%3DORD%26SortBy%3Ddistance%26NumRoom%3D1%26NumAdult1%3D3%26NumChild1%3D2%26Rm1child1age%3D9%26Rm1child2age%3D6n |
outboundEndDateTime | String representation of a date following ISO 8601 standard. | Required | Specify the trip arrival date and time at the destination. It should include only the date, time, and timezone according to the ISO 8601 standard. This parameter value needs to be encoded. | 2025-10-30T20%3A12%3A17.928020Z |
originTLA | String (3 letters) | Required | Specify the trip origin's IATA airport code. | LAS |
returnStartDateTime | String representation of a date following ISO 8601 standard. | Optional - only needed for roundtrips | Specify the trip return date and time from the destination. It can include only the date, time, and timezone according to the ISO 8601 standard. This parameter value needs to be encoded. | 2025-11-10T20%3A12%3A17.928020Z |
destinationTLA | String (3 letters) | Required | Specify the trip destination's IATA airport code. | JFK |
bookingDateTime | String representation of a date following ISO 8601 standard. | Required | Specify the date and time of the booked reservation. It can include only the date, time, and timezone according to the ISO 8601 standard. This parameter value needs to be encoded. | 2025-07-25T20%3A12%3A17.928020Z |
bookingStatus | String | Optional - If not provided, we assume that the booking is confirmed. | The valid values for this parameter are: • confirmed• pending• failedDiscounted rates apply only when the bookingStatus is confirmed. | confirmed |
attachDL | boolean | Required | Set the value as true to enable discounted attach rates. | true |
signature | String | Required | Generated server-side by the partner based on a secret key provided by Expedia Group. The length of this string is exactly 27 characters. Encode the resulting binary signature. | BcND1F7KElTyGtyUHeXHd2JJLFs |