Go City é a maior empresa de passes multiatrações do mundo, vendendo passes para mais de 1500 atrações, tours e atividades em mais de 25 destinos em quatro continentes. Para os operadores, traz titulares de passes pré-pagos de todos os principais mercados emissores, que visitam fora das horas de ponta e experimentam atrações que não conheciam, num total de cerca de 12 milhões de visitas a atrações por ano.
Conectar Go City à Ventrata permite-lhe ler, validar e resgatar passes de Go City à sua entrada, em torniquetes, quiosques e terminais de ponto de venda com tecnologia Ventrata, na aplicação móvel ou no Ventrata Dashboard, sem precisar de uma aplicação separada de Go City.
Para saber mais sobre Go City, visite gocity.com.
📒 NOTA
Pretende antes revender passes de Go City? Consulte Go City: backend de operador.
🏆 Go City Platinum Preferred Connectivity Partner 2026. A Ventrata foi distinguida como o primeiro parceiro Platinum de Go City no primeiro ano do programa, por suportar o conjunto completo de funcionalidades: bloqueios de capacidade em tempo real, validação dupla e resgate dinâmico. A Ventrata foi também o primeiro sistema a atualizar para a mais recente Direct Connect API de Go City.
Website principal | |
Etiquetas | Multi-Attraction Pass |
Tipo de conexão | Resgate de passes: lê os passes de Go City à sua entrada |
Funcionalidades da conexão | Product Mapping · Availability Sync · Pricing Sync · Bookings Sync · Redemption Sync · Pass Walkup Scanning Sync |
Desenvolvido por | Ventrata (através da Go City Direct Connect API e da API OCTO da Ventrata) |
Esta conexão permite:
Leia, valide e resgate passes de Go City de visitantes sem reserva nos seus torniquetes, quiosques, pontos de venda, aplicação móvel ou dashboard com tecnologia Ventrata, sem uma aplicação separada de Go City e sem introdução manual de dados ('Direct Connect' de Go City).
Permita que os titulares de passes pré-reservem uma data e hora na aplicação ou no portal de reservas de Go City, com base na sua disponibilidade Ventrata em tempo real ('Go Reserve' de Go City).
Registe cada visita de Go City como uma reserva na Ventrata, com o número do passe como referência do revendedor.
Comunique automaticamente cada resgate a Go City, juntamente com a tarifa líquida que Go City lhe deve.
Como funciona
Lê um código de barras ou código QR à entrada, ou introdu-lo em + New Order → Redeem Voucher Code, e este não corresponde a nenhuma reserva ou bilhete Ventrata existente.
A Ventrata verifica o formato. Um número de passe de Go City tem 12 dígitos, começa por 6 ou 7 e o 9.º dígito é 1 (adulto), 2 (criança) ou 4 (VIP). Os hífenes são removidos. Qualquer outro código não é tratado como um passe de Go City.
A Ventrata consulta o passe junto de Go City em tempo real. As consultas ficam em cache durante 5 minutos.
Para cada oferta válida no passe, a Ventrata cria uma reserva sem data definida para o produto, a opção e a unidade mapeados. A referência do revendedor é /. Um passe pode incluir várias ofertas, pelo que uma leitura pode criar várias reservas.
Se uma oferta ainda não estiver mapeada, a leitura falha até que a mapeie.
A Ventrata comunica a visita a Go City: no momento da leitura, por predefinição, ou quando o bilhete é resgatado ou marcado como no-show, se diferir o resgate.
📒 NOTA
Número de passe de 12 dígitos que começa por 6 ou 7; o 9.º dígito é 1 (adulto), 2 (criança) ou 4 (VIP). Os hífenes são removidos. Os códigos que não correspondem são ignorados sem aviso e não são tratados como Go City.
Visitas pré-reservadas
'Go Reserve' de Go City. Os titulares de passes escolhem uma data e hora na aplicação ou no portal de reservas de Go City. Go City lê a sua disponibilidade em tempo real com o Availability Check OCTO da Ventrata e reserva com Booking Reservation e Booking Confirmation OCTO. Os titulares de passes podem reagendar ou cancelar (Booking Update e Booking Cancellation OCTO), e Go City cancela estas reservas automaticamente quando um passe deixa de ser válido. Para ativar esta funcionalidade, copie a chave API apresentada na página da sua conexão com Go City (acima da tabela de anúncios) e partilhe-a de forma segura com a equipa de implementação de Go City ([email protected]), pedindo a ativação do Go Reserve.
Criar a conexão com Go City
🔐 Permissões de função necessárias: See Connections, Modify Connections
Antes de começar:
É um parceiro de atrações de Go City e os seus produtos já existem no sistema de Go City.
Utiliza hardware com tecnologia Ventrata (torniquete, quiosque de bilhetes, ponto de venda / terminal), a aplicação móvel Ventrata ou o dashboard à sua entrada.
Criou Go City como Reseller na Ventrata, com preços de venda ao público e grossistas/de comissão corretos.
O revendedor Go City utiliza o método de liquidação 'Bill to my account'.
Tem de ser já um parceiro de atrações de Go City, com os seus produtos configurados no sistema de Go City. Se ainda não trabalha com Go City, contacte a respetiva equipa para as Américas. [email protected] Https://gocity.com/en/work-with-us
Equipa EMEA. [email protected]
Equipa APAC. [email protected]
Obter credenciais e passes de teste de Go City
Envie um email para [email protected] a pedir credenciais de produção da Direct Connect API e um passe de teste de produção de cada tipo (adulto, criança, familiarização) para cada produto.
Guarde o nome de utilizador, a palavra-passe e os passes de teste que Go City lhe enviar.
Criar a conexão com Go City
No seu dashboard Ventrata, aceda a Connections → Connections, clique em + New Connection e selecione Go City.
Selecione o Reseller Go City e introduza o nome de utilizador e a palavra-passe de Go City.
Assinale 'Redeem only on Redemption/No-show' (recomendado).
Opcionalmente, permita ou exclua destinos ou produtos e atribua um nome à conexão.
Assinale 'Test' apenas durante os testes.
Clique em Create Connection. A Ventrata verifica as credenciais quando guarda.
Ativar o Go Reserve (opcional)
Copie a chave API apresentada na página da sua conexão com Go City, acima da tabela de anúncios.
Partilhe-a de forma segura com a equipa de implementação de Go City ([email protected]) e peça-lhe que ative o Go Reserve.
O formulário da conexão tem as seguintes opções:
Reseller | A conexão utiliza a configuração deste revendedor (preços, produtos permitidos e excluídos) e regista todas as reservas em seu nome. |
Nome de utilizador de Go City | Utilizador de autenticação básica para a API de parceiros de Go City. Um prefixo 'uat:' direciona a conexão para o ambiente de staging de Go City. |
Palavra-passe de Go City | Palavra-passe de autenticação básica para a API de parceiros de Go City. |
Redeem only on Redemption/No-show | Assinalado (recomendado): a Ventrata envia o resgate para Go City quando a reserva é efetivamente resgatada ou marcada como no-show. Não assinalado: é enviado quando a reserva é criada. |
Destinos e produtos permitidos / excluídos | Limita o que esta conexão pode reservar, para além das definições do revendedor. Útil se tiver várias conexões com Go City, por exemplo, uma por destino. |
Nome da conexão | Permite distinguir as conexões, por exemplo, 'Go City Paris' e 'Go City Sydney'. |
Test | Coloca todas as reservas de Go City em modo de teste e permite que apenas equipamento em modo de teste as leia. Desassinale antes de entrar em produção. |
Tipos de passe | Os tipos de passe que aceita: ALL_INCLUSIVE, EXPLORER, SINGLE_SELL. Todos assinalados por predefinição. |
Variantes de passe | As variantes que aceita: STANDARD, DEFAULT, PLUS, X_FROM_Y, HIGHLIGHTS, ESSENTIALS, SPOTLIGHT, MINI, SINGLE_SELL, CUSTOM. Todas assinaladas por predefinição. |
Marcas de passe | As marcas que aceita: GO_CITY, BIG_BUS, GREAT, EMPIRE_STATE_BUILDING, ONE_WORLD_OBSERVATORY, TOP_OF_THE_ROCK, EDGE, AIRBNB. Todas assinaladas por predefinição. |
📗 DICA
Adicione o prefixo 'uat:' ao nome de utilizador para direcionar a conexão para o ambiente de staging de Go City. Independentemente disso, a caixa 'Test' coloca todas as reservas de Go City em modo de teste e permite que apenas equipamento em modo de teste as leia; desassinale-a antes de receber visitantes.
Mapear produtos
Quando guarda a conexão, a Ventrata carrega a lista de ofertas de Go City (as atrações que vende) e cria uma linha por oferta e tipo de cliente (ADULT, CHILD, VIP). As ofertas que Go City já não devolve são removidas ao guardar. As novas ofertas detetadas num passe lido acrescentam uma linha automaticamente.
Leia cada passe de teste de Go City em hardware com tecnologia Ventrata ou na aplicação móvel, ou introduza o respetivo número de passe em + New Order → Redeem Voucher Code. Receberá um erro 'not mapped', e o anúncio de Go City aparece na sua conexão.
Aceda a Connections → Connections e abra a sua conexão com Go City.
Clique numa linha de anúncio (as linhas não mapeadas aparecem a vermelho), selecione o produto, a opção e a unidade Ventrata e clique em Update Mapping.
📒 NOTA
Cada linha precisa de um produto, uma opção e uma unidade.
📒 NOTA
As linhas não mapeadas são destacadas a vermelho.
📒 NOTA
Enquanto uma linha não estiver mapeada, as leituras dessa oferta falham com ' is not mapped in <connection>'.
Redemption
Imediatamente: a Ventrata comunica a visita a Go City no momento da leitura, quando a reserva é criada.
No resgate ou no no-show: com 'Redeem only on Redemption/No-show' assinalado (recomendado), a Ventrata envia o resgate quando a reserva é resgatada ou marcada como no-show.
O que é enviado para Go City: uma visita para /partner-api/v1/visit de Go City, com passNumber, offerId e netRate.
Funcionalidades da conexão em detalhe
Esta secção destina-se a quem quer conhecer os detalhes. Clique numa linha para ver como funciona cada funcionalidade.
Product Mapping | ✅ |
Mapeia cada passe listado em Go City para um produto Ventrata no Ventrata Dashboard. Quando guarda a conexão, a Ventrata carrega a lista de ofertas de Go City (as atrações que vende) e cria uma linha por oferta e tipo de cliente (ADULT, CHILD, VIP). As ofertas que Go City já não devolve são removidas ao guardar. As novas ofertas detetadas num passe lido acrescentam uma linha automaticamente. Cada linha precisa de um produto, uma opção e uma unidade. As linhas não mapeadas são destacadas a vermelho. Enquanto uma linha não estiver mapeada, as leituras dessa oferta falham com ' is not mapped in <connection>'. |
Content Sync | ❌ |
O conteúdo dos produtos não é sincronizado. Go City vende o seu próprio passe. Os seus produtos e o respetivo conteúdo permanecem na Ventrata. |
Availability Sync | ✅ |
Go Reserve: Go City obtém os seus horários em tempo real com o Availability Check OCTO da Ventrata quando um titular de passe faz uma reserva. Go Reserve: Go City obtém os seus horários em tempo real com o Availability Check OCTO da Ventrata quando um titular de passe faz uma reserva. |
Pricing Sync | ✅ |
Os preços são partilhados com Go City. A reserva utiliza o preço unitário da Ventrata (liquidação por voucher). No resgate, a Ventrata envia a Go City uma netRate igual ao preço grossista do bilhete menos o saldo direto, pelo que o seu preço grossista/líquido na Ventrata é o valor que Go City é informado de que lhe deve. Defina corretamente os preços de venda ao público e grossistas/de comissão de Go City no revendedor. |
Promotions Sync | ❌ |
As promoções não se aplicam aos passes de Go City. As suas promoções Ventrata não se aplicam às reservas feitas através da leitura de um passe. |
Bookings Sync | ✅ |
As reservas são criadas na Ventrata quando um passe é lido. As reservas de visitantes sem reserva só são criadas no momento da leitura. Os visitantes podem entrar com o passe de Go City ou com um código de barras emitido pela Ventrata, uma vez que ambos pertencem à mesma reserva. As reservas Go Reserve são feitas antecipadamente por Go City através da API OCTO da Ventrata. A Ventrata não efetua chamadas de cancelamento nem de alteração para Go City. No Go Reserve, os titulares de passes reagendam ou cancelam através de Go City (Booking Update e Booking Cancellation OCTO), e Go City cancela as reservas cujo passe deixa de ser válido. |
Pickups/Dropoff Sync | ❌ |
Não faz parte desta conexão. Os resgates de passes não incluem recolhas. |
Custom Questions Sync | ❌ |
Não faz parte desta conexão. As perguntas de reserva não são feitas nem enviadas nos resgates de passes. |
Extras Sync | ❌ |
Não faz parte desta conexão. Não é possível adicionar extras a um resgate de passe. |
Redemption Sync | ✅ |
Os resgates são enviados para Go City. A Ventrata comunica a visita a Go City no momento da leitura, quando a reserva é criada. Com 'Redeem only on Redemption/No-show' assinalado (recomendado), a Ventrata envia o resgate quando a reserva é resgatada ou marcada como no-show. Uma visita para /partner-api/v1/visit de Go City, com passNumber, offerId e netRate. |
Pass Walkup Scanning Sync | ✅ |
Lê os passes de Go City à sua entrada. Lê um código de barras ou código QR à entrada, ou introdu-lo em + New Order → Redeem Voucher Code, e este não corresponde a nenhuma reserva ou bilhete Ventrata existente. A Ventrata verifica o formato. Um número de passe de Go City tem 12 dígitos, começa por 6 ou 7 e o 9.º dígito é 1 (adulto), 2 (criança) ou 4 (VIP). Os hífenes são removidos. Qualquer outro código não é tratado como um passe de Go City. A Ventrata consulta o passe junto de Go City em tempo real. As consultas ficam em cache durante 5 minutos. |
Gift Card Sync | ❌ |
Não faz parte desta conexão. Os passes de Go City não são cartões-oferta Ventrata. |
✅ suportado · ❌ não suportado
Bom saber: limites desta conexão
Bom saber: limites desta conexão
Os tipos de cliente estão limitados a ADULT, CHILD e VIP.
As credenciais erradas não geram um erro descritivo; os campos de nome de utilizador e palavra-passe são apenas marcados como inválidos.
Se a consulta de um passe encontrar um erro HTTP ou exceder o tempo limite, o passe é tratado, sem aviso, como não encontrado.
Os códigos de barras que não correspondem ao formato de Go City são ignorados sem aviso.
Precisa de hardware com tecnologia Ventrata, da aplicação móvel ou do dashboard à sua entrada.
O revendedor Go City tem de utilizar o método de liquidação 'Bill to my account'.
Sem recolhas, extras nem perguntas de reserva; a validação de cliente, respostas e transporte é ignorada nestas encomendas.
Resolução de problemas
" is not mapped in <connection>"</b>
" is not mapped in <connection>"</b>
A oferta de Go City neste passe ainda não está mapeada para um produto Ventrata. Abra a conexão com Go City, clique na linha a vermelho e mapeie-a para um produto, uma opção e uma unidade.
"Pass not mapped in Ventrata connection"
"Pass not mapped in Ventrata connection"
Mapeie o anúncio que apareceu após a leitura.
"Redemption not allowed"
"Redemption not allowed"
"Mensagem da própria Go City (mensagens de oferta INVALID ou errorDescription FAILURE)"
"Mensagem da própria Go City (mensagens de oferta INVALID ou errorDescription FAILURE)"
Go City rejeitou o passe ou a oferta; a Ventrata apresenta o texto de Go City à equipa tal como foi recebido.
Perguntas frequentes
Os visitantes podem entrar com o passe de Go City ou precisam de um bilhete Ventrata?
Os visitantes podem entrar com o passe de Go City ou precisam de um bilhete Ventrata?
Qualquer um dos dois. O passe de Go City e qualquer código de barras emitido pela Ventrata pertencem à mesma reserva.
Posso ter mais do que uma conexão com Go City?
Posso ter mais do que uma conexão com Go City?
Sim. Utilize destinos ou produtos permitidos e excluídos para as separar, por exemplo, por destino, e atribua um nome a cada conexão.
Os titulares de passes podem reservar uma hora antecipadamente?
Os titulares de passes podem reservar uma hora antecipadamente?
Sim, com o Go Reserve. Partilhe de forma segura a chave API da página da sua conexão com a equipa de implementação de Go City ([email protected]) para o ativar.
Que valor é comunicado a Go City como devido a mim?
Que valor é comunicado a Go City como devido a mim?
A Ventrata envia uma tarifa líquida igual ao preço grossista do bilhete menos o saldo direto, pelo que deve verificar os seus preços grossistas no revendedor Go City.
Recursos úteis
📚 Mais sobre as conexões Ventrata
Informações do parceiro
Go City Limited
6 Dryden Street, London, WC2E 9NH
United Kingdom
ID de parceiro Ventrata: b880f9df-612d-4f95-9611-f64b2137b936