CityPASS est un pass multi-attractions qui regroupe l'entrée à un ensemble fixe d'attractions phares dans dix-sept destinations nord-américaines, de New York, Chicago et Boston à Toronto, Orlando et la Californie du Sud, à un prix unique réduit, vendu via la publicité grand public, les professionnels du voyage, les hôtels et les affiliés. Pour les opérateurs, il apporte des détenteurs de pass prépayés qui s'engagent sur plusieurs entrées avant leur arrivée et les utilisent au cours d'un séjour de plusieurs jours : des voyageurs qui planifient un programme complet en ville.
Connecter CityPASS à Ventrata vous permet de scanner, contrôler et valider les pass CityPASS à 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 CityPASS distincte.
Pour en savoir plus sur CityPASS, consultez citypass.com.
📒 REMARQUE
Vous souhaitez plutôt revendre des billets CityPASS ? Consultez CityPASS : backend opérateur.
🏆 CityPASS Preferred Integration Partner. Ventrata a été désigné CityPASS Preferred Integration Partner et prend en charge l'ensemble des fonctionnalités de l'intégration CityPASS.
Site web principal | |
Tags | Multi-Attraction Pass |
Type de connexion | Validation des pass : vous scannez les pass CityPASS à votre entrée |
Fonctionnalités de la connexion | Product Mapping · Availability Sync · Pricing Sync · Bookings Sync · Redemption Sync · Pass Walkup Scanning Sync |
Développé par | Ventrata (via CityPASS API) |
Cette connexion vous permet de :
Scanner les codes-barres CityPASS et C-Ticket à votre entrée et les valider auprès de CityPASS en temps réel.
Enregistrer chaque visite avec un pass comme réservation à date ouverte dans Ventrata, avec le code-barres comme référence revendeur.
Marquer automatiquement le billet comme utilisé dans CityPASS, soit au moment du scan, soit plus tard lorsqu'il est validé ou marqué en non-présentation.
Fonctionnement
Vous scannez ou saisissez un code-barres à votre entrée.
Si le code-barres commence par 308458, Ventrata le traite comme un billet CityPASS et le valide via l'API CityPASS.
Ventrata recherche la ligne de mappage correspondant à la famille de produits, à l'attraction et à la catégorie de billet. Si elle n'est pas encore mappée, le scan échoue jusqu'à ce que vous la mappiez.
Ventrata crée une réservation à date ouverte pour le produit, l'option et l'unité mappés, en quantité 1, avec le code-barres comme référence revendeur.
Ventrata indique à CityPASS que le billet a été utilisé. Si le personnel a choisi une date ou un créneau, celui-ci est envoyé comme date d'utilisation ; sinon, l'heure actuelle est utilisée.
📒 REMARQUE
Seuls les codes-barres commençant par 308458 sont traités comme des billets CityPASS.
Créer la connexion CityPASS
🔐 Autorisations de rôle requises : See Connections, Modify Connections
Avant de commencer :
CityPASS est configuré comme revendeur dans Ventrata ; le formulaire de connexion vous demande d'en choisir un.
Vous disposez d'un utilisateur et d'un mot de passe CityPASS pour l'API CityPASS.
Créer la connexion CityPASS
Sélectionnez le revendeur CityPASS.
Saisissez l'utilisateur et le mot de passe CityPASS.
Choisissez les billets à accepter avec Is affiliate / Is not affiliate et Product families.
Enregistrez. Ventrata vérifie les identifiants en récupérant la liste des produits de validation CityPASS ; en cas d'échec, les champs utilisateur et mot de passe sont marqués comme non valides.
Le formulaire de connexion comporte les options suivantes :
Reseller | Le revendeur dont la connexion utilise les paramètres et au nom duquel les réservations sont enregistrées. |
Utilisateur CityPASS | Utilisateur API fourni par CityPASS. Un préfixe « uat: » dirige la connexion vers l'environnement d'intégration (test) de CityPASS. |
Mot de passe CityPASS | Mot de passe API fourni par CityPASS. |
Is affiliate | Accepter les billets pour lesquels CityPASS signale l'attraction comme affiliée/inventaire. Activé par défaut. |
Is not affiliate | Accepter les billets pour lesquels CityPASS ne signale pas l'attraction comme affiliée/inventaire. Activé par défaut. |
Product families | Les familles de produits CityPASS que vous acceptez : CityPASS et/ou CTicket. Les deux par défaut. |
📗 ASTUCE
Ajoutez le préfixe « uat: » à l'utilisateur pour diriger la connexion vers l'environnement d'intégration (test) de CityPASS.
Mapper les produits
Les lignes proviennent de la liste des produits de validation de CityPASS (/ventrata/redemptionproducts). Les nouvelles catégories de billets détectées lors d'un scan ajoutent des lignes à la volée.
Ouvrez la connexion et mappez chaque ligne CityPASS à un produit, une option et une unité Ventrata.
📒 REMARQUE
Chaque ligne doit avoir un produit, une option et une unité.
📒 REMARQUE
Tant qu'une ligne n'est pas mappée, les scans pour cette catégorie de billet échouent avec « is not mapped in <connection> ».
Redemption
Immédiatement : par défaut, au moment du scan, Ventrata indique à CityPASS que le billet est REDEEMED (appel Use).
Lors de la validation ou de la non-présentation : l'option Valider lors de l'annulation du report / non-présentation (Redeem on undefer / no-show) est prise en charge. Ventrata envoie l'appel Use plus tard, avec REDEEMED ou le statut du billet Ventrata en majuscules, par exemple NOSHOW ou CANCELLED.
Ce qui est envoyé à CityPASS : le statut du billet (REDEEMED ou, en mode différé, le statut du billet) et la date d'utilisation : la date/l'heure de la réservation si le personnel en a choisi une, sinon le moment présent. Aucun prix n'est envoyé.
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 CityPASS à un produit Ventrata dans le Ventrata Dashboard. Les lignes proviennent de la liste des produits de validation de CityPASS (/ventrata/redemptionproducts). Les nouvelles catégories de billets détectées lors d'un scan ajoutent des lignes à la volée. Chaque ligne doit avoir un produit, une option et une unité. Tant qu'une ligne n'est pas mappée, les scans pour cette catégorie de billet échouent avec « is not mapped in <connection> ». |
Content Sync | ❌ |
Le contenu des produits n'est pas synchronisé. CityPASS vend son propre pass. Vos produits et leur contenu restent dans Ventrata. |
Availability Sync | ✅ |
Aucune disponibilité n'est synchronisée avec CityPASS. Aucune disponibilité n'est synchronisée avec CityPASS. |
Pricing Sync | ✅ |
Les prix sont partagés avec CityPASS. La réservation utilise votre prix unitaire Ventrata avec un règlement par bon. Aucune information de prix n'est envoyée à CityPASS. |
Promotions Sync | ❌ |
Les promotions ne s'appliquent pas aux pass CityPASS. Vos promotions Ventrata ne s'appliquent pas aux réservations créées en scannant un pass. |
Bookings Sync | ✅ |
Les réservations sont créées dans Ventrata lorsqu'un pass est scanné. Les réservations sont créées au moment du scan, à date ouverte, en quantité 1 (un billet par code-barres), avec le code-barres comme référence revendeur. Il n'y a pas d'appel d'annulation vers CityPASS. En mode différé, un statut de billet annulé ou en non-présentation peut être transmis à CityPASS dans l'appel Use. |
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 à CityPASS. Par défaut, au moment du scan, Ventrata indique à CityPASS que le billet est REDEEMED (appel Use). L'option Valider lors de l'annulation du report / non-présentation (Redeem on undefer / no-show) est prise en charge. Ventrata envoie l'appel Use plus tard, avec REDEEMED ou le statut du billet Ventrata en majuscules, par exemple NOSHOW ou CANCELLED. Le statut du billet (REDEEMED ou, en mode différé, le statut du billet) et la date d'utilisation : la date/l'heure de la réservation si le personnel en a choisi une, sinon le moment présent. Aucun prix n'est envoyé. |
Pass Walkup Scanning Sync | ✅ |
Vous scannez les pass CityPASS à votre entrée. Vous scannez ou saisissez un code-barres à votre entrée. Si le code-barres commence par 308458, Ventrata le traite comme un billet CityPASS et le valide via l'API CityPASS. Ventrata recherche la ligne de mappage correspondant à la famille de produits, à l'attraction et à la catégorie de billet. Si elle n'est pas encore mappée, le scan échoue jusqu'à ce que vous la mappiez. |
Gift Card Sync | ❌ |
Ne fait pas partie de cette connexion. Les pass CityPASS ne sont pas des cartes cadeaux Ventrata. |
✅ pris en charge · ❌ non pris en charge
Bon à savoir : limites de cette connexion
Bon à savoir : limites de cette connexion
Un billet par code-barres.
Seuls les codes-barres commençant par 308458 sont reconnus.
Pas de prise en charge, d'extras ni de questions de réservation.
Pas de synchronisation des disponibilités ni des prix.
Dépannage
« is not mapped in <connection> »</b>
« is not mapped in <connection> »</b>
Cette famille de produits, attraction et catégorie de billet CityPASS n'est pas encore mappée à un produit Ventrata. Mappez la ligne dans la connexion CityPASS à un produit, une option et une unité.
« Redemption not allowed »
« Redemption not allowed »
« Pass expired, cancelled, or already used »
« Pass expired, cancelled, or already used »
« Texte du message propre à CityPASS »
« Texte du message propre à CityPASS »
CityPASS a refusé le billet pour une autre raison ; Ventrata affiche son message tel quel.
📚 En savoir plus sur les connexions Ventrata
Informations sur le partenaire
City Pass, Inc.
ID partenaire Ventrata : 41927759-10fb-4011-9315-aa4ece876c67