GuestCentric Support PageGuestCentric Support Page

menutoggle

How to develop a custom hotel Booking Engine URL

HOME > SETUP AREA > How to develop a custom hotel Booking Engine URL?

We have improved the ability to filter information in the hotel booking engine by creating a custom URL. The complete list of supported parameters below.

If you are a developer and need to created a fully customised booking widget for your client/hotel website, please use the parameters bellow to build a custom URL to the GuetCentric's booking gadget.

Mandatory Parameters

  • Booking engine secured URL
    https://secure.guestcentric.net/api/bg/book.php
  • API key - You can get it by navigating to ters Setup > External Booking Engine
    API key: &apikey=someApiKey

Default Parameters

User can configure the default values for the booking engine here.

  • Check-in: today's date
  • Check-out: after tomorrow's date
  • Number of nights: 2
  • Amount (number of rooms): 1
  • Number of Adults per room: 1
  • Number of Children per room: 0

Optional Parameters

Reservation data

  • Check-in - the selection time frame start day, should be in the yyyy-mm-dd format
    &startDay=2018-02-28
  • Number of nights – the number of nights
    &nrNights=4
  • Amount (number of rooms)
    &amount=1
  • Number of Adults per room
    &nrAdults=2
  • Number of Children per room
    &nrChildren=1

Booking engine display

  • Language
    langCode = [br /> bg (Bulgarian)
    ca (Catalan)
    da (Danish)
    fi (Finnish)
    fr (French)
    de (German)
    el (Greek)
    it (Italian)
    lv (Latvian)
    zh-CN (Mandarin Chinese)
    pl (Polish)
    br (Portuguese BR)
    pt (Portuguese PT)
    ro (Romanian)
    ru (Russian)
    sk (Slovak)
    es (Spanish)
    sv (Swedish)
    tr (Turkish)]


    &l=[langCode]
  • Preselected room/promo - you can get room/promo ID, check here
    &preselect=[offerID]
  • Promo code:
    &pc=[promocode]
  • Preselecting promo code
    &preselectpc=[promocode]
  • Filter offers
    & flterOffers=[rooms, promotions, all]
  • Products (vouchers) - to open products on Booking Engine.
    &products=true

Workflow

  • Thank-you page, is the URL of the page to be shown after the confirmation screen
    &thankyouUrl=http://someurl.com
  • Cancel page URL, is the URL to be shown when not completing a booking
    &url=http://someurl.com
  • Not opening mobile booking engine
    &noredirect=true

Reporting

  • Channel Key that is used for reporting when bookings are completed
    &channelKey=[someChannelKey]
  • Referrer
    &r=[someReferrer]

Example of use

  • URL
    https://secure.guestcentric.net/api/bg/book.php?apikey=f5b9adf0aa28b7b8b2b62ebe9fc0b20b&l=en&startDay=2012-07-20&nrAdults=1&nrNights=3
  • Create your link here