Otipass est une plateforme française de dématérialisation des pass territoriaux, qui fait fonctionner des cartes touristiques, culturelles, jeunesse et citoyennes pour plus de quarante villes et régions, dont Lyon, Toulouse, Bordeaux, Nantes, Helsinki et Matera, et qui est vendue aux offices de tourisme et aux collectivités. Pour les opérateurs, elle apporte des détenteurs de pass officiels de villes et de régions qui ont prépayé un ensemble d'entrées et choisissent les sites une fois sur place, les musées, monuments et attractions locales constituant l'essentiel de l'offre.
Connecter OTIPASS à Ventrata vous permet de scanner, contrôler et valider les pass OTIPASS à votre entrée, sur les tourniquets, bornes, terminaux de point de vente propulsés par Ventrata, sur l'application mobile ou dans le Ventrata Dashboard, sans application OTIPASS distincte.
Pour en savoir plus sur OTIPASS, rendez-vous sur otipass.com.
Site web principal | |
Tags | Multi-Attraction Pass |
Type de connexion | Validation des pass : vous scannez les pass OTIPASS à votre entrée |
Fonctionnalités de la connexion | Product Mapping · Redemption Sync · Pass Walkup Scanning Sync |
Développé par | Ventrata (via l'API Otipass) |
Cette connexion vous permet de :
Scanner ou saisir un numéro de pass OTIPASS dans Ventrata et le vérifier auprès d'OTIPASS en temps réel pour votre service.
Créer automatiquement une réservation dans Ventrata pour chaque pass valable.
Enregistrer l'entrée auprès d'OTIPASS au moment où vous scannez.
Fonctionnement
Le personnel scanne ou saisit un numéro de pass.
Si le pass a déjà une réservation active, Ventrata la renvoie.
Sinon, Ventrata envoie une requête d'entrée (query entry) à OTIPASS pour votre service (ID Service) afin de vérifier le pass.
Si le pass est valable, Ventrata envoie un enregistrement d'entrée (record entry) à OTIPASS.
Si OTIPASS confirme, Ventrata enregistre une réservation à date ouverte pour 1 unité du produit, de l'option et de l'unité mappés à la connexion.
📒 REMARQUE
Tout code non vide est vérifié auprès d'OTIPASS ; il n'y a pas de filtre de format.
Créer la connexion OTIPASS
🔐 Autorisations de rôle requises : See Connections, Modify Connections
Avant de commencer :
Munissez-vous de votre OTIPASS ID, de votre OTIPASS Api Key et de votre OTIPASS ID Service.
Créez OTIPASS en tant que revendeur dans Ventrata et sélectionnez-le sur la connexion. Le formulaire indique le champ Revendeur (Reseller) comme facultatif, mais il est nécessaire pour les recherches.
Prévoyez une connexion par service OTIPASS que vous acceptez.
Créer la connexion
Sélectionnez votre revendeur OTIPASS.
Saisissez l'OTIPASS ID, l'Api Key et l'ID Service.
Enregistrez. Ventrata vérifie les identifiants et crée une seule ligne de mappage pour le service.
Le formulaire de connexion comporte les options suivantes :
Reseller | Le revendeur sous lequel les réservations OTIPASS sont enregistrées. Facultatif dans le formulaire, mais nécessaire en pratique pour les recherches. |
OTIPASS ID / OTIPASS Api Key | Obligatoires. Vérifiés à chaque enregistrement par une requête de test envoyée à OTIPASS ; en cas d'échec, le message d'OTIPASS s'affiche et les trois champs sont marqués comme non valides. |
OTIPASS ID Service | Obligatoire. L'unique service OTIPASS pour lequel cette connexion vérifie et valide les pass. Il devient aussi le titre de l'unique ligne de mappage de la connexion. |
Mapper les produits
Chaque connexion a exactement une ligne de mappage, créée ou mise à jour à chaque enregistrement.
Ouvrez la connexion et sélectionnez la ligne de mappage.
Choisissez le produit, l'option et l'unité Ventrata à réserver. L'option et l'unité sont obligatoires.
📒 REMARQUE
Pour accepter plusieurs services OTIPASS, créez une connexion par service.
📒 REMARQUE
Tant que la ligne n'est pas mappée, les scans échouent avec « is not mapped in ».
Redemption
Immédiatement : toujours. Ventrata enregistre l'entrée auprès d'OTIPASS au moment du scan ; la réservation n'est enregistrée que si OTIPASS confirme.
Lors de la validation ou de la non-présentation : non pris en charge.
Ce qui est envoyé à OTIPASS : un enregistrement d'entrée pour le pass et le service, avec la date à l'heure locale Europe/Paris.
Fonctionnalités de la connexion en détail
Cette section s'adresse à ceux qui veulent les détails. Cliquez sur une ligne pour voir comment fonctionne chaque fonctionnalité.
Product Mapping | ✅ |
Vous mappez chaque offre de pass OTIPASS à un produit Ventrata dans le Ventrata Dashboard. Chaque connexion a exactement une ligne de mappage, créée ou mise à jour à chaque enregistrement. Pour accepter plusieurs services OTIPASS, créez une connexion par service. Tant que la ligne n'est pas mappée, les scans échouent avec « is not mapped in ». |
Content Sync | ❌ |
Le contenu des produits n'est pas synchronisé. OTIPASS vend son propre pass. Vos produits et leur contenu restent dans Ventrata. |
Availability Sync | ❌ |
Vos disponibilités ne sont pas partagées avec OTIPASS. Il n'y a aucun échange de disponibilités ni de capacité avec OTIPASS. |
Pricing Sync | ❌ |
Les prix ne sont pas synchronisés avec OTIPASS. La réservation utilise le prix unitaire Ventrata et est réglée par bon. Aucun prix n'est envoyé à OTIPASS. |
Promotions Sync | ❌ |
Les promotions ne s'appliquent pas aux pass OTIPASS. Vos promotions Ventrata ne s'appliquent pas aux réservations créées en scannant un pass. |
Bookings Sync | ✅ / ❌ |
Limité : les réservations ne sont créées que lorsqu'un pass est scanné. Une réservation à date ouverte par pass, avec une quantité de 1 pour l'unité mappée, créée au moment du scan. Il n'y a pas d'appel d'annulation vers OTIPASS. |
Pickups/Dropoff Sync | ❌ |
Ne fait pas partie de cette connexion. Les validations de pass ne comportent pas de prise en charge. |
Custom Questions Sync | ❌ |
Ne fait pas partie de cette connexion. Les questions de réservation ne sont ni posées ni envoyées pour les validations de pass. |
Extras Sync | ❌ |
Ne fait pas partie de cette connexion. Aucun extra ne peut être ajouté à une validation de pass. |
Redemption Sync | ✅ |
Les validations sont envoyées à OTIPASS. Toujours. Ventrata enregistre l'entrée auprès d'OTIPASS au moment du scan ; la réservation n'est enregistrée que si OTIPASS confirme. Non pris en charge. Un enregistrement d'entrée pour le pass et le service, avec la date à l'heure locale Europe/Paris. |
Pass Walkup Scanning Sync | ✅ |
Vous scannez les pass OTIPASS à votre entrée. Le personnel scanne ou saisit un numéro de pass. Si le pass a déjà une réservation active, Ventrata la renvoie. Sinon, Ventrata envoie une requête d'entrée (query entry) à OTIPASS pour votre service (ID Service) afin de vérifier le pass. |
Gift Card Sync | ❌ |
Ne fait pas partie de cette connexion. Les pass OTIPASS ne sont pas des cartes cadeaux Ventrata. |
✅ pris en charge · ✅ / ❌ limité · ❌ non pris en charge
Bon à savoir : limites de cette connexion
Bon à savoir : limites de cette connexion
Un service OTIPASS par connexion, mappé à un seul produit, une seule option et une seule unité.
Les pass adulte et enfant ne peuvent pas être distingués au sein d'un même service.
Tout code non vide scanné peut être envoyé à OTIPASS, y compris les codes destinés à d'autres connexions.
La validation ne peut pas être différée à l'admission ou à la non-présentation.
Pas de prise en charge, d'extras, de questions personnalisées ni de ressources.
Les résultats de recherche sont mis en cache pendant 5 minutes, et un délai d'attente dépassé est traité comme une carte introuvable.
Dépannage
« %{title} is not mapped in %{connection} »
« %{title} is not mapped in %{connection} »
Aucun produit, option ni unité Ventrata n'est mappé sur la ligne ID Service de la connexion. Mappez la ligne sur la connexion, puis scannez à nouveau.
« Redemption not allowed »
« Redemption not allowed »
FAQ
Comment accepter les pass de plusieurs services OTIPASS ?
Comment accepter les pass de plusieurs services OTIPASS ?
Créez une connexion distincte pour chaque ID Service d'OTIPASS et mappez chacune à son propre produit, sa propre option et sa propre unité.
Ressources utiles
📚 En savoir plus sur les connexions Ventrata
Informations sur le partenaire
OTIPASS SAS
8 rue du 45e Regiment de Transmissions, batiment Le Septan, entree A, 26200 Montelimar
France
ID partenaire Ventrata : 55b217b2-35ea-454c-ac15-4630ef1cd0b9