{"id":"ibe.deep-links","app":"ibe","title":"Pre-filled search and versioned booking-flow links","summary":"Pass dates and selections to the booking engine using the supported URL contract.","url":"https://www.simultem-apps.com/wiki/ibe#deep-links","apiUrl":"https://www.simultem-apps.com/api/wiki/v1/articles/ibe.deep-links","resourceUri":"wiki://ibe/deep-links","revision":"2026-11-02.1","lastReviewedAt":"2026-11-02","keywords":["flowVersion","flow","startSearch","arrival","departure","childrenAges","checkout"],"sections":[{"title":"Create a basic link","steps":["Start from the generated URL for the intended IBE ID.","Add flowVersion=1 with arrival, departure, adults, childrenAges, rooms and promoCode as needed.","Use startSearch=true to run the pre-filled search automatically.","Test the resulting dates, children’s ages, room count and promo behavior in the actual widget."],"notes":[],"example":"?ibeId=YOUR_IBE_ID&flowVersion=1&arrival=2027-05-10&departure=2027-05-12&adults=2&childrenAges=5,7&rooms=1&startSearch=true"},{"title":"Advanced flow state","steps":["Use the versioned flow payload for supported stages: search, results, property, offers, services or checkout.","Encode structured version-1 JSON as base64url in the flow parameter when passing selections, filters or per-offer services.","Allow the engine to revalidate offers and availability when the link opens."],"notes":["Unsupported explicit flow versions are rejected. Confirmation is not a public flow stage; it requires a server-backed order and payment evidence."]}],"text":"# IBE: Pre-filled search and versioned booking-flow links\n\nPass dates and selections to the booking engine using the supported URL contract.\n\n## Create a basic link\n\n1. Start from the generated URL for the intended IBE ID.\n\n2. Add flowVersion=1 with arrival, departure, adults, childrenAges, rooms and promoCode as needed.\n\n3. Use startSearch=true to run the pre-filled search automatically.\n\n4. Test the resulting dates, children’s ages, room count and promo behavior in the actual widget.\n\nExample:\n\n```text\n\n?ibeId=YOUR_IBE_ID&flowVersion=1&arrival=2027-05-10&departure=2027-05-12&adults=2&childrenAges=5,7&rooms=1&startSearch=true\n\n```\n\n## Advanced flow state\n\n1. Use the versioned flow payload for supported stages: search, results, property, offers, services or checkout.\n\n2. Encode structured version-1 JSON as base64url in the flow parameter when passing selections, filters or per-offer services.\n\n3. Allow the engine to revalidate offers and availability when the link opens.\n\nNote: Unsupported explicit flow versions are rejected. Confirmation is not a public flow stage; it requires a server-backed order and payment evidence.","related":[{"id":"ibe.search-and-filters","app":"ibe","title":"Search fields, filters, prices and booking modes","summary":"Control how guests find offers and move through the booking journey.","url":"https://www.simultem-apps.com/wiki/ibe#search-and-filters","apiUrl":"https://www.simultem-apps.com/api/wiki/v1/articles/ibe.search-and-filters","resourceUri":"wiki://ibe/search-and-filters","revision":"2026-11-02.1","lastReviewedAt":"2026-11-02"},{"id":"ibe.services","app":"ibe","title":"Extra services and reservation-specific service links","summary":"Offer suitable services during booking or through a signed link for an existing reservation.","url":"https://www.simultem-apps.com/wiki/ibe#services","apiUrl":"https://www.simultem-apps.com/api/wiki/v1/articles/ibe.services","resourceUri":"wiki://ibe/services","revision":"2026-11-02.1","lastReviewedAt":"2026-11-02"}]}