Skip to main content

How to Implement and Use the New Manage My Booking (MMB) Portal

The Manage My Booking (MMB) portal gives customers a self-service way to manage their bookings

Updated over a week ago

Manage My Booking (MMB) allows customers to

  • change travel dates / tour times,

  • choose a date for an open-dated bookings or multi-date packages,

  • cancel bookings.

📒 NOTE

We are constantly adding new features to the Manage My Booking portal. The features listed here are included in the initial release of the revamped MMB. Stay tuned for more updates.


Preview Manage My Booking

You can explore the Manage My Booking portal using your own apiKey.

Use the following URL structure to access your web checkout's MMB portal:

https://checkin.ventrata.com/{apikey}

📒 NOTE

Replace the {apikey} with your actual API key. If you are not sure where to find it, see Locate API Key for Web Checkout and MMB.


Implement Manage My Booking (MMB)

Like the checkout widget, the portal can be can appear embedded directly on your page or open in a popup.

Prerequisites:

By default, the widget looks for any element with:

ventrata-manage-my-booking

and renders the portal inside that element (embedded mode).


Embedded Mode

Use embedded mode when you want the full MMB portal to appear directly on your webpage.

Example:

 <div ventrata-manage-my-booking data-config='{}'></div>

Result:

The portal loads inside the <div> and becomes part of the page layout.


Pop-up Mode

If you want the MMB portal to open as a pop-up when a user clicks a button or link, set:

  • popup: true

    or

  • embedded: false

In this case, the element becomes a click target instead of a container, and the portal appear in a pop-up overlay.

Example:

<button ventrata-manage-my-booking data-config='{ "popup": true }'>
Manage my booking
</button>

Result:

Click the button opens the MMB pop-up.

This is useful for pages where you do not want to allocate space for the full embedded portal—such as headers, footers, or simple “Manage my booking” buttons.


Open MMB with JavaScrip

In addition to using the ventrata-manage-my-booking HTML attribute, the Manage My Booking (MMB) portal can also be opened using JavaScript.

This works in the same way as the Checkout window.Ventrata() method, but opens Manage My Booking instead.

  • Open MMB in a pop-up

    window.VentrataManageMyBooking({   
    apiKey: "YOUR_API_KEY",
    popup: true
    })

    This immediately opens the MMB portal in a popup.

  • Embed MMB in a specific page location

    window.VentrataManageMyBooking(   
    { apiKey: "YOUR_API_KEY" },
    { targetElement: document.getElementById("my-mmb-element") }
    )

    This renders the MMB portal directly inside a chosen element on the page.


Light / Dark Modes

The MMB portal supports light and dark modes.

  • Light is the default.

  • To enable dark mode, insert "defaultTheme": "dark" into the data-config attribute of the checkout script.

Light

Dark


Log into MMB

Customers can login is using one of the following methods to access all active and expired bookings:

  • E-mail - enter the email address provided at the time of booking. Press the Send verification code button, then enter the 6-digit verification code sent to that email address.

  • Booking reference - enter the booking reference and last name from the booking, then press the Verify button to log in.

Manage My Booking - Log In


Reschedule Booking

The Reschedule Flow allows customers to change the date and tour time of an active booking.


Pick a Date on an Open-Dated Booking

For open-date bookings, customers can be select a tour date and time after purchase.


Manage Multi-Date Booking

Multi-date packages allow customers to select a tour date and time for each include in the package. The time frame is defined by the 'Validity Days' setting.


Reschedule Multi-Date Package (Pass Type)

Change the date and time of each include of a multi-date pass.


Cancel

Customers can cancel bookings that have not been redeemed yet, are not past the tour date or time and are within the cancellation notice or cutoff period.


Pay Unpaid Balance

The Pay Unpaid Balance flow allows customers to settle any outstanding payment.

Did this answer your question?