Booking Widget URL Parameters When Using a Subdomain
URL parameters refer to variables (strings) added to the end of a URL.
By placing links with specific URL parameters on your website, you can launch various views of the reservation widget.
If you're using a custom subdomain for your reservation widget, please use the parameters listed on this page.
What is {code} in a parameter?
{code} should be replaced with your property's unique tripla bot code.
You can find it in the Property Management Screen → tripla Setup, inside the data-triplabot-code="" field.
Example:<script async src="https://tripla.jp/sdk/javascript/tripla.min.js" data-triplabot-code="0193853c-9dc4-79bf-85ed-59286b03018f"></script>
For member program login
Use a URL with a subdomain/sign-in?code={code}
Examples：https://booking.tripla-ryokan.com/sign-in?code=0193853c-9dc4-79bf-85ed-59286b03018f
※ This does not work with non-subdomain URLs such as:
Format for Numbers, Strings, and Dates
When using parameters that require numbers, text, or dates, use the following formats:
Number | # |
Text | xxx |
Date | yyyy/mm/dd |
| tripla bot code | code |
Item | Usage | Parameter |
Booking Widget | Open | /booking/result?code={code} |
| View/cancel | /search?code={code} | |
| Include unavailable rooms | /booking/result?code={code}&is_including_occupied=true | |
| Show only available rooms | /booking/result?code={code}&is_including_occupied=false | |
| Day-use plan (Not supported by Neppan/Rakutsuu) | /booking/result?code={code}&is_day_use=true | |
| Room type | Show room types | /booking/result?code={code}&type=rooms |
Specify multiple room types (comma-separated) Only the first room's availability is shown in the calendar. | /booking/result?code={code}&room_type_codes=xxx,xxx,xxx | |
| Plan | Show all plans | /booking/result?code={code}&type=plan |
Specify multiple plans | /booking/result?code={code}&hotel_plan_codes=xxx,xxx,xxx | |
| Show secret mode plan | /booking/result?code={code}&hotel_plan_code=xxx&mode=secret | |
Dynamic Package | Show only dynamic package plans | /booking/result?code={code}&dynamic_package=wbf |
Membership | Password reset | /forgot-password?code={code} |
| Member login | /sign-in?code={code} | |
| Member registration | /sign-up?code={code} | |
Launch while logged in (API only) | Launch with member logged in ※ Specify one_time_access_token, which is the one-time access token returned by the API. (The one-time access token becomes invalid after a single use or after 5 minutes.) | /booking/result?code={code}&one_time_access_token=xxx |
| Corporate (Organization) | Corporate login | /organization-sign-in?code={code} |
Corporate login (with organization_id) Valid only when using a URL referrer ※For more details about organization_id, please refer to [this guide]. | /organization-sign-in?code={code}&organization_id=id | |
| Filter | Apply multiple filters | /booking/result?code={code}&filter=xxx,xxx |
| Promotion | Apply coupon code | /booking/result?code={code}&coupon_code=xxx |
| Sort Order | Recommended order | /booking/result?code={code}&order=recommended |
| Price: Low to High | /booking/result?code={code}&order=price_low_to_high | |
| Price: High to Low | /booking/result?code={code}&order=price_high_to_low | |
| Date | Specify check-in/check-out dates | /booking/result?code={code}&checkin=yyyy/mm/dd&checkout=yyyy/mm/dd |
Undated search (only valid when not using child tiers, e.g., with TL-Lincoln) | /booking/result?code={code}&search_type=undated ＊If 2 nights：/booking/result?code={code}&search_type=undated&nights=2 | |
| Guest Count | Adults only | /booking/result?code={code}&adults=# |
Adults + Children (with Kids tier) | /booking/result?code={code}&adults=2&kids_tiers=[{"code":"A","children":#},{"code":"B","children":#},{"code":"B2","children":#},{"code":"C","children":#},{"code":"D","children":#}] | |
Bed-sharing children only (no categories) | /booking/result?code={code}&rooms=[{"adults":#, "children": #},{"adults":#, "children": #}] | |
| Voucher | Voucher | /booking/result?code={code}=voucher |
| Language | Set display language | /booking/result?code={code}&locale=en en: English ja: Japanese ko: Korean zh_Hans: Simplified Chinese zh_Hant: Traditional Chinese |
For Brands Using a Brand-Level Reservation Widget (e.g., Hotel Chains)
Item | Usage | Parameter |
Brand Booking Widget | Show facility list page | facilities?code={code} |
To enable Brand Facility Settings, go to:
Property Management Screen → Admin Settings → tripla Setup → Brand setting
To add properties to the facility list, go to:
Brand Management Screen → Settings → Booking Engine → Facility Display Settings,
check the properties you want to show, and click Save.
Related Articles
Booking Widget URL Parameters
A URL parameter refers to a variable (string) added to the end of a URL. By placing links with specific URL parameters on your website, you can launch various views of the booking widget. All standard URL parameters can be used even when using a ...Call the booking widget from an existing search panel
This setting should be configured by the website administrator. If you are not using tripla's default search panel and have your own custom design or an existing search panel, you can launch the booking widget using a JavaScript function. ...Corporate Membership Program
By using the corporate (organization) membership program, companies with corporate contracts can make reservations on a dedicated page. See here for how to add corporate (organization). ⏱ Estimated time: about 30 minutes. Difference from Individual ...Search Bar and Availability Search Screen Settings
※This setting is intended for your website administrator. This section is for installing the accommodation plan search screen (Booking Widget) and search bar on your website. In addition to the search bar provided by tripla, it is also possible to ...GA4 Setup Guide
Required Pre-Setup Items tripla Book settings must be completed. Subdomain settings must be configured. A Google Analytics 4 (GA4) account must be created. A Google Tag Manager (GTM) account and container must be created. GA4 measurement settings ...