Zum Hauptinhalt springen

Go City: Wiederverkäufer-Verbindung

Pässe von Go City mit Ventrata an Ihrem Eingang scannen, validieren und einlösen sowie die Verbindung einrichten und zuordnen.

Go City logo

 

Go City ist das weltweit größte Unternehmen für Pässe für mehrere Attraktionen und verkauft Pässe für mehr als 1.500 Attraktionen, Touren und Aktivitäten in über 25 Reisezielen auf vier Kontinenten. Betreibern bringt Go City vorab bezahlte Passinhaber aus allen wichtigen Quellmärkten, die außerhalb der Spitzenzeiten kommen und für sie neue Attraktionen ausprobieren – rund 12 Millionen Attraktionsbesuche pro Jahr.

 

Wenn Sie Go City mit Ventrata verbinden, können Sie Pässe von Go City an Ihrem Eingang scannen, validieren und einlösen – an Drehkreuzen, Kiosken und Kassenterminals mit Ventrata, in der mobilen App oder im Ventrata Dashboard, ohne separate App von Go City.

 

Weitere Informationen zu Go City finden Sie unter gocity.com.

 

📒 HINWEIS

Sie möchten stattdessen Pässe von Go City weiterverkaufen? Siehe Go City: Betreiber-Backend.

 

🏆 Go City Platinum Preferred Connectivity Partner 2026. Ventrata wurde im ersten Jahr des Programms als erster Platinum-Partner von Go City ausgezeichnet, weil Ventrata den vollen Funktionsumfang unterstützt: Kapazitätsreservierungen in Echtzeit, doppelte Validierung und dynamische Einlösung. Ventrata war außerdem das erste System, das auf die neueste Direct Connect API von Go City umgestellt hat.

 

Hauptwebsite

gocity.com

Tags

Multi-Attraction Pass

Verbindungstyp

Pass-Einlösung: Sie scannen Pässe von Go City an Ihrem Eingang

Verbindungsfunktionen

Product Mapping · Availability Sync · Pricing Sync · Bookings Sync · Redemption Sync · Pass Walkup Scanning Sync

Entwickelt von

Ventrata (über die Go City Direct Connect API & die OCTO API von Ventrata)

 

Mit dieser Verbindung können Sie:

  • Pässe von Go City von Laufkundschaft an Ihren Drehkreuzen, Kiosken und Kassen mit Ventrata, in der mobilen App oder im Dashboard scannen, validieren und einlösen – ohne separate App von Go City und ohne manuelle Dateneingabe („Direct Connect“ von Go City).

  • Passinhabern ermöglichen, in der App oder im Reservierungsportal von Go City ein Datum und eine Uhrzeit vorab zu buchen, auf Basis Ihrer Live-Verfügbarkeit in Ventrata („Go Reserve“ von Go City).

  • Jeden Besuch über Go City als Buchung in Ventrata erfassen, mit der Passnummer als Wiederverkäufer-Referenz.

  • Jede Einlösung automatisch an Go City zurückmelden, zusammen mit dem Nettopreis, den Go City Ihnen schuldet.

 

So funktioniert es

  1. Sie scannen am Eingang einen Barcode oder QR-Code oder geben ihn unter + Neue Bestellung → Vouchercode einlösen (+ New Order → Redeem Voucher Code) ein, und er passt zu keiner bestehenden Ventrata-Buchung und keinem Ticket.

  2. Ventrata prüft das Format. Eine Passnummer von Go City hat 12 Ziffern, beginnt mit 6 oder 7, und ihre 9. Ziffer ist 1 (Erwachsener), 2 (Kind) oder 4 (VIP). Bindestriche werden entfernt. Alles andere wird nicht als Pass von Go City behandelt.

  3. Ventrata fragt den Pass in Echtzeit bei Go City ab. Abfragen werden 5 Minuten lang zwischengespeichert.

  4. Für jedes gültige Angebot auf dem Pass legt Ventrata eine Buchung ohne festes Datum für das zugeordnete Produkt, die Option und die Einheit an. Die Wiederverkäufer-Referenz ist /. Ein Pass kann mehrere Angebote enthalten, sodass ein Scan mehrere Buchungen erzeugen kann.

  5. Wenn ein Angebot noch nicht zugeordnet ist, schlägt der Scan fehl, bis Sie die Zuordnung vornehmen.

  6. Ventrata meldet den Besuch an Go City: standardmäßig beim Scannen oder, wenn Sie die Einlösung verzögern, wenn das Ticket eingelöst oder als nicht erschienen markiert wird.

📒 HINWEIS

12-stellige Passnummer, die mit 6 oder 7 beginnt; die 9. Ziffer ist 1 (Erwachsener), 2 (Kind) oder 4 (VIP). Bindestriche werden entfernt. Codes, die nicht passen, werden ohne Meldung ignoriert und nicht als Go City behandelt.

 

Vorab gebuchte Besuche

„Go Reserve“ von Go City. Passinhaber wählen in der App oder im Reservierungsportal von Go City ein Datum und eine Uhrzeit. Go City liest Ihre Live-Verfügbarkeit mit dem OCTO Availability Check von Ventrata und bucht mit OCTO Booking Reservation und Booking Confirmation. Passinhaber können umbuchen oder stornieren (OCTO Booking Update und Booking Cancellation), und Go City storniert diese Buchungen automatisch, wenn ein Pass ungültig wird. Um die Funktion zu aktivieren, kopieren Sie den API-Schlüssel, der auf Ihrer Verbindungsseite für Go City (über der Angebotstabelle) angezeigt wird, und teilen Sie ihn auf sicherem Weg mit dem Implementierungsteam von Go City ([email protected]) mit der Bitte, Go Reserve zu aktivieren.

 

Verbindung mit Go City erstellen

🔐 Erforderliche Rollenberechtigungen: See Connections, Modify Connections

 

Bevor Sie beginnen:

  • Sie sind Attraktionspartner von Go City, und Ihre Produkte sind bereits im System von Go City vorhanden.

  • Sie nutzen an Ihrem Eingang Hardware mit Ventrata (Drehkreuz, Ticketkiosk, Kasse/Terminal), die mobile Ventrata-App oder das Dashboard.

  • Sie haben Go City in Ventrata als Wiederverkäufer mit korrekten Verkaufs- und Großhandels-/Provisionspreisen angelegt.

  • Der Wiederverkäufer Go City verwendet die Abrechnungsmethode „Rechnung auf mein Konto“ (Bill to my account).

  • Sie müssen bereits Attraktionspartner von Go City sein, und Ihre Produkte müssen im System von Go City eingerichtet sein. Wenn Sie noch nicht mit Go City zusammenarbeiten, wenden Sie sich an das Team für Nord- und Südamerika. [email protected] Https://gocity.com/en/work-with-us

  • Team für EMEA. [email protected]

  • Team für APAC. [email protected]

 

Zugangsdaten und Testpässe von Go City erhalten

  1. Senden Sie eine E-Mail an [email protected] und fordern Sie Produktions-Zugangsdaten für die Direct Connect API sowie für jedes Produkt einen Produktions-Testpass jedes Typs (Erwachsener, Kind, Familiarization) an.

  2. Bewahren Sie den Benutzernamen, das Passwort und die Testpässe auf, die Go City Ihnen sendet.

 

Verbindung mit Go City erstellen

  1. Gehen Sie in Ihrem Ventrata Dashboard zu Verbindungen → Verbindungen (Connections → Connections), klicken Sie auf + Neue Verbindung (+ New Connection) und wählen Sie Go City aus.

  2. Wählen Sie den Wiederverkäufer Go City aus und geben Sie den Benutzernamen und das Passwort für Go City ein.

  3. Aktivieren Sie „Redeem only on Redemption/No-show“ (empfohlen).

  4. Lassen Sie optional Destinationen oder Produkte zu oder schließen Sie sie aus, und geben Sie der Verbindung einen Namen.

  5. Aktivieren Sie „Test“ nur während der Testphase.

  6. Klicken Sie auf Verbindung erstellen (Create Connection). Ventrata prüft die Zugangsdaten beim Speichern.

Go Reserve aktivieren (optional)

  1. Kopieren Sie den API-Schlüssel, der auf Ihrer Verbindungsseite für Go City über der Angebotstabelle angezeigt wird.

  2. Teilen Sie ihn auf sicherem Weg mit dem Implementierungsteam von Go City ([email protected]) und bitten Sie darum, Go Reserve zu aktivieren.

 

Das Verbindungsformular bietet folgende Optionen:

Reseller

Die Verbindung verwendet die Konfiguration dieses Wiederverkäufers (Preise, zugelassene und ausgeschlossene Produkte) und erfasst alle Buchungen in dessen Namen.

Benutzername für Go City

Basic-Auth-Benutzer für die Partner-API von Go City. Mit dem Präfix „uat:“ greift die Verbindung auf die Staging-Umgebung von Go City zu.

Passwort für Go City

Basic-Auth-Passwort für die Partner-API von Go City.

Redeem only on Redemption/No-show

Aktiviert (empfohlen): Ventrata sendet die Einlösung an Go City, wenn die Buchung tatsächlich eingelöst oder als nicht erschienen markiert wird. Deaktiviert: Sie wird beim Anlegen der Buchung gesendet.

Zugelassene / ausgeschlossene Destinationen und Produkte

Schränkt zusätzlich zu den Einstellungen des Wiederverkäufers ein, was über diese Verbindung gebucht werden kann. Nützlich, wenn Sie mehrere Verbindungen mit Go City betreiben, zum Beispiel eine pro Reiseziel.

Verbindungsname

Damit können Sie Verbindungen unterscheiden, zum Beispiel „Go City Paris“ und „Go City Sydney“.

Test

Versetzt alle Buchungen von Go City in den Testmodus und erlaubt das Scannen nur mit Geräten im Testmodus. Deaktivieren Sie die Option vor dem Livegang.

Pass types

Welche Passtypen Sie akzeptieren: ALL_INCLUSIVE, EXPLORER, SINGLE_SELL. Standardmäßig sind alle aktiviert.

Pass variants

Welche Varianten Sie akzeptieren: STANDARD, DEFAULT, PLUS, X_FROM_Y, HIGHLIGHTS, ESSENTIALS, SPOTLIGHT, MINI, SINGLE_SELL, CUSTOM. Standardmäßig sind alle aktiviert.

Pass brands

Welche Marken Sie akzeptieren: GO_CITY, BIG_BUS, GREAT, EMPIRE_STATE_BUILDING, ONE_WORLD_OBSERVATORY, TOP_OF_THE_ROCK, EDGE, AIRBNB. Standardmäßig sind alle aktiviert.

📗 TIPP

Stellen Sie dem Benutzernamen „uat:“ voran, damit die Verbindung auf die Staging-Umgebung von Go City zugreift. Unabhängig davon versetzt das Kontrollkästchen „Test“ alle Buchungen von Go City in den Testmodus und erlaubt das Scannen nur mit Geräten im Testmodus; deaktivieren Sie es, bevor Sie Besucher empfangen.

 

Produkte zuordnen

Wenn Sie die Verbindung speichern, lädt Ventrata die Angebotsliste von Go City (die verkauften Attraktionen) und legt pro Angebot und Kundentyp (ADULT, CHILD, VIP) eine Zeile an. Angebote, die Go City nicht mehr zurückgibt, werden beim Speichern entfernt. Neue Angebote auf einem gescannten Pass fügen automatisch eine Zeile hinzu.

  1. Scannen Sie jeden Testpass von Go City an Hardware mit Ventrata oder in der mobilen App, oder geben Sie die Passnummer unter + Neue Bestellung → Vouchercode einlösen (+ New Order → Redeem Voucher Code) ein. Sie erhalten einen Fehler „not mapped“, und das Angebot von Go City erscheint in Ihrer Verbindung.

  2. Gehen Sie zu Verbindungen → Verbindungen (Connections → Connections) und öffnen Sie Ihre Verbindung mit Go City.

  3. Klicken Sie auf eine Angebotszeile (nicht zugeordnete Zeilen sind rot), wählen Sie das Ventrata-Produkt, die Option und die Einheit aus und klicken Sie auf „Zuordnung aktualisieren“ (Update Mapping).

📒 HINWEIS

Jede Zeile benötigt ein Produkt, eine Option und eine Einheit.

📒 HINWEIS

Nicht zugeordnete Zeilen sind rot hervorgehoben.

📒 HINWEIS

Solange eine Zeile nicht zugeordnet ist, schlagen Scans dieses Angebots mit „ is not mapped in <connection>“ fehl.

 

Redemption

  • Sofort: Ventrata meldet den Besuch beim Scannen an Go City, wenn die Buchung angelegt wird.

  • Bei Einlösung oder Nichterscheinen: Wenn „Redeem only on Redemption/No-show“ aktiviert ist (empfohlen), sendet Ventrata die Einlösung, wenn die Buchung eingelöst oder als nicht erschienen markiert wird.

  • Was an Go City gesendet wird: Ein Besuch an /partner-api/v1/visit von Go City mit passNumber, offerId und netRate.

 

Verbindungsfunktionen im Detail

Dieser Abschnitt richtet sich an alle, die es genau wissen möchten. Klicken Sie auf eine Zeile, um zu sehen, wie die jeweilige Funktion funktioniert.

 

Product Mapping

✅

Sie ordnen jedes Pass-Angebot von Go City im Ventrata Dashboard einem Ventrata-Produkt zu.

Wenn Sie die Verbindung speichern, lädt Ventrata die Angebotsliste von Go City (die verkauften Attraktionen) und legt pro Angebot und Kundentyp (ADULT, CHILD, VIP) eine Zeile an. Angebote, die Go City nicht mehr zurückgibt, werden beim Speichern entfernt. Neue Angebote auf einem gescannten Pass fügen automatisch eine Zeile hinzu.

Jede Zeile benötigt ein Produkt, eine Option und eine Einheit.

Nicht zugeordnete Zeilen sind rot hervorgehoben.

Solange eine Zeile nicht zugeordnet ist, schlagen Scans dieses Angebots mit „ is not mapped in <connection>“ fehl.

Content Sync

❌

Produktinhalte werden nicht synchronisiert.

Go City verkauft einen eigenen Pass. Ihre Produkte und deren Inhalte bleiben in Ventrata.

Availability Sync

✅

Go Reserve: Go City ruft Ihre Live-Zeitfenster mit dem OCTO Availability Check von Ventrata ab, wenn ein Passinhaber eine Reservierung vornimmt.

Go Reserve: Go City ruft Ihre Live-Zeitfenster mit dem OCTO Availability Check von Ventrata ab, wenn ein Passinhaber eine Reservierung vornimmt.

Pricing Sync

✅

Preise werden mit Go City geteilt.

Die Buchung verwendet Ihren Ventrata-Einheitspreis (Abrechnung per Voucher). Bei der Einlösung sendet Ventrata Go City einen netRate, der dem Großhandelspreis des Tickets abzüglich des Direktguthabens entspricht. Ihr Großhandels-/Nettopreis in Ventrata ist also der Betrag, den Go City Ihnen laut Meldung schuldet. Legen Sie die Verkaufs- und Großhandels-/Provisionspreise von Go City beim Wiederverkäufer korrekt fest.

Promotions Sync

❌

Werbeaktionen gelten nicht für Pässe von Go City.

Ihre Ventrata-Werbeaktionen gelten nicht für Buchungen, die durch das Scannen eines Passes entstehen.

Bookings Sync

✅

Buchungen werden in Ventrata angelegt, wenn ein Pass gescannt wird.

Buchungen von Laufkundschaft werden nur beim Scannen angelegt. Besucher können entweder mit dem Pass von Go City oder mit einem von Ventrata ausgestellten Barcode eintreten, da beide zur selben Buchung gehören. Go-Reserve-Buchungen nimmt Go City vorab über die OCTO API von Ventrata vor.

Ventrata sendet keine Stornierungs- oder Änderungsaufrufe an Go City. Bei Go Reserve buchen Passinhaber über Go City um oder stornieren (OCTO Booking Update und Booking Cancellation), und Go City storniert Buchungen, deren Pass ungültig wird.

Pickups/Dropoff Sync

❌

Nicht Teil dieser Verbindung.

Pass-Einlösungen enthalten keine Abholungen.

Custom Questions Sync

❌

Nicht Teil dieser Verbindung.

Bei Pass-Einlösungen werden keine Buchungsfragen gestellt oder gesendet.

Extras Sync

❌

Nicht Teil dieser Verbindung.

Zu einer Pass-Einlösung können keine Extras hinzugefügt werden.

Redemption Sync

✅

Einlösungen werden an Go City gesendet.

Ventrata meldet den Besuch beim Scannen an Go City, wenn die Buchung angelegt wird.

Wenn „Redeem only on Redemption/No-show“ aktiviert ist (empfohlen), sendet Ventrata die Einlösung, wenn die Buchung eingelöst oder als nicht erschienen markiert wird.

Ein Besuch an /partner-api/v1/visit von Go City mit passNumber, offerId und netRate.

Pass Walkup Scanning Sync

✅

Sie scannen Pässe von Go City an Ihrem Eingang.

Sie scannen am Eingang einen Barcode oder QR-Code oder geben ihn unter + Neue Bestellung → Vouchercode einlösen (+ New Order → Redeem Voucher Code) ein, und er passt zu keiner bestehenden Ventrata-Buchung und keinem Ticket.

Ventrata prüft das Format. Eine Passnummer von Go City hat 12 Ziffern, beginnt mit 6 oder 7, und ihre 9. Ziffer ist 1 (Erwachsener), 2 (Kind) oder 4 (VIP). Bindestriche werden entfernt. Alles andere wird nicht als Pass von Go City behandelt.

Ventrata fragt den Pass in Echtzeit bei Go City ab. Abfragen werden 5 Minuten lang zwischengespeichert.

Gift Card Sync

❌

Nicht Teil dieser Verbindung.

Pässe von Go City sind keine Ventrata-Geschenkkarten.

✅ unterstützt · ❌ nicht unterstützt

 

Gut zu wissen: Einschränkungen dieser Verbindung

  • Die Kundentypen sind auf ADULT, CHILD und VIP beschränkt.

  • Falsche Zugangsdaten führen zu keiner aussagekräftigen Fehlermeldung; die Felder für Benutzername und Passwort werden lediglich als ungültig markiert.

  • Wenn bei einer Passabfrage ein HTTP-Fehler oder eine Zeitüberschreitung auftritt, wird der Pass ohne Meldung als nicht gefunden behandelt.

  • Barcodes, die nicht dem Format von Go City entsprechen, werden ohne Meldung ignoriert.

  • Sie benötigen an Ihrem Eingang Hardware mit Ventrata, die mobile App oder das Dashboard.

  • Der Wiederverkäufer Go City muss die Abrechnungsmethode „Rechnung auf mein Konto“ (Bill to my account) verwenden.

  • Keine Abholungen, Extras oder Buchungsfragen; die Validierung von Kunden-, Antwort- und Transportdaten entfällt bei diesen Bestellungen.

 

Fehlerbehebung

" is not mapped in <connection>"</b>

Das Angebot von Go City auf diesem Pass ist noch keinem Ventrata-Produkt zugeordnet. Öffnen Sie die Verbindung mit Go City, klicken Sie auf die rote Zeile und ordnen Sie sie einem Produkt, einer Option und einer Einheit zu.

„Pass not mapped in Ventrata connection“

Ordnen Sie das Angebot zu, das nach dem Scan erschienen ist.

„Redemption not allowed“

„Eigene Meldung von Go City (INVALID-Angebotsmeldungen oder FAILURE errorDescription)“

Go City hat den Pass oder das Angebot abgelehnt; Ventrata zeigt den Text von Go City den Mitarbeitenden unverändert an.

 

FAQ

Können Besucher mit dem Pass von Go City eintreten, oder benötigen sie ein Ventrata-Ticket?

Beides ist möglich. Der Pass von Go City und jeder von Ventrata ausgestellte Barcode gehören zur selben Buchung.

Kann ich mehr als eine Verbindung mit Go City betreiben?

Ja. Teilen Sie sie mit zugelassenen und ausgeschlossenen Destinationen oder Produkten auf, zum Beispiel nach Destination, und benennen Sie jede Verbindung.

Können Passinhaber vorab eine Uhrzeit buchen?

Ja, mit Go Reserve. Teilen Sie den API-Schlüssel von Ihrer Verbindungsseite auf sicherem Weg mit dem Implementierungsteam von Go City ([email protected]), um die Funktion zu aktivieren.

Welcher Betrag wird Go City als mir geschuldet gemeldet?

Ventrata sendet einen Nettopreis, der dem Großhandelspreis des Tickets abzüglich des Direktguthabens entspricht. Prüfen Sie daher Ihre Großhandelspreise beim Wiederverkäufer Go City.

 

Nützliche Ressourcen

 

📚 Mehr über Ventrata-Verbindungen

 

Partnerinformationen

Go City Limited

6 Dryden Street, London, WC2E 9NH

United Kingdom

gocity.com

 

Ventrata-Partner-ID: b880f9df-612d-4f95-9611-f64b2137b936

Verwandte Artikel
Hat dies deine Frage beantwortet?