Ecommerce Platform | How to build links Room or Rate specific URLs

Ecommerce Platform | How to build links Room or Rate specific URLs

🔍 Summary

This article explains how to build custom links in your ecommerce platform that direct guests to specific rooms, rates, or promotional offers. By adjusting URLs, you can ensure that links from your main website or marketing campaigns lead customers straight to the correct room or rate type — even when occupancy or date restrictions apply.

Likely Scenario

You might use this guide if:
  1. You want to link directly from your hotel’s main website to a specific room or rate.
  2. You have promotional or rate codes you’d like to embed in your marketing links.
  3. You need to share links that respect specific guest, date, or promo code restrictions.

🛠️ Process Overview

This section outlines how to structure URLs in your ecommerce platform to target specific booking parameters. You’ll learn how to modify links for room codes, date ranges, guest counts, and promotional rate codes.

Step-by-Step Instructions:

  1. Rooms with Guest Restrictions
    1. If a room or rate has a minimum or maximum occupancy requirement (above the default of 2 adults), you must add the correct parameters to the URL.
    2. Format:
    3. /rooms/ROOMCODE&adults=X&children=X
    4. Replace ROOMCODE with the actual room code.
    5. Replace each X with the appropriate number of adults and/or children.
    6. Example: https://example.onejourney.travel/rooms/EXEC&adults=4&children=0
  2. Rates Available for Specific Dates
    1. If a rate is restricted to certain dates, use the following structure:
    2. /rates/RATECODE?fromDate=YYYY-MM-DD&toDate=YYYY-MM-DD
    3. Replace RATECODE with your rate code.
    4. Replace the dates with the desired arrival and departure dates.
    5. Example: /rates/SUMMEROFFER?fromDate=2025-06-01&toDate=2025-08-31
  3. Promo Rates (Using Promo Codes)
    1. For promo rates, you’ll need to include both the rate code and promo rate code in the URL.
    2. Format:
    3. /rates/RATECODE?&promoRateCode=PROMORATECODE
    4. Replace both RATECODE and PROMORATECODE with the correct codes in capital letters.
    5. Example: /rates/WINTERSALE?&promoRateCode=HOLIDAY25
  4. Promo Rates with Specific Dates
    1. If a promo rate must also land on specific dates, combine both the date range and promo code in the URL:
    2. /rates/RATECODE?fromDate=YYYY-MM-DD&toDate=YYYY-MM-DD&promoRateCode=PROMORATECODE
    3. Example: /rates/WINTERSALE?fromDate=2025-12-01&toDate=2025-12-31&promoRateCode=HOLIDAY25
  5. Example Use Case
    1. If you want to link directly to an Executive Room without any guest restrictions:
    2. https://example.onejourney.travel/rooms/EXEC
    3. If the same room requires a minimum of 4 guests:
    4. https://example.onejourney.travel/rooms/EXEC&adults=4&children=0

🧠 Important Note

  1. Always ensure that the room, rate, and promo rate codes are entered exactly as they appear in your ecommerce platform.
  2. Using incorrect codes or date formats may result in the link showing the room or rate as unavailable.


    • Related Articles

    • Ecommerce Platform | Content best practice tips

      Rooms Ensure each room type is represented by a minimum of three high-quality images. Confirm that rate images accurately represent the rate/package inclusions. Present room features using concise bullet points for clarity. Set up room upgrades ...
    • Ecommerce Platform | Rates | Set up a minimum lead time restriction

      You may want to set up a minimum lead time restriction for your rates. For example, you have a rate that includes an experience and you'd like some extra time to schedule or prepare this for the guest. How to set up a minimum lead time restriction in ...
    • Ecommerce Platform | Creating and editing announcements

      ? Summary This article guides you through creating, editing, and deleting announcements on your ecommerce platform. Announcements allow you to share important updates with guests via banners or pop-ups on your storefront. ❓ Likely Scenario You might ...
    • Ecommerce Platform | Rooms: payment options

      Overview By default, ecommerce platform sites are set up to take full payment at the point of placing the order. However, Journey's ecommerce platform can take a deposit or defer the payment for a room (or spa). Card information is stored securely in ...
    • Ecommerce Platform | SynXis | Rate/room images

      If you need assistance adding images for a room or a rate, please reach out to your account manager at your SynXis reseller. Or search in the help guides within your SynXis CRS. Please ensure no special characters are used in the file name (for your ...