Go City è la più grande azienda al mondo di pass multi-attrazione, con pass per oltre 1.500 attrazioni, tour e attività in più di 25 destinazioni in quattro continenti. Agli operatori porta titolari di pass prepagati da tutti i principali mercati di origine, che visitano al di fuori dei periodi di punta e provano attrazioni nuove per loro: circa 12 milioni di visite ad attrazioni all'anno.
Connettere Go City a Ventrata ti permette di scansionare, convalidare e riscattare i pass di Go City al tuo ingresso, su tornelli, chioschi, terminali POS basati su Ventrata, sull'app mobile o nella Ventrata Dashboard, senza un'app separata di Go City.
Per saperne di più su Go City, visita gocity.com.
📒 NOTA
Vuoi invece rivendere i pass di Go City? Vedi Go City: backend operatore.
🏆 Go City Platinum Preferred Connectivity Partner 2026. Ventrata è stata nominata primo partner Platinum di Go City nel primo anno del programma, per il supporto dell'intero set di funzionalità: blocchi di capienza in tempo reale, doppia convalida e riscatto dinamico. Ventrata è stata anche il primo sistema ad aggiornarsi alla più recente Direct Connect API di Go City.
Sito web principale | |
Tag | Multi-Attraction Pass |
Tipo di connessione | Riscatto dei pass: scansioni i pass di Go City al tuo ingresso |
Funzionalità della connessione | Product Mapping · Availability Sync · Pricing Sync · Bookings Sync · Redemption Sync · Pass Walkup Scanning Sync |
Sviluppato da | Ventrata (tramite Go City Direct Connect API & l'API OCTO di Ventrata) |
Questa connessione ti permette di:
Scansiona, convalida e riscatta i pass di Go City dei visitatori senza prenotazione su tornelli, chioschi, punti vendita, app mobile o dashboard basati su Ventrata, senza un'app separata di Go City e senza inserimento manuale dei dati (Go City 'Direct Connect').
Consenti ai titolari di pass di prenotare in anticipo data e ora nell'app o nel portale di prenotazione di Go City, usando la tua disponibilità Ventrata in tempo reale (Go City 'Go Reserve').
Registra ogni visita di Go City come prenotazione in Ventrata, con il numero del pass come riferimento del rivenditore.
Comunica automaticamente ogni riscatto a Go City, insieme alla tariffa netta che Go City ti deve.
Come funziona
Scansioni un codice a barre o un codice QR all'ingresso, oppure lo inserisci in + New Order → Redeem Voucher Code, e non corrisponde a una prenotazione o a un biglietto Ventrata esistente.
Ventrata verifica il formato. Un numero di pass di Go City ha 12 cifre, inizia con 6 o 7 e la nona cifra è 1 (adulto), 2 (bambino) o 4 (VIP). I trattini vengono rimossi. Qualsiasi altro codice non viene trattato come pass di Go City.
Ventrata cerca il pass presso Go City in tempo reale. Le ricerche vengono memorizzate in cache per 5 minuti.
Per ogni offerta valida sul pass, Ventrata crea una prenotazione a data aperta per il prodotto, l'opzione e l'unità mappati. Il riferimento del rivenditore è /. Un pass può includere più offerte, quindi una scansione può creare più prenotazioni.
Se un'offerta non è ancora mappata, la scansione non va a buon fine finché non la mappi.
Ventrata comunica la visita a Go City: per impostazione predefinita al momento della scansione, oppure quando il biglietto viene riscattato o segnato come no-show se differisci il riscatto.
📒 NOTA
Numero di pass di 12 cifre che inizia con 6 o 7; la nona cifra è 1 (adulto), 2 (bambino) o 4 (VIP). I trattini vengono rimossi. I codici non corrispondenti vengono ignorati senza avvisi e non trattati come Go City.
Visite prenotate in anticipo
Go City 'Go Reserve'. I titolari di pass scelgono data e ora nell'app o nel portale di prenotazione di Go City. Go City legge la tua disponibilità in tempo reale con l'Availability Check OCTO di Ventrata e prenota con Booking Reservation e Booking Confirmation OCTO. I titolari di pass possono riprogrammare o cancellare (Booking Update e Booking Cancellation OCTO) e Go City cancella automaticamente queste prenotazioni quando un pass non è più valido. Per attivarlo, copia la chiave API mostrata nella pagina della tua connessione con Go City (sopra la tabella delle inserzioni) e condividila in modo sicuro con il team di implementazione di Go City ([email protected]) chiedendo di abilitare Go Reserve.
Creare la connessione con Go City
🔐 Autorizzazioni di ruolo richieste: See Connections, Modify Connections
Prima di iniziare:
Sei un partner attrazione di Go City e i tuoi prodotti esistono già nel sistema di Go City.
Al tuo ingresso usi hardware basato su Ventrata (tornello, chiosco biglietti, punto vendita/terminale), l'app mobile Ventrata o la dashboard.
Hai creato Go City come Reseller in Ventrata con prezzi al pubblico e all'ingrosso/a commissione corretti.
Il rivenditore Go City usa il metodo di regolamento 'Bill to my account'.
Devi già essere un partner attrazione di Go City, con i tuoi prodotti configurati nel sistema di Go City. Se non lavori ancora con Go City, contatta il suo team per le Americhe. [email protected] Https://gocity.com/en/work-with-us
Team EMEA. [email protected]
Team APAC. [email protected]
Ottenere credenziali e pass di test da Go City
Scrivi a [email protected] e chiedi le credenziali di produzione della Direct Connect API e un pass di test di produzione di ogni tipo (adulto, bambino, familiarization) per ciascun prodotto.
Conserva il nome utente, la password e i pass di test che Go City ti invia.
Creare la connessione con Go City
Nella tua dashboard Ventrata, vai su Connections → Connections, fai clic su + New Connection e seleziona Go City.
Seleziona il Reseller Go City e inserisci nome utente e password di Go City.
Spunta 'Redeem only on Redemption/No-show' (consigliato).
Facoltativamente, consenti o escludi destinazioni o prodotti e assegna un nome alla connessione.
Spunta 'Test' solo durante i test.
Fai clic su Create Connection. Ventrata verifica le credenziali al salvataggio.
Attivare Go Reserve (facoltativo)
Copia la chiave API mostrata nella pagina della tua connessione con Go City, sopra la tabella delle inserzioni.
Condividila in modo sicuro con il team di implementazione di Go City ([email protected]) e chiedi di abilitare Go Reserve.
Il modulo della connessione ha queste opzioni:
Reseller | La connessione usa la configurazione di questo rivenditore (prezzi, prodotti consentiti ed esclusi) e registra tutte le prenotazioni per suo conto. |
Nome utente di Go City | Utente basic-auth per l'API partner di Go City. Un prefisso 'uat:' indirizza la connessione all'ambiente di staging di Go City. |
Password di Go City | Password basic-auth per l'API partner di Go City. |
Redeem only on Redemption/No-show | Spuntato (consigliato): Ventrata invia il riscatto a Go City quando la prenotazione viene effettivamente riscattata o segnata come no-show. Non spuntato: viene inviato alla creazione della prenotazione. |
Destinazioni e prodotti consentiti / esclusi | Limita ciò che questa connessione può prenotare, in aggiunta alle impostazioni del rivenditore. Utile se gestisci più connessioni con Go City, ad esempio una per destinazione. |
Nome della connessione | Ti permette di distinguere le connessioni, ad esempio 'Go City Paris' e 'Go City Sydney'. |
Test | Forza tutte le prenotazioni di Go City in modalità test e consente solo ai dispositivi in modalità test di scansionarle. Togli la spunta prima di andare live. |
Tipi di pass | Quali tipi di pass accetti: ALL_INCLUSIVE, EXPLORER, SINGLE_SELL. Tutti spuntati per impostazione predefinita. |
Varianti di pass | Quali varianti accetti: STANDARD, DEFAULT, PLUS, X_FROM_Y, HIGHLIGHTS, ESSENTIALS, SPOTLIGHT, MINI, SINGLE_SELL, CUSTOM. Tutte spuntate per impostazione predefinita. |
Marchi di pass | Quali marchi accetti: GO_CITY, BIG_BUS, GREAT, EMPIRE_STATE_BUILDING, ONE_WORLD_OBSERVATORY, TOP_OF_THE_ROCK, EDGE, AIRBNB. Tutti spuntati per impostazione predefinita. |
📗 SUGGERIMENTO
Aggiungi il prefisso 'uat:' al nome utente per indirizzare la connessione all'ambiente di staging di Go City. Separatamente, la casella 'Test' forza tutte le prenotazioni di Go City in modalità test e consente solo ai dispositivi in modalità test di scansionarle; togli la spunta prima di ricevere visitatori.
Mappare i prodotti
Quando salvi la connessione, Ventrata carica l'elenco delle offerte di Go City (le attrazioni che vende) e crea una riga per ogni offerta e tipo di cliente (ADULT, CHILD, VIP). Le offerte che Go City non restituisce più vengono rimosse al salvataggio. Le nuove offerte rilevate su un pass scansionato aggiungono una riga al volo.
Scansiona ogni pass di test di Go City su hardware basato su Ventrata o con l'app mobile, oppure inserisci il numero del pass in + New Order → Redeem Voucher Code. Riceverai un errore 'not mapped' e l'inserzione di Go City comparirà nella tua connessione.
Vai su Connections → Connections e apri la tua connessione con Go City.
Fai clic su una riga di inserzione (le righe non mappate sono rosse), seleziona il prodotto, l'opzione e l'unità Ventrata e fai clic su Update Mapping.
📒 NOTA
Ogni riga richiede un prodotto, un'opzione e un'unità.
📒 NOTA
Le righe non mappate sono evidenziate in rosso.
📒 NOTA
Finché una riga non è mappata, le scansioni di quell'offerta non vanno a buon fine con ' is not mapped in <connection>'.
Redemption
Immediatamente: Ventrata comunica la visita a Go City al momento della scansione, quando viene creata la prenotazione.
Al riscatto o al no-show: con 'Redeem only on Redemption/No-show' spuntato (consigliato), Ventrata invia il riscatto quando la prenotazione viene riscattata o segnata come no-show.
Cosa viene inviato a Go City: una visita a /partner-api/v1/visit di Go City con passNumber, offerId e netRate.
Funzionalità della connessione in dettaglio
Questa sezione è per chi vuole i dettagli. Fai clic su una riga per vedere come funziona ogni funzionalità.
Product Mapping | ✅ |
Mappi ogni pass di Go City a un prodotto Ventrata nella Ventrata Dashboard. Quando salvi la connessione, Ventrata carica l'elenco delle offerte di Go City (le attrazioni che vende) e crea una riga per ogni offerta e tipo di cliente (ADULT, CHILD, VIP). Le offerte che Go City non restituisce più vengono rimosse al salvataggio. Le nuove offerte rilevate su un pass scansionato aggiungono una riga al volo. Ogni riga richiede un prodotto, un'opzione e un'unità. Le righe non mappate sono evidenziate in rosso. Finché una riga non è mappata, le scansioni di quell'offerta non vanno a buon fine con ' is not mapped in <connection>'. |
Content Sync | ❌ |
I contenuti dei prodotti non vengono sincronizzati. Go City vende il proprio pass. I tuoi prodotti e i relativi contenuti restano in Ventrata. |
Availability Sync | ✅ |
Go Reserve: Go City recupera le tue fasce orarie in tempo reale con l'Availability Check OCTO di Ventrata quando un titolare di pass effettua una prenotazione. Go Reserve: Go City recupera le tue fasce orarie in tempo reale con l'Availability Check OCTO di Ventrata quando un titolare di pass effettua una prenotazione. |
Pricing Sync | ✅ |
I prezzi vengono condivisi con Go City. La prenotazione usa il tuo prezzo unitario Ventrata (regolamento tramite voucher). Al riscatto, Ventrata invia a Go City un netRate pari al prezzo all'ingrosso del biglietto meno il saldo diretto, quindi il tuo prezzo all'ingrosso/netto in Ventrata è l'importo che viene comunicato a Go City come dovuto a te. Imposta correttamente sul rivenditore i prezzi al pubblico e all'ingrosso/a commissione di Go City. |
Promotions Sync | ❌ |
Le promozioni non si applicano ai pass di Go City. Le tue promozioni Ventrata non si applicano alle prenotazioni create scansionando un pass. |
Bookings Sync | ✅ |
Le prenotazioni vengono create in Ventrata quando un pass viene scansionato. Le prenotazioni dei visitatori senza prenotazione vengono create solo al momento della scansione. I visitatori possono entrare con il pass di Go City o con un codice a barre emesso da Ventrata, perché entrambi appartengono alla stessa prenotazione. Le prenotazioni Go Reserve vengono effettuate in anticipo da Go City tramite l'API OCTO di Ventrata. Ventrata non effettua chiamate di cancellazione o modifica verso Go City. Per Go Reserve, i titolari di pass riprogrammano o cancellano tramite Go City (Booking Update e Booking Cancellation OCTO) e Go City cancella le prenotazioni il cui pass non è più valido. |
Pickups/Dropoff Sync | ❌ |
Non fa parte di questa connessione. I riscatti dei pass non includono pick-up. |
Custom Questions Sync | ❌ |
Non fa parte di questa connessione. Le domande di prenotazione non vengono poste né inviate per i riscatti dei pass. |
Extras Sync | ❌ |
Non fa parte di questa connessione. Non è possibile aggiungere extra al riscatto di un pass. |
Redemption Sync | ✅ |
I riscatti vengono inviati a Go City. Ventrata comunica la visita a Go City al momento della scansione, quando viene creata la prenotazione. Con 'Redeem only on Redemption/No-show' spuntato (consigliato), Ventrata invia il riscatto quando la prenotazione viene riscattata o segnata come no-show. Una visita a /partner-api/v1/visit di Go City con passNumber, offerId e netRate. |
Pass Walkup Scanning Sync | ✅ |
Scansioni i pass di Go City al tuo ingresso. Scansioni un codice a barre o un codice QR all'ingresso, oppure lo inserisci in + New Order → Redeem Voucher Code, e non corrisponde a una prenotazione o a un biglietto Ventrata esistente. Ventrata verifica il formato. Un numero di pass di Go City ha 12 cifre, inizia con 6 o 7 e la nona cifra è 1 (adulto), 2 (bambino) o 4 (VIP). I trattini vengono rimossi. Qualsiasi altro codice non viene trattato come pass di Go City. Ventrata cerca il pass presso Go City in tempo reale. Le ricerche vengono memorizzate in cache per 5 minuti. |
Gift Card Sync | ❌ |
Non fa parte di questa connessione. I pass di Go City non sono carte regalo Ventrata. |
✅ supportato · ❌ non supportato
Buono a sapersi: limiti di questa connessione
Buono a sapersi: limiti di questa connessione
I tipi di cliente sono limitati a ADULT, CHILD e VIP.
Credenziali errate non generano un errore descrittivo; i campi nome utente e password vengono semplicemente segnati come non validi.
Se la ricerca di un pass riceve un errore HTTP o va in timeout, il pass viene trattato senza avvisi come non trovato.
I codici a barre che non corrispondono al formato di Go City vengono ignorati senza avvisi.
Al tuo ingresso ti servono hardware basato su Ventrata, l'app mobile o la dashboard.
Il rivenditore Go City deve usare il metodo di regolamento 'Bill to my account'.
Nessun pick-up, extra o domanda di prenotazione; per questi ordini la convalida di cliente, risposte e trasporto viene saltata.
Risoluzione dei problemi
" is not mapped in <connection>"</b>
" is not mapped in <connection>"</b>
L'offerta di Go City su questo pass non è ancora mappata a un prodotto Ventrata. Apri la connessione con Go City, fai clic sulla riga rossa e mappala a un prodotto, un'opzione e un'unità.
"Pass not mapped in Ventrata connection"
"Pass not mapped in Ventrata connection"
Mappa l'inserzione comparsa dopo la scansione.
"Redemption not allowed"
"Redemption not allowed"
"Messaggio di Go City (messaggi di offerta INVALID o errorDescription FAILURE)"
"Messaggio di Go City (messaggi di offerta INVALID o errorDescription FAILURE)"
Go City ha rifiutato il pass o l'offerta; Ventrata mostra allo staff il testo di Go City così com'è.
FAQ
I visitatori possono entrare con il pass di Go City o serve un biglietto Ventrata?
I visitatori possono entrare con il pass di Go City o serve un biglietto Ventrata?
Vanno bene entrambi. Il pass di Go City e qualsiasi codice a barre emesso da Ventrata appartengono alla stessa prenotazione.
Posso gestire più di una connessione con Go City?
Posso gestire più di una connessione con Go City?
Sì. Usa destinazioni o prodotti consentiti ed esclusi per suddividerle, ad esempio per destinazione, e assegna un nome a ogni connessione.
I titolari di pass possono prenotare un orario in anticipo?
I titolari di pass possono prenotare un orario in anticipo?
Sì, con Go Reserve. Per attivarlo, condividi in modo sicuro la chiave API della pagina della tua connessione con il team di implementazione di Go City ([email protected]).
Quale importo viene comunicato a Go City come dovuto a me?
Quale importo viene comunicato a Go City come dovuto a me?
Ventrata invia una tariffa netta pari al prezzo all'ingrosso del biglietto meno il saldo diretto, quindi controlla i tuoi prezzi all'ingrosso sul rivenditore Go City.
Risorse utili
📚 Altro sulle connessioni Ventrata
Informazioni sul partner
Go City Limited
6 Dryden Street, London, WC2E 9NH
United Kingdom
Ventrata Partner ID: b880f9df-612d-4f95-9611-f64b2137b936