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
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.
| 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 | 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 |
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 |
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).
| 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. |
| 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. |
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
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
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