Salzburg Card ist die All-inclusive-Citycard von Salzburg (Österreich), herausgegeben von Tourismus Salzburg, mit einem freien Eintritt in die Sehenswürdigkeiten und Museen der Stadt sowie Nutzung der öffentlichen Verkehrsmittel für 24, 48 oder 72 Stunden. Attraktionen bringt sie rund 240.000 Karteninhaber pro Jahr und etwa 1,2 Millionen Eintritte; die wichtigsten Übernachtungsmärkte sind Deutschland, die USA, Großbritannien und Italien, und der Verkauf erfolgt über Hotels, Ticketschalter, den Flughafen und online. Salzburg Card nutzt Feratel als primäres Ticketingsystem.
Wenn Sie Salzburg Card mit Ventrata verbinden, können Sie Pässe von Salzburg Card 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 Salzburg Card.
Weitere Informationen zu Salzburg Card finden Sie unter salzburg.info/en/hotels-offers/salzburg-card.
Hauptwebsite | |
Tags | Destination Organization (DMO) · Multi-Attraction Pass |
Verbindungstyp | Pass-Einlösung: Sie scannen Pässe von Salzburg Card an Ihrem Eingang |
Verbindungsfunktionen | Product Mapping · Redemption Sync · Pass Walkup Scanning Sync |
Entwickelt von | Ventrata (über feratel CheckAPI) |
Mit dieser Verbindung können Sie:
Scannen und validieren Sie Salzburg Cards von Laufkundschaft auf Ventrata-Hardware (Drehkreuz, Ticketkiosk, Kassensystem/Terminal), in der mobilen App oder im Dashboard, ohne separaten Scanner oder separate App von feratel.
Legen Sie für jede gültige Karte automatisch eine Buchung in Ventrata an, sodass Besucher mit Salzburg Card in Ihren Berichten, Ihrer Kapazität und Ihrer Abrechnung erscheinen.
Erfassen Sie die Kartennutzung sofort bei feratel oder erst beim Einlass bzw. bei Nichterscheinen, wobei die Karte für Ihre Leistung als genutzt markiert wird.
So funktioniert es
Der QR-Code eines Besuchers wird auf Ventrata-Hardware oder in der mobilen App gescannt oder im Dashboard unter „Vouchercode einlösen“ (Redeem Voucher Code) eingegeben. Alternativ kann die aufgedruckte Kartennummer eingegeben werden.
Gehört der Code nicht zu einer Ihrer bestehenden Buchungen oder Tickets, prüft Ventrata in Echtzeit bei feratel, ob es sich um eine Salzburg Card handelt, die in diesem Moment für Ihre Attraktion gültig ist. Bei dieser Prüfung wird keine Nutzung erfasst.
Ist die Karte gültig, legt Ventrata unter Ihrem Wiederverkäufer Salzburg Card eine Buchung für das Produkt, die Option und die Einheit an, die Sie dieser Leistung und diesem Kartentyp (z. B. Erwachsener oder Kind) zugeordnet haben.
Die Buchung erfolgt für die früheste aktuell laufende Verfügbarkeit, sofern das Personal keine andere auswählt (z. B. an einem Ticketkiosk oder Kassensystem).
Ventrata sendet die Kartennutzung als „check with transaction“ an feratel: standardmäßig sofort oder, je nach Ihren Einstellungen, wenn die Buchung eingelöst/upgegradet oder als nicht erschienen markiert wird.
📒 HINWEIS
Der QR-Code auf der physischen Karte oder der digitalen Karte des Besuchers oder die aufgedruckte Kartennummer. Ein QR-Code auf einem Kaufbeleg ist keine Salzburg Card.
Verbindung mit Salzburg Card erstellen
🔐 Erforderliche Rollenberechtigungen: See Connections, Modify Connections
Bevor Sie beginnen:
Sie müssen eine Partnerattraktion von Salzburg Card mit einer Handelsvereinbarung mit der Tourismus Salzburg GmbH sein.
Ihre Attraktion muss von Tourismus Salzburg für Ventrata freigeschaltet sein. Tourismus Salzburg informiert feratel, und feratel aktiviert den Checkpoint Ihrer Attraktion für Ventrata.
Sie müssen an Ihrem Eingang Ventrata-Hardware (Drehkreuz, Ticketkiosk, Kassensystem/Terminal), die mobile App oder das Dashboard verwenden.
Legen Sie Salzburg Card in Ventrata als Wiederverkäufer mit korrekten Preisen (Verkaufspreis, Großhandel/Provision) und der Abrechnungsmethode „Rechnung auf mein Konto“ (Bill to my account) an.
Besorgen Sie sich Ihre fünf Zugangsdaten für feratel und mindestens eine echte Salzburg Card jedes Typs, den Sie akzeptieren (z. B. einmal Erwachsener, einmal Kind), die Ihre Leistungen enthält.
Ihre Rolle benötigt die Berechtigungen See Connections und Modify Connections.
Um der Salzburg Card als Partnerattraktion beizutreten, wenden Sie sich an Tourismus Salzburg. [email protected] Https://www.salzburg.info/en/hotels-offers/salzburg-card
Für Hilfe bei Zugangsdaten oder Einrichtung setzen Sie Ventrata Connectivity bei Ihrer Anfrage an Salzburg Card in Kopie. [email protected]
Verbindung erstellen
Gehen Sie im Ventrata Dashboard zu Verbindungen → Verbindungen (Connections → Connections), klicken Sie auf + Neue Verbindung (+ New Connection) und wählen Sie Salzburg Card aus.
Wählen Sie Ihren Wiederverkäufer Salzburg Card aus.
Geben Sie Feratel Username, Password, Tenant ID, Client ID und Client Secret ein.
Wählen Sie, wann die Einlösung an feratel gesendet wird, wie mit Tourismus Salzburg vereinbart, oder lassen Sie beide Optionen deaktiviert, um die Nutzung zu erfassen, sobald die Karte validiert und die Buchung angelegt wird.
Legen Sie optional einen Namen (Name) fest, schränken Sie Destinationen, Produkte oder Artikel ein und aktivieren Sie „Test“.
Klicken Sie auf „Verbindung erstellen“ (Create Connection) und fahren Sie mit der Zuordnung fort.
Das Verbindungsformular bietet folgende Optionen:
Reseller | Ihr Wiederverkäufer Salzburg Card (z. B. Tourismus Salzburg GmbH). Die Verbindung übernimmt dessen Preise, zugelassene Destinationen, Produkte und Artikel, und alle Kartenbuchungen werden darunter erfasst. |
Feratel Username / Password / Tenant ID / Client ID / Client Secret | Ihre Zugangsdaten für feratel von Salzburg Card. |
Redeem on Redemption/Upgrade | Senden Sie die Einlösung an feratel, wenn die Buchung in Ventrata eingelöst wird. Empfohlen, wenn Buchung und Einlass zu unterschiedlichen Zeitpunkten erfolgen. |
Redeem on No-show | Senden Sie die Einlösung an feratel, wenn die Buchung in Ventrata als nicht erschienen markiert wird, einschließlich automatischer No-Shows. |
Name | Optionaler Verbindungsname Ihrer Wahl. |
Zugelassene Destinationen, Produkte oder Artikel | Optionale zusätzliche Einschränkungen zu den Einstellungen beim Wiederverkäufer. |
Test | Versetzt alle Buchungen von Salzburg Card in den Testmodus und akzeptiert nur Scans von Geräten im Testmodus. |
📗 TIPP
Aktivieren Sie „Test“ auf der Verbindung, um alle Buchungen von Salzburg Card in den Testmodus zu versetzen und nur Scans von Geräten im Testmodus zu akzeptieren; deaktivieren Sie die Option vor dem Livegang. Testkarten tragen einen Test-Kartentyp, nicht Erwachsener oder Kind, und können daher nicht zum Einrichten der Zuordnung verwendet werden.
Produkte zuordnen
Feratel übermittelt Leistungen nicht zusammen mit ihren Kartentypen über die API. Die Ihrer Attraktion zugewiesenen Leistungen werden automatisch geladen; jeder Kartentyp (z. B. Erwachsener, Kind) erscheint als Zeile unter seiner Leistung, sobald zum ersten Mal eine Karte dieses Typs gescannt wird.
Öffnen Sie Ihre Verbindung mit Salzburg Card und prüfen Sie die von feratel geladenen Leistungen. Leistungszeilen teilen Ventrata mit, was geprüft werden soll, können aber nicht allein für den Einlass verwendet werden.
Halten Sie von jedem Typ eine echte Karte bereit (keine Testkarte).
Scannen Sie jede Karte oder geben Sie ihren Code bzw. die aufgedruckte Kartennummer unter „Vouchercode einlösen“ (Redeem Voucher Code) ein. Der erste Scan schlägt mit einem Zuordnungsfehler fehl; das ist zu erwarten, und die Karte wird dabei nicht verbraucht.
Laden Sie die Verbindungsseite neu oder klicken Sie auf „Zuordnung neu laden“ (Refresh Mapping). Für jeden gescannten Kartentyp erscheint unter der Leistung eine neue rote Zeile.
Klicken Sie auf jede Zeile, wählen Sie das Ventrata-Produkt, die Option und die Einheit aus (alle drei sind erforderlich) und klicken Sie auf „Zuordnung aktualisieren“ (Update Mapping).
Scannen Sie dieselben Karten erneut. Eine Buchung wird angelegt, und die Einlösung wird gemäß Ihren Einstellungen gesendet.
Wenn eine neue Leistung zugewiesen wird, klicken Sie zuerst auf „Zuordnung neu laden“ (Refresh Mapping) und scannen und ordnen Sie dann jeden Kartentyp zu. Bei einem neuen Kartentyp für eine bestehende Leistung scannen und ordnen Sie ihn einfach zu.
📒 HINWEIS
Wenn Sie eine Testkarte scannen, erscheint eine Zeile mit einem Test-Kartentyp; Sie können sie ohne Zuordnung lassen.
📒 HINWEIS
Wenn eine Leistung in feratel entfernt wird, löscht „Zuordnung neu laden“ (Refresh Mapping) sie samt ihren Kartentyp-Zuordnungen. Wird sie wieder hinzugefügt, laden Sie neu und scannen und ordnen Sie sie erneut zu.
Redemption
Sofort: Standard (beide Optionen deaktiviert): Die Kartennutzung wird bei feratel erfasst, sobald die Karte validiert und die Buchung angelegt wird.
Bei Einlösung oder Nichterscheinen: Mit „Einlösen bei Einlösung/Upgrade“ (Redeem on Redemption/Upgrade) wird die Nutzung gesendet, wenn die Buchung in Ventrata eingelöst oder upgegradet wird. Mit „Einlösen bei Nicht erschienen“ (Redeem on No-show) wird sie gesendet, wenn die Buchung als nicht erschienen markiert wird, einschließlich automatischer No-Shows.
Was an Salzburg Card gesendet wird: Eine Anfrage „check with transaction“ an feratel, die die Karte für Ihre Leistung als genutzt markiert. Die Einlösung in Ventrata schlägt fehl, wenn feratel sie nicht akzeptiert.
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 Salzburg Card im Ventrata Dashboard einem Ventrata-Produkt zu. Feratel übermittelt Leistungen nicht zusammen mit ihren Kartentypen über die API. Die Ihrer Attraktion zugewiesenen Leistungen werden automatisch geladen; jeder Kartentyp (z. B. Erwachsener, Kind) erscheint als Zeile unter seiner Leistung, sobald zum ersten Mal eine Karte dieses Typs gescannt wird. Wenn Sie eine Testkarte scannen, erscheint eine Zeile mit einem Test-Kartentyp; Sie können sie ohne Zuordnung lassen. Wenn eine Leistung in feratel entfernt wird, löscht „Zuordnung neu laden“ (Refresh Mapping) sie samt ihren Kartentyp-Zuordnungen. Wird sie wieder hinzugefügt, laden Sie neu und scannen und ordnen Sie sie erneut zu. |
Content Sync | ❌ |
Produktinhalte werden nicht synchronisiert. Salzburg Card verkauft einen eigenen Pass. Ihre Produkte und deren Inhalte bleiben in Ventrata. |
Availability Sync | ✅ / ❌ |
Eingeschränkt: Kartenbesuche zählen zu Ihrer Kapazität. Buchungen erfolgen für die früheste aktuell laufende Verfügbarkeit, daher zählen Kartenbesuche zu Ihrer Kapazität. Eine erfolgreiche Gültigkeitsprüfung reserviert die Leistung bei feratel nicht: Wird die Karte anderswo genutzt, bevor die Einlösung gesendet wird, lehnt feratel sie ab. |
Pricing Sync | ❌ |
Preise werden nicht mit Salzburg Card synchronisiert. Buchungen verwenden die Preise (Verkaufspreis, Großhandel/Provision), die bei Ihrem Wiederverkäufer Salzburg Card definiert sind; dieser muss die Abrechnungsmethode „Rechnung auf mein Konto“ (Bill to my account) verwenden. |
Promotions Sync | ❌ |
Werbeaktionen gelten nicht für Pässe von Salzburg Card. Ihre Ventrata-Werbeaktionen gelten nicht für Buchungen, die durch das Scannen eines Passes entstehen. |
Bookings Sync | ✅ / ❌ |
Eingeschränkt: Buchungen werden nur angelegt, wenn ein Pass gescannt wird. Eine Buchung pro gültiger Karte, automatisch unter dem Wiederverkäufer Salzburg Card angelegt, für die früheste aktuell laufende Verfügbarkeit, sofern das Personal keine andere auswählt. Die aufgedruckte Kartennummer wird als Wiederverkäufer-Referenz und auf der Rechnung erfasst. Produkt, Option und Einheit ergeben sich aus der Zuordnung pro Leistung und Kartentyp. In feratel erfasste Einlösungen können nicht aus Ventrata rückgängig gemacht 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 Salzburg Card gesendet. Standard (beide Optionen deaktiviert): Die Kartennutzung wird bei feratel erfasst, sobald die Karte validiert und die Buchung angelegt wird. Mit „Einlösen bei Einlösung/Upgrade“ (Redeem on Redemption/Upgrade) wird die Nutzung gesendet, wenn die Buchung in Ventrata eingelöst oder upgegradet wird. Mit „Einlösen bei Nicht erschienen“ (Redeem on No-show) wird sie gesendet, wenn die Buchung als nicht erschienen markiert wird, einschließlich automatischer No-Shows. Eine Anfrage „check with transaction“ an feratel, die die Karte für Ihre Leistung als genutzt markiert. Die Einlösung in Ventrata schlägt fehl, wenn feratel sie nicht akzeptiert. |
Pass Walkup Scanning Sync | ✅ |
Sie scannen Pässe von Salzburg Card an Ihrem Eingang. Der QR-Code eines Besuchers wird auf Ventrata-Hardware oder in der mobilen App gescannt oder im Dashboard unter „Vouchercode einlösen“ (Redeem Voucher Code) eingegeben. Alternativ kann die aufgedruckte Kartennummer eingegeben werden. Gehört der Code nicht zu einer Ihrer bestehenden Buchungen oder Tickets, prüft Ventrata in Echtzeit bei feratel, ob es sich um eine Salzburg Card handelt, die in diesem Moment für Ihre Attraktion gültig ist. Bei dieser Prüfung wird keine Nutzung erfasst. Ist die Karte gültig, legt Ventrata unter Ihrem Wiederverkäufer Salzburg Card eine Buchung für das Produkt, die Option und die Einheit an, die Sie dieser Leistung und diesem Kartentyp (z. B. Erwachsener oder Kind) zugeordnet haben. |
Gift Card Sync | ❌ |
Nicht Teil dieser Verbindung. Pässe von Salzburg Card sind keine Ventrata-Geschenkkarten. |
✅ unterstützt · ✅ / ❌ eingeschränkt · ❌ nicht unterstützt
Gut zu wissen: Einschränkungen dieser Verbindung
Gut zu wissen: Einschränkungen dieser Verbindung
Kartentypen können erst zugeordnet werden, nachdem eine echte Karte dieses Typs einmal gescannt wurde.
Testkarten können nicht zum Einrichten der Zuordnung für Erwachsene oder Kinder verwendet werden.
Gültigkeitsregeln (Kartenzeitraum, Anzahl der Nutzungen, Zeitfenster für Doppelnutzung) werden vom Kartenherausgeber in feratel festgelegt.
In feratel erfasste Einlösungen können nicht aus Ventrata rückgängig gemacht werden.
Wenn Buchung und Einlass zu unterschiedlichen Zeitpunkten erfolgen, könnte die Karte zwischenzeitlich anderswo genutzt werden, sofern Sie nicht „Einlösen bei Einlösung/Upgrade“ (Redeem on Redemption/Upgrade) aktivieren.
Fehlerbehebung
„Zuordnungsfehler beim ersten Scan einer Karte“
„Zuordnungsfehler beim ersten Scan einer Karte“
Beim ersten Scan eines Kartentyps zu erwarten. Die Karte wird nicht verbraucht. Laden Sie die Verbindungsseite neu, ordnen Sie die neue Zeile zu und scannen Sie erneut.
„Keine Buchung gefunden“
„Keine Buchung gefunden“
Der gescannte Code ist keine Salzburg Card, zum Beispiel der QR-Code auf einem Kaufbeleg. Scannen Sie den QR-Code auf der Karte oder der digitalen Karte oder geben Sie die aufgedruckte Kartennummer ein.
„Karte als ungültig abgelehnt (Meldung von feratel)“
„Karte als ungültig abgelehnt (Meldung von feratel)“
Spiegelt den Status der Karte und die von Tourismus Salzburg festgelegten Nutzungsregeln wider: abgelaufen, heute bereits für Ihre Leistung genutzt oder für diese Leistung nicht gültig. Kunden sollten sich wegen ihrer Karte an Tourismus Salzburg wenden.
„Karte wird gescannt, aber keine Buchung angelegt“
„Karte wird gescannt, aber keine Buchung angelegt“
Der Kartentyp ist möglicherweise noch nicht zugeordnet. Laden Sie die Verbindungsseite neu, ordnen Sie die neue Zeile zu und scannen Sie erneut. Klicken Sie bei einer neu zugewiesenen Leistung zuerst auf „Zuordnung neu laden“ (Refresh Mapping). Wenn das Problem weiterhin besteht, wenden Sie sich an den Ventrata-Support.
„Verbindung kann nicht erstellt werden oder es werden keine Leistungen geladen“
„Verbindung kann nicht erstellt werden oder es werden keine Leistungen geladen“
Möglicherweise sind die Zugangsdaten falsch oder Ihr Checkpoint ist nicht für Ventrata freigeschaltet. Prüfen Sie, ob alle fünf Zugangsdaten für feratel genau so eingegeben sind, wie Sie sie erhalten haben, und ob Ihr Checkpoint freigeschaltet ist. Wenden Sie sich dann an Ihren Ansprechpartner bei Salzburg Card und setzen Sie [email protected] in Kopie.
FAQ
Wie hängen feratel und Salzburg Card zusammen?
Wie hängen feratel und Salzburg Card zusammen?
Salzburg Card wird von der Tourismus Salzburg GmbH herausgegeben und läuft auf der Card-System-Software von feratel. feratel ist kein Wiederverkäufer: Ihre Geschäftsbeziehung besteht mit Tourismus Salzburg, und Ventrata nutzt die CheckAPI von feratel, um die Karte zu validieren und einzulösen. Jede Karte, die auf feratel läuft, benötigt in Ventrata eine eigene Verbindung und einen eigenen Wiederverkäufer.
Reserviert ein erfolgreicher Scan die Karte für meine Attraktion?
Reserviert ein erfolgreicher Scan die Karte für meine Attraktion?
Nein. Ventrata prüft die Karte zunächst, ohne eine Nutzung zu erfassen. Wird die Karte anderswo genutzt, bevor die Einlösung gesendet wird, lehnt feratel sie ab.
Wann sollte ich „Einlösen bei Einlösung/Upgrade“ (Redeem on Redemption/Upgrade) aktivieren?
Wann sollte ich „Einlösen bei Einlösung/Upgrade“ (Redeem on Redemption/Upgrade) aktivieren?
Wenn Buchung und Einlass zu unterschiedlichen Zeitpunkten erfolgen, zum Beispiel an einem Ticketkiosk oder bei einem Vorverkauf am Kassensystem, damit die Kartennutzung beim Einlass erfasst wird.
Nützliche Ressourcen
📚 Mehr über Ventrata-Verbindungen
Partnerinformationen
Tourismus Salzburg GmbH
Auerspergstraße 6, 5020 Salzburg
Österreich
Ventrata-Partner-ID: 01a144a3-e3fa-7458-938a-1324332c0830