Skip to main content

easy to travel widget integration guide

Overview​

This documentation explains how to embed the Easy to Travel booking widget into web pages using IFRAME elements with specific attributes.

Key iframe attributes​

The widget requires four main attributes:

  • src — Widget URL with widgetID (e.g., W-ao8htiwckg3q)
  • width — Widget width specification
  • height — Widget height specification
  • allow — Set to "payment" for payment processing capability

Integration methods​

#1 Fixed dimensions​

Uses a set pixel width (e.g., 500px) while height scales to 100%.

<iframe allow="payment" height="100%" src="https://sandbox-widget.easyto.travel/W-ao8htiwckg3q" style="border: none" width="500px"></iframe>

Fixed width example

#2 Fluid full screen​

Stretches to occupy entire viewport with width and height both at 100%.

<iframe allow="payment" height="100%" src="https://sandbox-widget.easyto.travel/W-ao8htiwckg3q" style="border: none" width="100%"></iframe>

Fluid full screen example

#3 Fluid with custom markup​

Allows integration of header and footer elements alongside the widget.

<header><p>Your header</p></header>

<iframe allow="payment" height="100%" src="https://sandbox-widget.easyto.travel/W-ao8htiwckg3q" width="100%"></iframe>

<footer><p>Your footer</p></footer>

Fluid width with custom markup example

#4 Inline​

<iframe allow="payment" height="700px" src="https://sandbox-widget.easyto.travel/W-ao8htiwckg3q" width="500px"></iframe>

Configuration options​

Configure the widget by modifying the src URL. These options can be combined in a single URL.

Airport​

Add the IATA airport code to the URL path to preset search results:

https://sandbox-widget.easyto.travel/W-ao8htiwckg3q/dxb

Currency​

Use the currency GET parameter to set the default currency:

https://sandbox-widget.easyto.travel/W-ao8htiwckg3q/?currency=USD

Language​

Use the language GET parameter to open the widget in a language:

https://sandbox-widget.easyto.travel/W-ao8htiwckg3q/?language=uk

The value is a BCP 47 language tag, such as uk, de, pt-BR or zh-Hant. Case does not matter, and _ can stand for -: DE and pt_br work too.

The language must be one of the widget's available languages. Any other value is ignored: the widget opens in the language a signed-in customer chose last time, or in its default language.

Combined example​

<iframe allow="payment" height="100%" src="https://sandbox-widget.easyto.travel/W-ao8htiwckg3q/DXB?currency=GBP&language=de" width="100%"></iframe>

Example with widget configuration

Apple Pay and Google Pay support​

Apple Pay and Google Pay integration requires two conditions:

  1. Embed the widget on the main domain or a dedicated subdomain.
  2. Contact the ETT manager to register your domain.