Go City est le plus grand fournisseur mondial de pass multi-attractions ; il vend des pass pour plus de 1 500 attractions, visites et activités dans plus de 25 destinations sur quatre continents. Pour les opérateurs, il apporte des détenteurs de pass prépayés venant de tous les grands marchés sources, qui visitent en dehors des heures de pointe et découvrent des attractions qu'ils ne connaissaient pas : environ 12 millions de visites d'attractions par an.
Connecter Go City à Ventrata vous permet de scanner, contrôler et valider les pass Go City à 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 Go City distincte.
Pour en savoir plus sur Go City, consultez gocity.com.
📒 REMARQUE
Vous souhaitez plutôt revendre des pass Go City ? Consultez Go City : backend opérateur.
🏆 Go City Platinum Preferred Connectivity Partner 2026. Ventrata a été nommé premier partenaire Platinum de Go City dès la première année du programme, pour la prise en charge de l'ensemble des fonctionnalités : blocages de capacité en temps réel, double validation et validation dynamique. Ventrata a aussi été le premier système à passer à la dernière version de la Direct Connect API de Go City.
Site web principal | |
Tags | Multi-Attraction Pass |
Type de connexion | Validation des pass : vous scannez les pass Go City à 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 Go City Direct Connect API & l'API OCTO de Ventrata) |
Cette connexion vous permet de :
Scanner, contrôler et valider les pass Go City des visiteurs sans réservation sur vos tourniquets, bornes, points de vente propulsés par Ventrata, sur l'application mobile ou dans le Dashboard, sans application Go City distincte ni saisie manuelle de données (Go City 'Direct Connect').
Permettre aux détenteurs de pass de réserver à l'avance une date et un horaire dans l'application ou le portail de réservation de Go City, à partir de vos disponibilités Ventrata en temps réel (Go City 'Go Reserve').
Enregistrer chaque visite Go City comme une réservation dans Ventrata, avec le numéro de pass comme référence revendeur.
Signaler automatiquement chaque validation à Go City, avec le tarif net que Go City vous doit.
Fonctionnement
Vous scannez un code-barres ou un QR code à l'entrée, ou le saisissez sous Nouvelle Commande → Valider le code du bon (+ New Order → Redeem Voucher Code), et il ne correspond à aucune réservation ni aucun billet Ventrata existant.
Ventrata vérifie le format. Un numéro de pass Go City comporte 12 chiffres, commence par 6 ou 7, et son 9e chiffre est 1 (adulte), 2 (enfant) ou 4 (VIP). Les tirets sont supprimés. Tout autre code n'est pas traité comme un pass Go City.
Ventrata recherche le pass auprès de Go City en temps réel. Les recherches sont mises en cache pendant 5 minutes.
Pour chaque offre valable sur le pass, Ventrata crée une réservation à date ouverte pour le produit, l'option et l'unité mappés. La référence revendeur est /. Un pass pouvant contenir plusieurs offres, un seul scan peut créer plusieurs réservations.
Si une offre n'est pas encore mappée, le scan échoue jusqu'à ce que vous la mappiez.
Ventrata signale la visite à Go City : au moment du scan par défaut, ou lorsque le billet est validé ou marqué en non-présentation si vous différez la validation.
📒 REMARQUE
Numéro de pass à 12 chiffres commençant par 6 ou 7 ; le 9e chiffre est 1 (adulte), 2 (enfant) ou 4 (VIP). Les tirets sont supprimés. Les codes qui ne correspondent pas sont ignorés sans message et ne sont pas traités comme des pass Go City.
Visites pré-réservées
Go City 'Go Reserve'. Les détenteurs de pass choisissent une date et un horaire dans l'application ou le portail de réservation de Go City. Go City lit vos disponibilités en temps réel avec l'Availability Check OCTO de Ventrata et réserve avec Booking Reservation et Booking Confirmation d'OCTO. Les détenteurs de pass peuvent reprogrammer ou annuler (Booking Update et Booking Cancellation d'OCTO), et Go City annule automatiquement ces réservations lorsqu'un pass devient non valable. Pour l'activer, copiez la clé API affichée sur la page de votre connexion Go City (au-dessus du tableau des offres) et partagez-la de manière sécurisée avec l'équipe d'implémentation de Go City ([email protected]) en demandant l'activation de Go Reserve.
Créer la connexion Go City
🔐 Autorisations de rôle requises : See Connections, Modify Connections
Avant de commencer :
Vous êtes une attraction partenaire de Go City et vos produits existent déjà dans le système de Go City.
Vous utilisez à votre entrée du matériel propulsé par Ventrata (tourniquet, borne de billetterie, point de vente / terminal), l'application mobile Ventrata ou le Dashboard.
Vous avez créé Go City en tant que revendeur dans Ventrata, avec une tarification publique et de gros/à la commission correcte.
Le revendeur Go City utilise le mode de règlement Facturer sur mon compte (Bill to my account).
Vous devez déjà être une attraction partenaire de Go City, avec vos produits configurés dans le système de Go City. Si vous ne travaillez pas encore avec Go City, contactez son équipe Amériques. [email protected] Https://gocity.com/en/work-with-us
Équipe EMEA. [email protected]
Équipe APAC. [email protected]
Obtenir des identifiants et des pass de test auprès de Go City
Écrivez à [email protected] pour demander des identifiants de production pour la Direct Connect API et un pass de test de production de chaque type (adulte, enfant, familiarisation) pour chaque produit.
Conservez le nom d'utilisateur, le mot de passe et les pass de test que Go City vous envoie.
Créer la connexion Go City
Dans votre Ventrata Dashboard, allez dans Les liaisons → Les liaisons (Connections → Connections), cliquez sur + Nouvelle connexion (+ New Connection) et sélectionnez Go City.
Sélectionnez le revendeur Go City et saisissez le nom d'utilisateur et le mot de passe Go City.
Cochez 'Redeem only on Redemption/No-show' (recommandé).
Vous pouvez autoriser ou exclure des destinations ou des produits et donner un nom à la connexion.
Cochez « Test » uniquement pendant les tests.
Cliquez sur Créer la connexion (Create Connection). Ventrata vérifie les identifiants lors de l'enregistrement.
Activer Go Reserve (facultatif)
Copiez la clé API affichée sur la page de votre connexion Go City, au-dessus du tableau des offres.
Partagez-la de manière sécurisée avec l'équipe d'implémentation de Go City ([email protected]) et demandez-lui d'activer Go Reserve.
Le formulaire de connexion comporte les options suivantes :
Reseller | La connexion utilise la configuration de ce revendeur (tarification, produits autorisés et exclus) et enregistre toutes les réservations en son nom. |
Nom d'utilisateur Go City | Utilisateur d'authentification basique pour l'API partenaire de Go City. Un préfixe « uat: » dirige la connexion vers l'environnement de préproduction (staging) de Go City. |
Mot de passe Go City | Mot de passe d'authentification basique pour l'API partenaire de Go City. |
Redeem only on Redemption/No-show | Cochée (recommandé) : Ventrata envoie la validation à Go City lorsque la réservation est réellement validée ou marquée en non-présentation. Décochée : elle est envoyée à la création de la réservation. |
Destinations et produits autorisés / exclus | Limite ce que cette connexion peut réserver, en plus des paramètres du revendeur. Utile si vous avez plusieurs connexions Go City, par exemple une par destination. |
Nom de la connexion | Permet de distinguer les connexions, par exemple 'Go City Paris' et 'Go City Sydney'. |
Test | Force toutes les réservations Go City en mode test et ne permet qu'aux équipements en mode test de les scanner. Décochez avant la mise en service. |
Types de pass | Les types de pass que vous acceptez : ALL_INCLUSIVE, EXPLORER, SINGLE_SELL. Tous cochés par défaut. |
Variantes de pass | Les variantes que vous acceptez : STANDARD, DEFAULT, PLUS, X_FROM_Y, HIGHLIGHTS, ESSENTIALS, SPOTLIGHT, MINI, SINGLE_SELL, CUSTOM. Toutes cochées par défaut. |
Marques de pass | Les marques que vous acceptez : GO_CITY, BIG_BUS, GREAT, EMPIRE_STATE_BUILDING, ONE_WORLD_OBSERVATORY, TOP_OF_THE_ROCK, EDGE, AIRBNB. Toutes cochées par défaut. |
📗 ASTUCE
Ajoutez le préfixe « uat: » au nom d'utilisateur pour diriger la connexion vers l'environnement de préproduction (staging) de Go City. Par ailleurs, la case « Test » force toutes les réservations Go City en mode test et ne permet qu'aux équipements en mode test de les scanner ; décochez-la avant d'accueillir des visiteurs.
Mapper les produits
Lorsque vous enregistrez la connexion, Ventrata charge la liste des offres de Go City (les attractions qu'il vend) et crée une ligne par offre et par type de client (ADULT, CHILD, VIP). Les offres que Go City ne renvoie plus sont supprimées à l'enregistrement. Les nouvelles offres détectées sur un pass scanné ajoutent une ligne à la volée.
Scannez chaque pass de test Go City sur un matériel propulsé par Ventrata ou avec l'application mobile, ou saisissez son numéro sous Nouvelle Commande → Valider le code du bon (+ New Order → Redeem Voucher Code). Vous obtiendrez une erreur 'not mapped', et l'offre Go City apparaîtra dans votre connexion.
Allez dans Les liaisons → Les liaisons (Connections → Connections) et ouvrez votre connexion Go City.
Cliquez sur une ligne d'offre (les lignes non mappées sont en rouge), sélectionnez le produit, l'option et l'unité Ventrata, puis cliquez sur Mettre à jour le mappage (Update Mapping).
📒 REMARQUE
Chaque ligne doit avoir un produit, une option et une unité.
📒 REMARQUE
Les lignes non mappées sont surlignées en rouge.
📒 REMARQUE
Tant qu'une ligne n'est pas mappée, les scans de cette offre échouent avec « is not mapped in <connection> ».
Redemption
Immédiatement : Ventrata transmet la visite à Go City au moment du scan, lors de la création de la réservation.
Lors de la validation ou de la non-présentation : si 'Redeem only on Redemption/No-show' est cochée (recommandé), Ventrata envoie la validation lorsque la réservation est validée ou marquée en non-présentation.
Ce qui est envoyé à Go City : une visite sur /partner-api/v1/visit de Go City, avec passNumber, offerId et netRate.
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 Go City à un produit Ventrata dans le Ventrata Dashboard. Lorsque vous enregistrez la connexion, Ventrata charge la liste des offres de Go City (les attractions qu'il vend) et crée une ligne par offre et par type de client (ADULT, CHILD, VIP). Les offres que Go City ne renvoie plus sont supprimées à l'enregistrement. Les nouvelles offres détectées sur un pass scanné ajoutent une ligne à la volée. Chaque ligne doit avoir un produit, une option et une unité. Les lignes non mappées sont surlignées en rouge. Tant qu'une ligne n'est pas mappée, les scans de cette offre échouent avec « is not mapped in <connection> ». |
Content Sync | ❌ |
Le contenu des produits n'est pas synchronisé. Go City vend son propre pass. Vos produits et leur contenu restent dans Ventrata. |
Availability Sync | ✅ |
Go Reserve : Go City récupère vos créneaux en temps réel avec l'Availability Check OCTO de Ventrata lorsqu'un détenteur de pass effectue une réservation. Go Reserve : Go City récupère vos créneaux en temps réel avec l'Availability Check OCTO de Ventrata lorsqu'un détenteur de pass effectue une réservation. |
Pricing Sync | ✅ |
Les prix sont partagés avec Go City. La réservation utilise votre prix unitaire Ventrata (règlement par bon). Lors de la validation, Ventrata envoie à Go City un netRate égal au prix de gros du billet moins le solde direct : c'est donc votre prix de gros/net dans Ventrata qui est communiqué à Go City comme montant qu'il vous doit. Définissez correctement les prix publics et de gros/à la commission de Go City sur le revendeur. |
Promotions Sync | ❌ |
Les promotions ne s'appliquent pas aux pass Go City. 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 sans réservation préalable ne sont créées qu'au moment du scan. Les visiteurs peuvent entrer avec le pass Go City ou avec un code-barres émis par Ventrata, car tous deux appartiennent à la même réservation. Les réservations Go Reserve sont effectuées à l'avance par Go City via l'API OCTO de Ventrata. Ventrata n'effectue aucun appel d'annulation ou de modification vers Go City. Pour Go Reserve, les détenteurs de pass reprogramment ou annulent via Go City (Booking Update et Booking Cancellation d'OCTO), et Go City annule les réservations dont le pass devient non valable. |
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 à Go City. Ventrata transmet la visite à Go City au moment du scan, lors de la création de la réservation. Si 'Redeem only on Redemption/No-show' est cochée (recommandé), Ventrata envoie la validation lorsque la réservation est validée ou marquée en non-présentation. Une visite sur /partner-api/v1/visit de Go City, avec passNumber, offerId et netRate. |
Pass Walkup Scanning Sync | ✅ |
Vous scannez les pass Go City à votre entrée. Vous scannez un code-barres ou un QR code à l'entrée, ou le saisissez sous Nouvelle Commande → Valider le code du bon (+ New Order → Redeem Voucher Code), et il ne correspond à aucune réservation ni aucun billet Ventrata existant. Ventrata vérifie le format. Un numéro de pass Go City comporte 12 chiffres, commence par 6 ou 7, et son 9e chiffre est 1 (adulte), 2 (enfant) ou 4 (VIP). Les tirets sont supprimés. Tout autre code n'est pas traité comme un pass Go City. Ventrata recherche le pass auprès de Go City en temps réel. Les recherches sont mises en cache pendant 5 minutes. |
Gift Card Sync | ❌ |
Ne fait pas partie de cette connexion. Les pass Go City 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
Les types de clients sont limités à ADULT, CHILD et VIP.
Des identifiants erronés ne génèrent pas d'erreur explicite ; les champs nom d'utilisateur et mot de passe sont simplement marqués comme non valides.
Si la recherche d'un pass rencontre une erreur HTTP ou un délai d'attente dépassé, le pass est traité sans message comme introuvable.
Les codes-barres qui ne correspondent pas au format Go City sont ignorés sans message.
Vous avez besoin à votre entrée d'un matériel propulsé par Ventrata, de l'application mobile ou du Dashboard.
Le revendeur Go City doit utiliser le mode de règlement Facturer sur mon compte (Bill to my account).
Pas de prise en charge, d'extras ni de questions de réservation ; la validation des informations client, des réponses et du transport est ignorée pour ces commandes.
Dépannage
« is not mapped in <connection> »</b>
« is not mapped in <connection> »</b>
L'offre Go City de ce pass n'est pas encore mappée à un produit Ventrata. Ouvrez la connexion Go City, cliquez sur la ligne rouge et mappez-la à un produit, une option et une unité.
« Pass not mapped in Ventrata connection »
« Pass not mapped in Ventrata connection »
Mappez l'offre apparue après le scan.
« Redemption not allowed »
« Redemption not allowed »
« Message propre à Go City (messages d'offre INVALID ou errorDescription FAILURE) »
« Message propre à Go City (messages d'offre INVALID ou errorDescription FAILURE) »
Go City a refusé le pass ou l'offre ; Ventrata affiche tel quel le texte de Go City au personnel.
FAQ
Les visiteurs peuvent-ils entrer avec le pass Go City ou ont-ils besoin d'un billet Ventrata ?
Les visiteurs peuvent-ils entrer avec le pass Go City ou ont-ils besoin d'un billet Ventrata ?
Les deux sont possibles. Le pass Go City et tout code-barres émis par Ventrata appartiennent à la même réservation.
Puis-je avoir plusieurs connexions Go City ?
Puis-je avoir plusieurs connexions Go City ?
Oui. Utilisez les destinations ou produits autorisés et exclus pour les répartir, par exemple par destination, et donnez un nom à chaque connexion.
Les détenteurs de pass peuvent-ils réserver un horaire à l'avance ?
Les détenteurs de pass peuvent-ils réserver un horaire à l'avance ?
Oui, avec Go Reserve. Partagez de manière sécurisée la clé API de la page de votre connexion avec l'équipe d'implémentation de Go City ([email protected]) pour l'activer.
Quel montant est communiqué à Go City comme dû ?
Quel montant est communiqué à Go City comme dû ?
Ventrata envoie un tarif net égal au prix de gros du billet moins le solde direct : vérifiez donc vos prix de gros sur le revendeur Go City.
Ressources utiles
📚 En savoir plus sur les connexions Ventrata
Informations sur le partenaire
Go City Limited
6 Dryden Street, London, WC2E 9NH
United Kingdom
ID partenaire Ventrata : b880f9df-612d-4f95-9611-f64b2137b936