So lösen Sie eine Go City-Karte ein

Was bedeutet das?

Go City ist ein globaler digitaler Sightseeing-Pass für mehrere Attraktionen, der in wichtigen Tourismusdestinationen weltweit angeboten wird. Kunden erwerben einen einzelnen Pass, der den Zugang zu teilnehmenden Touren, Attraktionen und Aktivitäten innerhalb einer ausgewählten Destination ermöglicht.

Wie funktioniert die Integration?

Mit der Go City Direct Connect API-Integration können mobile Palisis-Verkaufsgeräte (POS-Geräte) den QR-Code auf dem Go City-Pass eines Kunden scannen, seine Berechtigungen in Echtzeit anhand der Go City-Plattform validieren und automatisch das entsprechende Tourticket ausstellen – ohne manuelle Verarbeitung von Gutscheinen oder separate Abrechnungsschritte.

Passarten und Berechtigungen

Go City bietet zwei primäre Passmodelle an:

• All-inclusive-Pass: Ermöglicht den Eintritt zu jeder teilnehmenden Attraktion während einer festgelegten Anzahl aufeinanderfolgender Kalendertage (z. B. 1-Tages-, 2-Tages-, 3-Tages- oder 5-Tages-Pass).
• Explorer-Pass: Ermöglicht Kunden, eine festgelegte Anzahl von Attraktionen auszuwählen (z. B. 3, 4, 5 oder 7 Aktivitäten), die über einen Zeitraum von 60 Tagen gültig sind.

Unterstützte Passagierkategorien

• Erwachsener
• Kind
• Familiarisation (FAM): Spezielle Werbepässe für Medien, Handel oder PR, die von Go City für einzelne Personen ausgestellt werden (dies sind keine Familientickets; jeder FAM-Pass berechtigt genau eine Person zum Eintritt).

Wichtige Betriebsregeln

1. Ein Besuch pro Attraktion und Pass: Ein Kunde kann eine bestimmte Attraktion oder Tour nur einmal pro Pass besuchen. Sobald ein Angebot eingelöst wurde, ist diese Berechtigung auf der Go City-Plattform dauerhaft verbraucht.
2. Der erste Scan aktiviert den Pass: Nicht verwendete Pässe sind im Allgemeinen bis zu zwei Jahre ab dem Kauf gültig. Der allererste Scan an einer beliebigen Attraktion aktiviert den Pass und startet den Countdown für die aufeinanderfolgenden Tage (z. B. wird ein 5-Tages-Pass beim ersten Scan aktiviert und läuft um Mitternacht des 5. Tages ab).
3. Eine einzelne Transaktion pro Einlösung (keine gemischten Warenkörbe): Jeder Scan eines Go City-Passes verarbeitet den Eintritt für den jeweiligen Karteninhaber. Transaktionen mit gemischtem Warenkorb (z. B. die Kombination einer Einlösung eines Go City-Passes mit einem normalen Bar-/Kartenticket in derselben Transaktion) sind auf dem Gerät strengstens untersagt.

Hier sehen Sie ein Beispiel dafür, wie ein Go City-Pass aussieht:

Was muss ich tun?

Befolgen Sie diese Schritt-für-Schritt-Anleitung, um die Einlösung von Go City-Karten für ein Betreiberkonto zu aktivieren und zu konfigurieren:

Schritt 1: Passagierkategorien einrichten

Stellen Sie sicher, dass im Konto des Betreibers unter Konto > Passagierkategorien passende Passagierkategorien konfiguriert sind:

• Erwachsener
• Kind
• Familiarisation (optional): Muss mit dem exakten Namen und Code Familiarisation konfiguriert werden, damit vom Gerät gescannte PR-/Medienpässe erkannt und nahtlos zugeordnet werden.

Schritt 2: Partner in der Partnerverwaltung verbinden

Gehen Sie zu Vertriebskanäle > Partnerverwaltung:

1. Suchen Sie nach dem Partner Go City [API] (oder GoCity [API]) und verbinden Sie ihn.

   

2. Setzen Sie die Anzahlung auf 100 %. (Da der Kunde Go City bereits bezahlt hat, erfasst Palisis eine Partneranzahlung von 100 %, sodass Tickets sofort mit einem offenen Saldo von null zur Abholung am POS gedruckt werden.)

   
3. Legen Sie den Provisionsprozentsatz entsprechend dem kommerziellen Vertrag zwischen dem Reiseveranstalter und Go City fest.

Weitere Informationen finden Sie im folgenden Artikel zur Zusammenarbeit mit Partnern:

So verwalten Sie Ihre Partner und Wiederverkäufer

Schritt 3: Regel für externe Gutschein-Platzhalter erstellen

Gehen Sie zu Vertriebskanäle > Partnerverwaltung > Externer Gutschein:

1. Wählen Sie den Partner GoCity [API] aus.
2. Erstellen Sie einen Gutscheinblock mit:
   • Gutscheintyp: WILDCARD

   • Muster: Kann für eine offene Platzhalterübereinstimmung leer gelassen oder auf das standardmäßige 12-stellige Regex-Format von Go City gesetzt werden (z. B. ^\d{11,12}$).

     
   • Felder „Von“ / „Bis“: Leer lassen.
   • Status: ACTIVE.

⚠️ Hinweis: Pro Betreiberkonto ist für den Go City-Partner nur ein WILDCARD ohne Muster zulässig.

Weitere Informationen finden Sie im folgenden Artikel zu externen Gutscheinen:

So richten Sie Ihre „externen Gutscheine“ ein

Schritt 4: Go City-Attraktionsangebote den Palisis-Produkten zuordnen

Go City weist jeder Attraktionsaktivität eine eindeutige Offer UUID zu (z. B. Keukenhof Express Shuttle oder City Centre Canal Cruise).

Ordnen Sie unter Einrichtung > Zuordnung jedes Ihrer Produkte mit der Go City Offer UUID dem entsprechenden Palisis-Produkt, Preisplan und Preis der Passagierkategorie zu. Wählen Sie dazu einfach die entsprechenden Go City-Angebote aus den Dropdown-Menüs für Produkt, Preis und Passagierkategorie aus. Um weitere hinzuzufügen, klicken Sie einfach auf das Plus-Symbol und fügen Sie alle erforderlichen Angebote hinzu.

Nach der Zuordnung ruft jeder Scan, der diesem Angebot entspricht, automatisch den korrekten Palasis-Ticketpreisplan in den Warenkorb ab.

Wie funktioniert der Einlösevorgang?

Der Einlösevorgang am mobilen Palasis-Handheld-Gerät oder mobilen Terminal ist vollständig automatisiert:

1. Schrittweise POS-Bedienung

1. Der Fahrer oder Ticketverkäufer öffnet die Palasis-Verkaufsanwendung und tippt auf das Symbol QR-Code / Scanner.
2. Scannen Sie den digitalen Go City-Pass des Kunden (auf dem Smartphone-Bildschirm) oder den ausgedruckten Papiervoucher.
3. Das Gerät fragt die Go City API in Echtzeit ab.
4. Bei erfolgreicher Validierung:
   • Das Gerät zeigt die verfügbaren Angebote gemäß der Zuordnung an. Der Verkaufsmitarbeiter muss das richtige Angebot manuell auf dem Gerätebildschirm auswählen.
   • Das Terminal zeigt einen grünen Bestätigungsbildschirm mit dem Hinweis „Gültig“ sowie dem Partner „GoCity [API]“ und dem Passagiertyp (z. B. Erwachsener, Kind) an.
   • Sobald der Verkaufsmitarbeiter auf OK klickt, wird die 100%ige Anzahlung angewendet, wodurch ein Saldo von £0,00 / €0,00 verbleibt.
   • Durch Tippen auf das Symbol Drucken wird der Boardingpass/die Quittung sofort gedruckt, ohne zur Zahlung aufzufordern.
   • Der Besuch wird im Go City-Backend erfasst, wodurch die Berechtigung für diese Attraktion dauerhaft vom Pass abgezogen wird.

2. Fehler- und Ablehnungsszenarien

Wenn ein Pass nicht akzeptiert werden kann, zeigt das Gerät einen roten Bildschirm mit dem von Go City zurückgegebenen genauen Ablehnungsgrund an:

Szenario / Fehlermeldung	Bedeutung und erforderliche Maßnahme	1. Gerätebildschirm	2. Gerätebildschirm
Eintritt verweigert – Kein Eintritt. Heute bereits besucht.	Der Kunde hat diese bestimmte Attraktion bereits früher am selben Tag besucht. Jede Attraktion kann pro Pass nur einmal besucht werden.	-	-
Eintritt verweigert – Kein Eintritt. An einem früheren Tag bereits besucht.	Die Berechtigung für diese Tour wurde bereits an einem früheren Tag verbraucht. Der Kunde kann mit demselben Pass nicht erneut eintreten.	-	-
Pass für Passnummer nicht gefunden: XXXXXXXXXXXX	Der gescannte Barcode wird von Go City nicht erkannt oder gehört zu einer anderen Destination. Bitten Sie den Kunden, seine Buchung in der Go City-App zu überprüfen.		-
Pass inaktiv / storniert	Der Pass wurde im Go City-System erstattet oder storniert. Der Kunde muss sich an den Go City-Kundendienst wenden.
Pass abgelaufen	Der Gültigkeitszeitraum für aufeinanderfolgende Tage (z. B. 5 Tage ab der ersten Aktivierung) ist abgelaufen.
Netzwerk-/Zeitüberschreitungsfehler	Das Terminal konnte die Go City API innerhalb von 10 Sekunden nicht erreichen. Überprüfen Sie die Verbindung zum Mobilfunknetz und versuchen Sie es erneut.	-	-
Pass teilweise storniert	-