Manage My Booking (MMB) permet aux clients de :

modifier les dates de visite / horaires de visite
choisir une date pour les réservations à date ouverte ou les packages multi-dates
annuler des réservations.

📒 REMARQUE

Nous ajoutons continuellement de nouvelles fonctionnalités au portail Manage My Booking. Les fonctionnalités listées ici sont incluses dans la version initiale du MMB remanié. D’autres mises à jour sont à venir.

Prévisualiser Manage My Booking

Vous pouvez explorer le portail Manage My Booking en utilisant votre propre apiKey.

Utilisez la structure d’URL suivante pour accéder au portail MMB de votre web checkout :

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

📒 REMARQUE

Remplacez {apikey} par votre clé API réelle. Si vous ne savez pas où la trouver, consultez Localiser la clé API pour Web Checkout et MMB.

Implémenter Manage My Booking (MMB)

Comme le widget de checkout, le portail peut être intégré directement dans votre page ou ouvert dans une fenêtre pop-up

Prérequis :

Assurez-vous que le nouveau script de checkout est implémenté sur les pages HTML de votre site.

📗 ASTUCE
Pour plus de détails, consultez notre guide d’implémentation.

Par défaut, le widget recherche tout élément avec :

ventrata-manage-my-booking

et affiche le portail dans cet élément (mode intégré).

Mode intégré

Utilisez ce mode pour afficher le portail MMB directement sur votre page.

Exemple :

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

Résultat :

Le portail se charge dans la balise <div> et fait partie de la mise en page.

Mode pop-up

Pour ouvrir le portail sous forme de pop-up lors d’un clic, définissez :

popup: true

or

embedded: false

L’élément devient alors un déclencheur (clic) au lieu d’un conteneur.

Exemple :

<button ventrata-manage-my-booking data-config='{ "popup": true }'>
  Gérer ma réservation
</button>

Résultat :

Le clic ouvre le portail MMB en pop-up.

Ce mode est utile lorsque vous ne souhaitez pas intégrer le portail complet dans la page (ex. header, footer, bouton simple).

Ouvrir MMB avec JavaScript

En plus d’utiliser l’attribut HTML ventrata-manage-my-booking, le portail Manage My Booking (MMB) peut également être ouvert via JavaScript.

Cela fonctionne de la même manière que la méthode window.Ventrata() du checkout, mais ouvre le portail Manage My Booking à la place.

Ouvrir MMB en pop-up

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

Cela ouvre immédiatement le portail MMB dans une fenêtre pop-up.

Intégrer MMB à un emplacement spécifique de la page

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

Cela ouvre immédiatement le portail MMB dans une fenêtre pop-up.

Diriger un client vers sa réservation

Vous pouvez diriger un client vers une réservation spécifique dans le portail MMB en incluant sa référence de réservation et son nom de famille dans une URL ou un appel JavaScript. Cela permet de contourner l’étape de connexion et d’ouvrir directement le portail avec la réservation déjà chargée.

Via URL
Utilisez la structure d’URL suivante pour ouvrir le portail MMB sur une réservation spécifique :
```
https://checkin.ventrata.com/{CHECKOUT_API_KEY}/en/checkin?checkin[reference]={BOOKING_REFERENCE}&checkin[verification]={LASTNAME}
```
Remplacez les paramètres suivants par les valeurs réelles :
- CHECKOUT_API_KEY — votre clé API Checkout
- BOOKING_REFERENCE — la référence de réservation du client
- LASTNAME — le nom de famille du client
Si la réservation présente un solde dû, le client verra un bouton lui permettant de payer le montant restant.
Via JavaScript
Vous pouvez également transmettre les détails de réservation par programmation via la méthode window.VentrataManageMyBooking().
Cela ouvre le portail MMB et connecte automatiquement le client :
```
window.VentrataManageMyBooking({   
  apiKey: "CHECKOUT_API_KEY",   
  popup: true,   
  checkin: {     
     reference: "BOOKING_REFERENCE",
     verification: "LASTNAME"
   }
 })
```
Remplacez les paramètres suivants par les valeurs réelles :
- CHECKOUT_API_KEY — votre clé API Checkout
- BOOKING_REFERENCE — la référence de réservation du client
- LASTNAME — le nom de famille du client

Modes clair / sombre

Le portail MMB prend en charge les modes clair et sombre.

Le mode clair est utilisé par défaut.
Pour activer le mode sombre, ajoutez "defaultTheme": "dark" dans l’attribut data-config du script de checkout.

Clair

Sombre

📗 ASTUCE

Apprenez á configurer les couleurs du checkout.

Se connecter au portail MMB

Les clients peuvent se connecter en utilisant l’une des méthodes suivantes afin d’accéder à toutes leurs réservations, passées et en cours :

E-mail - saisissez l’adresse e-mail fournie lors de la réservation. Cliquez sur le bouton Send verification code (Envoyer le code de vérification), puis saisissez le code de vérification à 6 chiffres envoyé à cette adresse.
Booking reference (Référence de réservation) - saisissez la référence de réservation ainsi que le nom de famille associé, puis cliquez sur le bouton Verify (Vérifier) pour vous connecter.

Manage My Booking - Log In (Connexion)

Présentation de MMB

Les clients peuvent consulter et gérer en une seule fois toutes les réservations associées à la même adresse e-mail :

Éléments de MMB

#	Éléments	Description
1.	Icône utilisateur	Cliquez pour accéder aux paramètres de langue ou vous déconnecter de votre compte.
2.	Upcoming Bookings (Réservations à venir) / Past Bookings (Réservations passées)	Affiche toutes les réservations à venir. / Affiche toutes les réservations passées.
3.	Réservations individuelles	Affiche les réservations individuelles achetées par le client : nom du produit, référence de réservation, nombre et type de billets, ainsi que la date de visite.
4.	Éléments d'étiquette	Affiche le statut de la réservation lorsqu'un paiement est dû ou lorsque la réservation a été annulée.

Le portail MMB est également accessible sur téléphone mobile :

Vue mobile

Détail de la réservation

Sélectionnez une réservation individuelle pour afficher davantage d'informations et accéder aux options de gestion de la réservation :

Détail de la réservation

#	Éléments de la réservation	Description
1.	Icône utilisateur	Cliquez pour accéder aux paramètres de langue ou vous déconnecter de votre compte.
2.	Requirements (Exigence)	Effectuez les actions obligatoires avant d'accéder à l'attraction. Sign Waiver (Signer les décharges) Paid Unpaid Balance (Payer un solde impayé)
3.	Booking Management (Gestion de la réservation)	Modifiez la réservation si cela est autorisé. Reschedule Booking (Reprogrammer la réservation) Cancel Booking (Annuler la réservation)
4.	Add-ons (Extras)	Sélectionnez des options de surclassement si elles sont disponibles pour la réservation. Available Upgrades (Surclassements disponibles)
5.	Your ticket (Vos billets)	Accédez aux billets du client une fois la réservation payée. Download Tickets (Télécharger les billets) Resend Confirmation (Renvoyer la confirmation) Add to Apple Wallet (Ajouter à Apple Wallet) Add to Google Wallet (Ajouter à Google Wallet)
6.	Nom de la réservation et du billet	Nom du produit et de l'option achetés.
7.	Booking reference (Référence de réservation)	Identifiant unique de la réservation.
8.	Tickets (Billets)	Nombre et type de billets.
9.	Date and Time (Date et heure)	Date et heure de la réservation.
10.	Instructions	Informations concernant le point de rendez-vous ou autres instructions importantes.
11.	Redemption (Utilisation)	Instructions relatives à l'utilisation de la réservation.
12.	Your invoice (Votre facture)	Informations de paiement.
13.	Download invoice (Télécharger la facture)	Cliquez pour accéder à la facture imprimable.

Si une réservation est annulée, le détail de la réservation affiche l'horodatage de l'annulation ainsi que la facture d'avoir, le cas échéant.

Horodatage de l'annulation

Invoice (Facture) / Payment (Paiement) / Refund (Remboursement)

Reprogrammer une réservation

Le flux de reprogrammation permet aux clients de modifier la date et l’heure de visite d’une réservation active.

Choisir une date pour une réservation à date ouverte

Pour les réservations à date ouverte, les clients peuvent sélectionner une date et une heure de visite après l’achat.

Gérer une réservation multi-dates

Les packages multi-dates permettent aux clients de sélectionner une date et une heure de visite pour chaque inclusion du package. La période est définie par le paramètre « Validity Days (Jours de validité) ».

Reprogrammer un package multi-dates (type Pass)

Modifier la date et l’heure de chaque inclusion d’un pass multi-dates.

Reprogrammer un package multi-dates (type non-Pass)

Modifier la date et l’heure des inclusions interdépendantes d’un package multi-dates.

Annuler

Les clients peuvent annuler des réservations qui n’ont pas encore été utilisées, dont la date ou l’heure de visite n’est pas dépassée, et qui respectent le délai ou la période limite d’annulation.

Payer un solde impayé

Le flux Payer le solde impayé permet aux clients de régler tout montant restant dû.

Valider un bon revendeur

Les clients peuvent sélectionner leur date et heure préférées afin de valider un bon revendeur acheté précédemment.

Signer les décharges

Permettez aux clients de consulter et de signer les décharges obligatoires avant leur visite à l’aide du portail libre-service Manage My Booking (MMB).

Comment implémenter et utiliser le nouveau portail Manage My Booking (MMB)

Prévisualiser Manage My Booking

Implémenter Manage My Booking (MMB)

Mode intégré

Mode pop-up

Ouvrir MMB avec JavaScript

Diriger un client vers sa réservation

Modes clair / sombre

Se connecter au portail MMB

Présentation de MMB

Détail de la réservation

Reprogrammer une réservation

Choisir une date pour une réservation à date ouverte

Gérer une réservation multi-dates

Reprogrammer un package multi-dates (type Pass)

Reprogrammer un package multi-dates (type non-Pass)

Annuler

Payer un solde impayé

Valider un bon revendeur

Signer les décharges