How to pass pre-selected fields in the affiliate link

If you do not use the full Booking API flow, it is possible to populate the product information using the Content API and take the availability from the Availability & Pricing API. You can let the customer select the date and product variant(s) on your website and pass these details as URL parameters in the Tiqets affiliate link. When following the affiliate link, the Tiqets website will show the pre-selected information accordingly for a seamless customer experience.

This is the structure of the base URLs of Tiqets affiliate links:

Product URL: https://www.tiqets.com/en/amsterdam-attractions-c75061/tickets-for-van-gogh-museum-p974079 (Retrieved from the product_url key in the Content API)

Checkout URL: https://www.tiqets.com/en/checkout/tickets-for-van-gogh-museum-p974079/booking_details/ (Retrieved from the product_checkout_url key in the Content API)

Supported Parameters

There are five parameters which can be added to the URL. When constructing URLs on tiqets.com, please adhere to the order of parameters as listed below.

1. partner

• Format: Alphanumeric string (e.g., partner=mysitebrand)

• Description: Specify the so-called sitebrand that orders will be allocated to. Note: The sitebrand needs to be existing on Tiqets, otherwise orders will not be allocated.

2. selected_date

• Format: YYYY-MM-DD (e.g., selected_date=2024-10-28)

• Description: Pre-select a specific date for the product or checkout.

3. selected_timeslot_id

• Format: Alphanumeric string (e.g., selected_timeslot_id=10:00)

• Description: Enable the pre-selection of a specific timeslot for the product or checkout.

4. selected_variants

• Format: Ampersand-separated pairs (e.g., selected_variants=81814=1&81815=2)

• Description: Facilitate the pre-selection of product variants to tailor the product offering based on specific preferences.

5. currency

• Format: Three-letter currency code (e.g., currency=EUR)

• Description: Specify the currency for pricing and transactions.

Please note that some of our products require an additional language selection. This is currently not indicated or returned by the API and therefore the pre-selection of parameters does not work for those products.

Example Constructed URLs

Now, let's look at examples of URLs with pre-selected parameters for a user who:

• User is on the Italian version of tiqets.com

• Sitebrand is mysitebrand

• Selected 2024-02-28 as a visit date

• Selected 12:00 as a timeslot

• Selected tickets for two variants: for the variant 767 a quantity of 1 and for the variant 5091 a quantity of 2

• User sees price/currency in EUR

Resulting Product URL: https://www.tiqets.com/it/attrazioni-amsterdam-c75061/biglietti-per-van-gogh-museum-p974079?partner=mysitebrand&selected_date=2024-02-28&selected_timeslot_id=12%3A00&selected_variants=767%3D1%265091%3D2&currency=EUR

Resulting Checkout URL: https://www.tiqets.com/it/checkout/biglietti-per-van-gogh-museum-p974079/booking_details/?partner=mysitebrand&selected_date=2024-02-28&selected_timeslot_id=12%3A00&selected_variants=767%3D1%265091%3D2