Deeplinks

With deeplinks you can create URLs which open Booking Engine Standalone in some pre-defined setup, for example with a specific currency or specific dates. You do this by simply adding supported parameters to the URL in the form of a URL query string. For example:

https://app.mews.com/distributor/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee?currency=EUR&mewsRoute=rates&mewsRoom=aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

Supported parameters

This is the list of parameters that can be added to the URL query string. Parameters can be combined, and some parameters have no effect unless they are used in combination, e.g. mewsHotel.

Parameters supported in single and multi-enterprise mode

Name
Description
Example

mewsStart

an arrival date in ISO 8601 format (YYYY-MM-DD)

2023-01-20 for January 20, 2023

mewsEnd

a departure date in ISO 8601 format (YYYY-MM-DD)

2023-01-23 for January 23, 2023

mewsVoucherCode

a voucher code

E1A71167851A30043B12

mewsRoute

rooms for rooms step

mewsSort

sort categories on category step by lowest/highest price; overrides all other ordering methods

mewsSort=asc sorts by lowest price, mewsSort=desc sorts by highest price

mewsRoom

opens with specified room selected (aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee)

da394bbb-9685-4bb8-9547-ab7300915967

mewsAdultCount

number of adults that should be selected by default

3

mewsChildCount

number of children that should be selected by default

1

language

a language code (xx-YY)

en-US for U.S. English

currency

a currency code (XXX)

USD for United States dollar

Additional parameters supported in multi-enterprise mode

In addition, Mews Booking Engine in multi-enterprise mode also supports:

Name
Description
Example

mewsCityId

selects specified city (aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee)

cf1678c0-0896-450b-8611-bec07d63cc32

mewsHotel

selects specified hotel (aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee)

e31209f1-8be9-49d0-a577-ab73009151f3

mewsRoute

With parameter mewsRoute you can open the Mews Booking Engine on a specific step, e.g. selecting a room (or other bookable space) or selecting a rate.

Note: The steps available depend on whether you are using single-enterprise or multi-enterprise mode. Some steps also require additional parameters to be set, otherwise the mewsRoute parameter will not work correctly (see the following tables for details).

mewsRoute in single-enterprise mode

Step
Required parameters
What it does

mewsRoute=rooms

none

Application will open a page where user can select a room category.

mewsRoute=rates

mewsRoom

Application will open a page where user can select rate, products and occupancy.

mewsRoute in multi-enterprise mode

Step
Required parameters
What it does

mewsRoute=hotels

mewsCityId

Application will open a page where user can select a hotel (or other property type).

mewsRoute=rooms

mewsCityId, mewsHotel

Application will open a page where user can select a room category (or other space type category).

mewsRoute=rates

mewsCityId, mewsHotel, mewsRoom

Application will open a page where user can select rate, products and occupancy.

Examples

Example 1: Specific start date, voucher code and language

The following deeplink will open the booking engine with a specific start date, specific voucher code and specific language:

https://app.mews.com/distributor/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee?mewsStart=2021-01-01&mewsVoucherCode=special-discount&language=en-US

Example 2: Pre-selected room and currency on rate selection step

The following deeplink will open the booking engine on the rate selection step with a specific pre-selected room and specific currency:

https://app.mews.com/distributor/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee?currency=EUR&mewsRoute=rates&mewsRoom=aaaa-bbbb-cccc-dddd

Example 3: Multi-enterprise with pre-selected city on hotel selection step

The following deeplink will open the booking engine in multi-enterprise mode on the hotel selection step with a specific pre-selected city:

https://app.mews.com/distributor/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee;ffffffff-gggg-hhhh-iiii-jjjjjjjjjjjj?mewsRoute=hotels&mewsCityId=aaaa-bbbb-cccc-dddd

Last updated