Salzburg Card est la carte de ville tout compris de Salzbourg, en Autriche, émise par Tourismus Salzburg, qui donne droit à une entrée gratuite dans les sites et musées de la ville ainsi qu'aux transports publics pendant 24, 48 ou 72 heures. Pour les attractions, elle apporte environ 240 000 titulaires de carte par an et environ 1,2 million d'entrées, l'Allemagne, les États-Unis, le Royaume-Uni et l'Italie étant les principaux marchés de nuitées, avec des ventes dans les hôtels, les points de vente de billets, à l'aéroport et en ligne. Salzburg Card utilise Feratel comme système de billetterie principal.
Connecter Salzburg Card à Ventrata vous permet de scanner, contrôler et valider les pass Salzburg Card à votre entrée, sur les tourniquets, bornes, terminaux de point de vente propulsés par Ventrata, sur l'application mobile ou dans le Ventrata Dashboard, sans application Salzburg Card distincte.
Pour en savoir plus sur Salzburg Card, consultez salzburg.info/en/hotels-offers/salzburg-card.
Site web principal | |
Tags | Destination Organization (DMO) · Multi-Attraction Pass |
Type de connexion | Validation des pass : vous scannez les pass Salzburg Card à votre entrée |
Fonctionnalités de la connexion | Product Mapping · Redemption Sync · Pass Walkup Scanning Sync |
Développé par | Ventrata (via feratel CheckAPI) |
Cette connexion vous permet de :
Scannez et validez les Salzburg Cards des visiteurs sans réservation sur du matériel compatible Ventrata (tourniquet, borne de billetterie, point de vente / terminal), l'application mobile ou le Dashboard, sans scanner ni application feratel séparés.
Créez automatiquement une réservation dans Ventrata pour chaque carte valide, afin que les visiteurs Salzburg Card apparaissent dans vos rapports, votre capacité et vos règlements.
Enregistrez l'utilisation de la carte auprès de feratel instantanément, ou à l'admission ou en cas de non-présentation, en marquant la carte comme utilisée pour votre prestation.
Fonctionnement
Le code QR d'un visiteur est scanné sur du matériel compatible Ventrata ou dans l'application mobile, ou saisi dans Valider le code du bon (Redeem Voucher Code) dans le Dashboard. Le numéro de carte imprimé peut être saisi à la place.
Si le code ne correspond à aucune de vos réservations ou de vos billets existants, Ventrata vérifie en temps réel auprès de feratel s'il s'agit d'une Salzburg Card valable pour votre attraction à ce moment-là. Cette vérification n'enregistre pas d'utilisation.
Si la carte est valide, Ventrata crée une réservation sous votre revendeur Salzburg Card, pour le produit, l'option et l'unité que vous avez mappés à cette prestation et à ce type de carte (par exemple Adulte ou Enfant).
La réservation est effectuée sur la première disponibilité en cours, sauf si le personnel en choisit une (par exemple sur une borne de billetterie ou un point de vente).
Ventrata envoie l'utilisation de la carte à feratel sous forme de « check with transaction » : par défaut immédiatement, ou lorsque la réservation est validée/surclassée ou marquée comme non-présentation, selon vos paramètres.
📒 REMARQUE
Le code QR figurant sur la carte physique ou sur la carte numérique du visiteur, ou le numéro de carte imprimé. Un code QR figurant sur un reçu d'achat n'est pas une Salzburg Card.
Créer la connexion Salzburg Card
🔐 Autorisations de rôle requises : See Connections, Modify Connections
Avant de commencer :
Vous devez être une attraction partenaire de Salzburg Card et avoir un accord commercial avec Tourismus Salzburg GmbH.
Votre attraction doit être activée pour Ventrata par Tourismus Salzburg. Tourismus Salzburg en informe feratel, et feratel active le point de contrôle de votre attraction pour Ventrata.
Vous devez utiliser du matériel compatible Ventrata (tourniquet, borne de billetterie, point de vente / terminal), l'application mobile ou le Dashboard à votre entrée.
Créez Salzburg Card en tant que revendeur dans Ventrata avec une tarification correcte (prix public, prix de gros/commission) et le mode de règlement « Facturer sur mon compte » (Bill to my account).
Obtenez vos cinq identifiants feratel et au moins une vraie Salzburg Card de chaque type que vous acceptez (par exemple une carte Adulte et une carte Enfant) incluant vos prestations.
Votre rôle doit disposer des autorisations See Connections et Modify Connections.
Pour rejoindre Salzburg Card en tant qu'attraction partenaire, contactez Tourismus Salzburg. [email protected] Https://www.salzburg.info/en/hotels-offers/salzburg-card
Pour obtenir de l'aide sur les identifiants ou la configuration, mettez Ventrata Connectivity en copie de votre demande à Salzburg Card. [email protected]
Créer la connexion
Dans le Ventrata Dashboard, accédez à Les liaisons → Les liaisons (Connections → Connections), cliquez sur + Nouvelle connexion (+ New Connection) et sélectionnez Salzburg Card.
Sélectionnez votre revendeur Salzburg Card.
Saisissez le nom d'utilisateur Feratel (Username), le mot de passe (Password), le Tenant ID, l'ID client (Client ID) et le secret client (Client Secret).
Choisissez quand la validation est envoyée à feratel, comme convenu avec Tourismus Salzburg, ou laissez les deux options décochées pour enregistrer l'utilisation au moment où la carte est validée et la réservation créée.
Si vous le souhaitez, définissez un nom (Name), restreignez les destinations, produits ou articles, et cochez Test.
Cliquez sur Créer la connexion (Create Connection) et passez au mappage.
Le formulaire de connexion comporte les options suivantes :
Reseller | Votre revendeur Salzburg Card (par exemple Tourismus Salzburg GmbH). La connexion hérite de sa tarification, de ses destinations, produits et articles autorisés, et toutes les réservations par carte sont enregistrées sous ce revendeur. |
Nom d'utilisateur / Mot de passe / Tenant ID / ID client / Secret client Feratel (Feratel Username / Password / Tenant ID / Client ID / Client Secret) | Vos identifiants feratel fournis par Salzburg Card. |
Valider lors de la validation/du surclassement (Redeem on Redemption/Upgrade) | Envoyer la validation à feratel lorsque la réservation est validée dans Ventrata. Recommandé lorsque la réservation et l'admission ont lieu à des moments différents. |
Valider en cas de non-présentation (Redeem on No-show) | Envoyer la validation à feratel lorsque la réservation est marquée comme non-présentation dans Ventrata, y compris les non-présentations automatiques. |
Name | Nom de connexion facultatif de votre choix. |
Destinations, produits ou articles autorisés | Restrictions supplémentaires facultatives, en plus de celles définies sur le revendeur. |
Test | Force toutes les réservations Salzburg Card en mode test et n'accepte que les scans provenant d'équipements en mode test. |
📗 ASTUCE
Cochez Test sur la connexion pour forcer toutes les réservations Salzburg Card en mode test et n'accepter que les scans provenant d'équipements en mode test ; décochez-le avant la mise en service. Les cartes de prestation de test portent un type de carte test, et non Adulte ou Enfant : elles ne peuvent donc pas servir à configurer le mappage.
Mapper les produits
Feratel n'envoie pas les prestations avec leurs types de carte via l'API. Les prestations attribuées à votre attraction se chargent automatiquement ; chaque type de carte (par exemple Adulte, Enfant) apparaît comme une ligne sous sa prestation la première fois qu'une carte de ce type est scannée.
Ouvrez votre connexion Salzburg Card et vérifiez les prestations chargées depuis feratel. Les lignes de prestation indiquent à Ventrata ce qu'il doit vérifier, mais ne peuvent pas être utilisées seules pour l'admission.
Préparez une vraie carte de chaque type (pas une carte de prestation de test).
Scannez chaque carte, ou saisissez son code ou son numéro de carte imprimé dans Valider le code du bon (Redeem Voucher Code). Le premier scan échoue avec une erreur de mappage ; c'est normal et la carte n'est pas consommée.
Rechargez la page de la connexion ou cliquez sur Actualiser le mappage (Refresh Mapping). Une nouvelle ligne rouge apparaît sous la prestation pour chaque type de carte scanné.
Cliquez sur chaque ligne, sélectionnez le produit, l'option et l'unité Ventrata (tous trois obligatoires) et cliquez sur Mettre à jour le mappage (Update Mapping).
Scannez à nouveau les mêmes cartes. Une réservation est créée et la validation est envoyée selon vos paramètres.
Lorsqu'une nouvelle prestation est attribuée, cliquez d'abord sur Actualiser le mappage (Refresh Mapping), puis scannez et mappez chaque type de carte. Pour un nouveau type de carte sur une prestation existante, il suffit de le scanner et de le mapper.
📒 REMARQUE
Si vous scannez une carte de prestation de test, une ligne de type de carte test apparaît ; vous pouvez la laisser non mappée.
📒 REMARQUE
Lorsqu'une prestation est supprimée dans feratel, Actualiser le mappage (Refresh Mapping) la supprime avec ses mappages de types de carte. Si elle réapparaît, actualisez, puis scannez-la et mappez-la à nouveau.
Redemption
Immédiatement : par défaut (les deux options décochées), l'utilisation de la carte est enregistrée auprès de feratel au moment où la carte est validée et la réservation créée.
À la validation ou en cas de non-présentation : avec Valider lors de la validation/du surclassement (Redeem on Redemption/Upgrade), l'utilisation est envoyée lorsque la réservation est validée ou surclassée dans Ventrata. Avec Valider en cas de non-présentation (Redeem on No-show), elle est envoyée lorsque la réservation est marquée comme non-présentation, y compris les non-présentations automatiques.
Ce qui est envoyé à Salzburg Card : une requête « check with transaction » à feratel, qui marque la carte comme utilisée pour votre prestation. La validation dans Ventrata échoue si feratel ne l'accepte pas.
Fonctionnalités de la connexion en détail
Cette section s'adresse à ceux qui veulent les détails. Cliquez sur une ligne pour voir comment fonctionne chaque fonctionnalité.
Product Mapping | ✅ |
Vous mappez chaque offre de pass Salzburg Card à un produit Ventrata dans le Ventrata Dashboard. Feratel n'envoie pas les prestations avec leurs types de carte via l'API. Les prestations attribuées à votre attraction se chargent automatiquement ; chaque type de carte (par exemple Adulte, Enfant) apparaît comme une ligne sous sa prestation la première fois qu'une carte de ce type est scannée. Si vous scannez une carte de prestation de test, une ligne de type de carte test apparaît ; vous pouvez la laisser non mappée. Lorsqu'une prestation est supprimée dans feratel, Actualiser le mappage (Refresh Mapping) la supprime avec ses mappages de types de carte. Si elle réapparaît, actualisez, puis scannez-la et mappez-la à nouveau. |
Content Sync | ❌ |
Le contenu des produits n'est pas synchronisé. Salzburg Card vend son propre pass. Vos produits et leur contenu restent dans Ventrata. |
Availability Sync | ✅ / ❌ |
Limité : les visites avec carte comptent dans votre capacité. Les réservations sont placées sur la première disponibilité en cours : les visites avec carte comptent donc dans votre capacité. Une vérification de validité réussie ne réserve pas la prestation auprès de feratel : si la carte est utilisée ailleurs avant l'envoi de la validation, feratel la refuse. |
Pricing Sync | ❌ |
Les prix ne sont pas synchronisés avec Salzburg Card. Les réservations utilisent la tarification (prix public, prix de gros/commission) définie sur votre revendeur Salzburg Card, qui doit utiliser le mode de règlement « Facturer sur mon compte » (Bill to my account). |
Promotions Sync | ❌ |
Les promotions ne s'appliquent pas aux pass Salzburg Card. Vos promotions Ventrata ne s'appliquent pas aux réservations créées en scannant un pass. |
Bookings Sync | ✅ / ❌ |
Limité : les réservations ne sont créées que lorsqu'un pass est scanné. Une réservation par carte valide, créée automatiquement sous le revendeur Salzburg Card, sur la première disponibilité en cours, sauf si le personnel en choisit une. Le numéro de carte imprimé est enregistré comme référence revendeur et sur la facture. Le produit, l'option et l'unité proviennent du mappage par prestation et par type de carte. Les validations enregistrées dans feratel ne peuvent pas être annulées depuis Ventrata. |
Pickups/Dropoff Sync | ❌ |
Ne fait pas partie de cette connexion. Les validations de pass ne comportent pas de prise en charge. |
Custom Questions Sync | ❌ |
Ne fait pas partie de cette connexion. Les questions de réservation ne sont ni posées ni envoyées pour les validations de pass. |
Extras Sync | ❌ |
Ne fait pas partie de cette connexion. Aucun extra ne peut être ajouté à une validation de pass. |
Redemption Sync | ✅ |
Les validations sont envoyées à Salzburg Card. Par défaut (les deux options décochées) : l'utilisation de la carte est enregistrée auprès de feratel au moment où la carte est validée et la réservation créée. Avec Valider lors de la validation/du surclassement (Redeem on Redemption/Upgrade), l'utilisation est envoyée lorsque la réservation est validée ou surclassée dans Ventrata. Avec Valider en cas de non-présentation (Redeem on No-show), elle est envoyée lorsque la réservation est marquée comme non-présentation, y compris les non-présentations automatiques. Une requête « check with transaction » à feratel, qui marque la carte comme utilisée pour votre prestation. La validation dans Ventrata échoue si feratel ne l'accepte pas. |
Pass Walkup Scanning Sync | ✅ |
Vous scannez les pass Salzburg Card à votre entrée. Le code QR d'un visiteur est scanné sur du matériel compatible Ventrata ou dans l'application mobile, ou saisi dans Valider le code du bon (Redeem Voucher Code) dans le Dashboard. Le numéro de carte imprimé peut être saisi à la place. Si le code ne correspond à aucune de vos réservations ou de vos billets existants, Ventrata vérifie en temps réel auprès de feratel s'il s'agit d'une Salzburg Card valable pour votre attraction à ce moment-là. Cette vérification n'enregistre pas d'utilisation. Si la carte est valide, Ventrata crée une réservation sous votre revendeur Salzburg Card, pour le produit, l'option et l'unité que vous avez mappés à cette prestation et à ce type de carte (par exemple Adulte ou Enfant). |
Gift Card Sync | ❌ |
Ne fait pas partie de cette connexion. Les pass Salzburg Card ne sont pas des cartes cadeaux Ventrata. |
✅ pris en charge · ✅ / ❌ limité · ❌ non pris en charge
Bon à savoir : limites de cette connexion
Bon à savoir : limites de cette connexion
Les types de carte ne peuvent être mappés qu'après qu'une vraie carte de ce type a été scannée une fois.
Les cartes de prestation de test ne peuvent pas servir à configurer le mappage Adulte ou Enfant.
Les règles de validité (période de la carte, nombre d'utilisations, fenêtres de double utilisation) sont contrôlées par l'émetteur de la carte dans feratel.
Les validations enregistrées dans feratel ne peuvent pas être annulées depuis Ventrata.
Si la réservation et l'admission ont lieu à des moments différents, la carte peut être utilisée ailleurs entre-temps, sauf si vous activez Valider lors de la validation/du surclassement (Redeem on Redemption/Upgrade).
Dépannage
« Erreur de mappage au premier scan d'une carte »
« Erreur de mappage au premier scan d'une carte »
Normal la première fois qu'un type de carte est scanné. La carte n'est pas consommée. Rechargez la page de la connexion, mappez la nouvelle ligne et scannez à nouveau.
« Aucune réservation trouvée »
« Aucune réservation trouvée »
Le code scanné n'est pas une Salzburg Card, par exemple le code QR d'un reçu d'achat. Scannez le code QR de la carte ou de la carte numérique, ou saisissez le numéro de carte imprimé.
« Carte refusée car non valide (message de feratel) »
« Carte refusée car non valide (message de feratel) »
Reflète le statut de la carte et les règles d'utilisation définies par Tourismus Salzburg : carte expirée, déjà utilisée pour votre prestation aujourd'hui, ou non valable pour cette prestation. Les clients doivent contacter Tourismus Salzburg au sujet de leur carte.
« La carte est scannée mais aucune réservation n'est créée »
« La carte est scannée mais aucune réservation n'est créée »
Le type de carte n'est peut-être pas encore mappé. Rechargez la page de la connexion, mappez la nouvelle ligne et scannez à nouveau. Pour une prestation nouvellement attribuée, cliquez d'abord sur Actualiser le mappage (Refresh Mapping). Si le problème persiste, contactez le support Ventrata.
« La connexion ne peut pas être créée ou aucune prestation n'est chargée »
« La connexion ne peut pas être créée ou aucune prestation n'est chargée »
Les identifiants sont peut-être erronés ou votre point de contrôle n'est pas activé pour Ventrata. Vérifiez que les cinq identifiants feratel sont exactement tels que reçus et que votre point de contrôle est activé. Contactez ensuite votre contact chez Salzburg Card en mettant [email protected] en copie.
FAQ
Quel est le lien entre feratel et Salzburg Card ?
Quel est le lien entre feratel et Salzburg Card ?
Salzburg Card est émise par Tourismus Salzburg GmbH et fonctionne sur le logiciel Card System de feratel. feratel n'est pas un revendeur : votre relation commerciale est avec Tourismus Salzburg, et Ventrata utilise la CheckAPI de feratel pour vérifier et valider la carte. Chaque carte fonctionnant sur feratel nécessite sa propre connexion et son propre revendeur dans Ventrata.
Un scan réussi réserve-t-il la carte pour mon attraction ?
Un scan réussi réserve-t-il la carte pour mon attraction ?
Non. Ventrata vérifie d'abord la carte sans enregistrer d'utilisation. Si la carte est utilisée ailleurs avant l'envoi de la validation, feratel la refuse.
Quand activer Valider lors de la validation/du surclassement (Redeem on Redemption/Upgrade) ?
Quand activer Valider lors de la validation/du surclassement (Redeem on Redemption/Upgrade) ?
Lorsque la réservation et l'admission ont lieu à des moments différents, par exemple sur une borne de billetterie ou lors d'une prévente à un point de vente, afin que l'utilisation de la carte soit enregistrée à l'admission.
Ressources utiles
📚 En savoir plus sur les connexions Ventrata
Informations sur le partenaire
Tourismus Salzburg GmbH
Auerspergstraße 6, 5020 Salzburg
Autriche
ID partenaire Ventrata : 01a144a3-e3fa-7458-938a-1324332c0830