CityPASS ist ein Pass für mehrere Attraktionen, der den Eintritt zu einer festen Auswahl bekannter Attraktionen in siebzehn nordamerikanischen Reisezielen – von New York, Chicago und Boston bis Toronto, Orlando und Südkalifornien – zu einem einzigen ermäßigten Preis bündelt. Er wird über Verbraucherwerbung, die Reisebranche, Hotels und Affiliates vertrieben. Betreibern bringt er vorab bezahlte Passinhaber, die sich schon vor der Anreise für mehrere Eintritte entscheiden und diese während eines mehrtägigen Aufenthalts besuchen – Reisende, die ein komplettes Stadtprogramm planen.
Wenn Sie CityPASS mit Ventrata verbinden, können Sie Pässe von CityPASS 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 CityPASS.
Weitere Informationen zu CityPASS finden Sie unter citypass.com.
📒 HINWEIS
Sie möchten stattdessen Tickets von CityPASS weiterverkaufen? Siehe CityPASS: Betreiber-Backend.
🏆 CityPASS Preferred Integration Partner. Ventrata wurde als CityPASS Preferred Integration Partner ausgezeichnet und unterstützt den vollen Funktionsumfang der Integration mit CityPASS.
Hauptwebsite | |
Tags | Multi-Attraction Pass |
Verbindungstyp | Pass-Einlösung: Sie scannen Pässe von CityPASS an Ihrem Eingang |
Verbindungsfunktionen | Product Mapping · Availability Sync · Pricing Sync · Bookings Sync · Redemption Sync · Pass Walkup Scanning Sync |
Entwickelt von | Ventrata (über CityPASS API) |
Mit dieser Verbindung können Sie:
Barcodes von CityPASS und C-Ticket an Ihrem Eingang scannen und in Echtzeit bei CityPASS validieren.
Jeden Pass-Besuch als Buchung ohne festes Datum in Ventrata erfassen, mit dem Barcode als Wiederverkäufer-Referenz.
Das Ticket in CityPASS automatisch als verwendet markieren, entweder beim Scannen oder später, wenn es eingelöst oder als nicht erschienen markiert wird.
So funktioniert es
Sie scannen oder erfassen einen Barcode an Ihrem Eingang.
Wenn der Barcode mit 308458 beginnt, behandelt Ventrata ihn als Ticket von CityPASS und validiert ihn über die API von CityPASS.
Ventrata sucht die Zuordnungszeile für die Produktfamilie, die Attraktion und die Ticketklasse des Tickets. Ist sie noch nicht zugeordnet, schlägt der Scan fehl, bis Sie die Zuordnung vornehmen.
Ventrata legt eine Buchung ohne festes Datum für das zugeordnete Produkt, die Option und die Einheit an, Menge 1, mit dem Barcode als Wiederverkäufer-Referenz.
Ventrata teilt CityPASS mit, dass das Ticket verwendet wurde. Wenn Mitarbeitende ein Datum oder ein Zeitfenster ausgewählt haben, wird dies als Nutzungsdatum gesendet; andernfalls wird die aktuelle Uhrzeit verwendet.
📒 HINWEIS
Nur Barcodes, die mit 308458 beginnen, werden als CityPASS behandelt.
Verbindung mit CityPASS erstellen
🔐 Erforderliche Rollenberechtigungen: See Connections, Modify Connections
Bevor Sie beginnen:
CityPASS ist in Ventrata als Wiederverkäufer eingerichtet; im Verbindungsformular werden Sie aufgefordert, einen auszuwählen.
Sie haben einen Benutzer und ein Passwort von CityPASS für die API von CityPASS.
Verbindung mit CityPASS erstellen
Wählen Sie den Wiederverkäufer CityPASS aus.
Geben Sie den Benutzer und das Passwort für CityPASS ein.
Legen Sie mit Is affiliate / Is not affiliate und Product families fest, welche Tickets akzeptiert werden.
Speichern Sie. Ventrata prüft die Zugangsdaten, indem die Liste der Einlöseprodukte von CityPASS abgerufen wird; schlägt das fehl, werden die Felder für Benutzer und Passwort als ungültig markiert.
Das Verbindungsformular bietet folgende Optionen:
Reseller | Der Wiederverkäufer, dessen Einstellungen die Verbindung verwendet und in dessen Namen Buchungen erfasst werden. |
Benutzer für CityPASS | API-Benutzer von CityPASS. Mit dem Präfix „uat:“ greift die Verbindung auf die Integrations-(Test-)Umgebung von CityPASS zu. |
Passwort für CityPASS | API-Passwort von CityPASS. |
Is affiliate | Tickets akzeptieren, bei denen CityPASS die Attraktion als Affiliate/Inventar kennzeichnet. Standardmäßig aktiviert. |
Is not affiliate | Tickets akzeptieren, bei denen CityPASS die Attraktion nicht als Affiliate/Inventar kennzeichnet. Standardmäßig aktiviert. |
Product families | Welche Produktfamilien von CityPASS Sie akzeptieren: CityPASS und/oder CTicket. Standardmäßig beide. |
📗 TIPP
Stellen Sie dem Benutzer „uat:“ voran, damit die Verbindung auf die Integrations-(Test-)Umgebung von CityPASS zugreift.
Produkte zuordnen
Die Zeilen stammen aus der Liste der Einlöseprodukte von CityPASS (/ventrata/redemptionproducts). Neue Ticketklassen, die beim Scannen erkannt werden, fügen automatisch Zeilen hinzu.
Öffnen Sie die Verbindung und ordnen Sie jede Zeile von CityPASS einem Ventrata-Produkt, einer Option und einer Einheit zu.
📒 HINWEIS
Jede Zeile benötigt ein Produkt, eine Option und eine Einheit.
📒 HINWEIS
Solange eine Zeile nicht zugeordnet ist, schlagen Scans für diese Ticketklasse mit „ is not mapped in <connection>“ fehl.
Redemption
Sofort: Standard: Beim Scannen teilt Ventrata CityPASS mit, dass das Ticket REDEEMED ist (Use-Aufruf).
Bei Einlösung oder Nichterscheinen: „Redeem on undefer / no-show“ wird unterstützt. Ventrata sendet den Use-Aufruf später, mit REDEEMED oder dem Ventrata-Ticketstatus in Großbuchstaben, zum Beispiel NOSHOW oder CANCELLED.
Was an CityPASS gesendet wird: der Status des Tickets (REDEEMED oder im verzögerten Modus der Ticketstatus) und das Nutzungsdatum: Datum/Uhrzeit der Buchung, falls Mitarbeitende eines ausgewählt haben, andernfalls der aktuelle Zeitpunkt. Es wird kein Preis gesendet.
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 CityPASS im Ventrata Dashboard einem Ventrata-Produkt zu. Die Zeilen stammen aus der Liste der Einlöseprodukte von CityPASS (/ventrata/redemptionproducts). Neue Ticketklassen, die beim Scannen erkannt werden, fügen automatisch Zeilen hinzu. Jede Zeile benötigt ein Produkt, eine Option und eine Einheit. Solange eine Zeile nicht zugeordnet ist, schlagen Scans für diese Ticketklasse mit „ is not mapped in <connection>“ fehl. |
Content Sync | ❌ |
Produktinhalte werden nicht synchronisiert. CityPASS verkauft einen eigenen Pass. Ihre Produkte und deren Inhalte bleiben in Ventrata. |
Availability Sync | ✅ |
Mit CityPASS wird keine Verfügbarkeit synchronisiert. Mit CityPASS wird keine Verfügbarkeit synchronisiert. |
Pricing Sync | ✅ |
Preise werden mit CityPASS geteilt. Die Buchung verwendet Ihren Ventrata-Einheitspreis mit Abrechnung per Voucher. Es werden keine Preisinformationen an CityPASS gesendet. |
Promotions Sync | ❌ |
Werbeaktionen gelten nicht für Pässe von CityPASS. 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 werden beim Scannen angelegt, ohne festes Datum, Menge 1 (ein Ticket pro Barcode), mit dem Barcode als Wiederverkäufer-Referenz. Es gibt keinen Stornierungsaufruf an CityPASS. Im verzögerten Modus kann ein stornierter Ticketstatus oder ein Nichterscheinen im Use-Aufruf an CityPASS weitergegeben werden. |
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 CityPASS gesendet. Standard: Beim Scannen teilt Ventrata CityPASS mit, dass das Ticket REDEEMED ist (Use-Aufruf). „Redeem on undefer / no-show“ wird unterstützt. Ventrata sendet den Use-Aufruf später, mit REDEEMED oder dem Ventrata-Ticketstatus in Großbuchstaben, zum Beispiel NOSHOW oder CANCELLED. Der Status des Tickets (REDEEMED oder im verzögerten Modus der Ticketstatus) und das Nutzungsdatum: Datum/Uhrzeit der Buchung, falls Mitarbeitende eines ausgewählt haben, andernfalls der aktuelle Zeitpunkt. Es wird kein Preis gesendet. |
Pass Walkup Scanning Sync | ✅ |
Sie scannen Pässe von CityPASS an Ihrem Eingang. Sie scannen oder erfassen einen Barcode an Ihrem Eingang. Wenn der Barcode mit 308458 beginnt, behandelt Ventrata ihn als Ticket von CityPASS und validiert ihn über die API von CityPASS. Ventrata sucht die Zuordnungszeile für die Produktfamilie, die Attraktion und die Ticketklasse des Tickets. Ist sie noch nicht zugeordnet, schlägt der Scan fehl, bis Sie die Zuordnung vornehmen. |
Gift Card Sync | ❌ |
Nicht Teil dieser Verbindung. Pässe von CityPASS sind keine Ventrata-Geschenkkarten. |
✅ unterstützt · ❌ nicht unterstützt
Gut zu wissen: Einschränkungen dieser Verbindung
Gut zu wissen: Einschränkungen dieser Verbindung
Ein Ticket pro Barcode.
Nur Barcodes, die mit 308458 beginnen, werden erkannt.
Keine Abholungen, Extras oder Buchungsfragen.
Keine Synchronisierung von Verfügbarkeit oder Preisen.
Fehlerbehebung
" is not mapped in <connection>"</b>
" is not mapped in <connection>"</b>
Diese Produktfamilie, Attraktion und Ticketklasse von CityPASS ist noch keinem Ventrata-Produkt zugeordnet. Ordnen Sie die Zeile in der Verbindung mit CityPASS einem Produkt, einer Option und einer Einheit zu.
„Redemption not allowed“
„Redemption not allowed“
„Pass expired, cancelled, or already used“
„Pass expired, cancelled, or already used“
„Eigener Meldungstext von CityPASS“
„Eigener Meldungstext von CityPASS“
CityPASS hat das Ticket aus einem anderen Grund abgelehnt; Ventrata zeigt die Meldung unverändert an.
📚 Mehr über Ventrata-Verbindungen
Partnerinformationen
City Pass, Inc.
Ventrata-Partner-ID: 41927759-10fb-4011-9315-aa4ece876c67