Salzburg Card is the all-inclusive city card of Salzburg, Austria, issued by Tourismus Salzburg, giving one free entry to the city's sights and museums plus public transport for 24, 48 or 72 hours. For attractions, it brings around 240,000 card holders a year and about 1.2 million entries, with Germany, the United States, the United Kingdom and Italy the main overnight markets, sold through hotels, ticket offices, the airport and online. Salzburg Card uses Feratel as their primary ticketing system.
Connecting Salzburg Card to Ventrata lets you scan, validate and redeem Salzburg Card passes at your entrance, on Ventrata-powered turnstiles, kiosks, point-of-sale terminals, the mobile app or the Ventrata Dashboard, without a separate Salzburg Card app.
To learn more about Salzburg Card, visit salzburg.info/en/hotels-offers/salzburg-card.
Primary website | |
Tags | Destination Organization (DMO) · Multi-Attraction Pass |
Connection type | Pass redemption: you scan Salzburg Card passes at your entrance |
Connection features | Product Mapping · Redemption Sync · Pass Walkup Scanning Sync |
Developed by | Ventrata (using feratel CheckAPI) |
This connection lets you:
Scan and validate Salzburg Cards from walk-up visitors on Ventrata-powered hardware (turnstile, ticket kiosk, point of sale / terminal), the mobile app or the dashboard, without a separate feratel scanner or app.
Create a booking in Ventrata automatically for every valid card, so Salzburg Card visitors appear in your reporting, capacity and settlement.
Record the card use with feratel instantly, or at admission or no-show, marking the card as used for your service.
How It Works
A visitor's QR code is scanned on Ventrata-powered hardware or the mobile app, or entered in Redeem Voucher Code in the dashboard. The printed card number can be entered instead.
If the code doesn't belong to one of your existing bookings or tickets, Ventrata checks with feratel in real time whether it is a Salzburg Card valid for your attraction at that moment. This check doesn't record a use.
If the card is valid, Ventrata creates a booking under your Salzburg Card reseller, for the product, option and unit you mapped to that service and card type (e.g. Adult or Child).
The booking is made for the earliest availability currently running, unless staff choose one (e.g. on a ticket kiosk or point of sale).
Ventrata sends the card use to feratel as a "check with transaction": by default right away, or when the booking is redeemed/upgraded or marked as a no-show, depending on your settings.
📒 NOTE
The QR code on the physical card or the visitor's digital card, or the printed card number. A QR code on a purchase receipt is not a Salzburg Card.
Creating the Salzburg Card Connection
🔐 Required Role Permissions: See Connections, Modify Connections
Before you begin:
You must be a Salzburg Card partner attraction with a commercial agreement with Tourismus Salzburg GmbH.
Your attraction must be enabled for Ventrata by Tourismus Salzburg. Tourismus Salzburg informs feratel, and feratel activates your attraction's checkpoint for Ventrata.
You must use Ventrata-powered hardware (turnstile, ticket kiosk, point of sale / terminal), the mobile app or the dashboard at your entrance.
Create Salzburg Card as a reseller in Ventrata with correct pricing (retail, wholesale/commission) and the "Bill to my account" settlement method.
Get your five feratel credentials and at least one real Salzburg Card of each type you accept (e.g. one Adult, one Child) that includes your services.
Your role needs the See Connections and Modify Connections permissions.
To join the Salzburg Card as a partner attraction, contact Tourismus Salzburg. [email protected] Https://www.salzburg.info/en/hotels-offers/salzburg-card
For help with credentials or setup, copy Ventrata Connectivity on your request to Salzburg Card. [email protected]
Create the connection
In the Ventrata Dashboard, go to Connections → Connections, click + New Connection and select Salzburg Card.
Select your Salzburg Card reseller.
Enter the Feratel Username, Password, Tenant ID, Client ID and Client Secret.
Choose when the redemption is sent to feratel, as agreed with Tourismus Salzburg, or leave both options unticked to record the use when the card is validated and the booking created.
Optionally set a Name, restrict destinations, products or items, and tick Test.
Click Create Connection and continue to mapping.
The connection form has these options:
Reseller | Your Salzburg Card reseller (e.g. Tourismus Salzburg GmbH). The connection inherits its pricing, allowed destinations, products and items, and all card bookings are recorded under it. |
Feratel Username / Password / Tenant ID / Client ID / Client Secret | Your feratel credentials from Salzburg Card. |
Redeem on Redemption/Upgrade | Send the redemption to feratel when the booking is redeemed in Ventrata. Recommended when booking and admission happen at different times. |
Redeem on No-show | Send the redemption to feratel when the booking is marked as a no-show in Ventrata, including automatic no-shows. |
Name | Optional connection name of your choosing. |
Allowed destinations, products or items | Optional extra restrictions on top of what is set on the reseller. |
Test | Forces all Salzburg Card bookings into test mode and accepts scans only from equipment in test mode. |
📗 TIP
Tick Test on the connection to force all Salzburg Card bookings into test mode and accept scans only from equipment in test mode; untick before going live. Test service cards carry a test card type, not Adult or Child, so they can't be used to set up mapping.
Mapping Products
Feratel doesn't send services together with their card types over the API. The services assigned to your attraction load automatically; each card type (e.g. Adult, Child) appears as a row under its service the first time a card of that type is scanned.
Open your Salzburg Card connection and review the services loaded from feratel. Service rows tell Ventrata what to check but can't be used for admission on their own.
Have one real card of each type ready (not a test service card).
Scan each card, or enter its code or printed card number in Redeem Voucher Code. The first scan fails with a mapping error; this is expected and the card is not used up.
Reload the connection page or click Refresh Mapping. A new red row appears under the service for each card type scanned.
Click each row, select the Ventrata product, option and unit (all three required) and click Update Mapping.
Scan the same cards again. A booking is created and the redemption is sent according to your settings.
When a new service is assigned, click Refresh Mapping first, then scan and map each card type. For a new card type on an existing service, just scan and map it.
📒 NOTE
If you scan a test service card, a test card type row appears; you can leave it unmapped.
📒 NOTE
When a service is removed in feratel, Refresh Mapping deletes it with its card-type mappings. If it comes back, refresh, then scan and map it again.
Redemption
Immediately: Default (both options unticked): the card use is recorded with feratel when the card is validated and the booking created.
On redemption or no-show: With Redeem on Redemption/Upgrade, the use is sent when the booking is redeemed or upgraded in Ventrata. With Redeem on No-show, it is sent when the booking is marked as a no-show, including automatic no-shows.
What's sent to Salzburg Card: A "check with transaction" request to feratel, marking the card as used for your service. Redemption in Ventrata fails if feratel doesn't accept it.
Connection Features Detailed
This section is for anyone who wants the detail. Click a row to see how each feature works.
Product Mapping | ✅ |
You map each Salzburg Card pass listing to a Ventrata product in the Ventrata Dashboard. Feratel doesn't send services together with their card types over the API. The services assigned to your attraction load automatically; each card type (e.g. Adult, Child) appears as a row under its service the first time a card of that type is scanned. If you scan a test service card, a test card type row appears; you can leave it unmapped. When a service is removed in feratel, Refresh Mapping deletes it with its card-type mappings. If it comes back, refresh, then scan and map it again. |
Content Sync | ❌ |
Product content isn't synced. Salzburg Card sells its own pass. Your products and their content stay in Ventrata. |
Availability Sync | ✅ / ❌ |
Limited: card visits count toward your capacity. Bookings go into the earliest availability currently running, so card visits count toward your capacity. A successful validity check doesn't reserve the service at feratel: if the card is used elsewhere before the redemption is sent, feratel rejects it. |
Pricing Sync | ❌ |
Prices aren't synced with Salzburg Card. Bookings use the pricing (retail, wholesale/commission) defined on your Salzburg Card reseller, which must use the "Bill to my account" settlement method. |
Promotions Sync | ❌ |
Promotions don't apply to Salzburg Card passes. Your Ventrata promotions don't apply to bookings made by scanning a pass. |
Bookings Sync | ✅ / ❌ |
Limited: bookings are created only when a pass is scanned. One booking per valid card, created automatically under the Salzburg Card reseller, for the earliest availability currently running unless staff choose one. The printed card number is recorded as the reseller reference and on the invoice. Product, option and unit come from the mapping per service and card type. Redemptions recorded in feratel can't be reversed from Ventrata. |
Pickups/Dropoff Sync | ❌ |
Not part of this connection. Pass redemptions don't carry pickups. |
Custom Questions Sync | ❌ |
Not part of this connection. Booking questions aren't asked or sent for pass redemptions. |
Extras Sync | ❌ |
Not part of this connection. Extras can't be added to a pass redemption. |
Redemption Sync | ✅ |
Redemptions are sent to Salzburg Card. Default (both options unticked): the card use is recorded with feratel when the card is validated and the booking created. With Redeem on Redemption/Upgrade, the use is sent when the booking is redeemed or upgraded in Ventrata. With Redeem on No-show, it is sent when the booking is marked as a no-show, including automatic no-shows. A "check with transaction" request to feratel, marking the card as used for your service. Redemption in Ventrata fails if feratel doesn't accept it. |
Pass Walkup Scanning Sync | ✅ |
You scan Salzburg Card passes at your entrance. A visitor's QR code is scanned on Ventrata-powered hardware or the mobile app, or entered in Redeem Voucher Code in the dashboard. The printed card number can be entered instead. If the code doesn't belong to one of your existing bookings or tickets, Ventrata checks with feratel in real time whether it is a Salzburg Card valid for your attraction at that moment. This check doesn't record a use. If the card is valid, Ventrata creates a booking under your Salzburg Card reseller, for the product, option and unit you mapped to that service and card type (e.g. Adult or Child). |
Gift Card Sync | ❌ |
Not part of this connection. Salzburg Card passes aren't Ventrata gift cards. |
✅ supported · ✅ / ❌ limited · ❌ not supported
Good to know: limits of this connection
Good to know: limits of this connection
Card types can only be mapped after a real card of that type has been scanned once.
Test service cards can't be used to set up Adult or Child mapping.
Validity rules (card period, number of uses, double-use windows) are controlled by the card issuer in feratel.
Redemptions recorded in feratel can't be reversed from Ventrata.
If booking and admission happen at different times, the card could be used elsewhere in between unless you enable Redeem on Redemption/Upgrade.
Troubleshooting
"Mapping error on first scan of a card"
"Mapping error on first scan of a card"
Expected the first time a card type is scanned. The card is not used up. Reload the connection page, map the new row and scan again.
"No booking found"
"No booking found"
The code scanned is not a Salzburg Card, for example the QR code on a purchase receipt. Scan the QR code on the card or digital card, or enter the printed card number.
"Card rejected as not valid (message from feratel)"
"Card rejected as not valid (message from feratel)"
Reflects the card's status and the usage rules set by Tourismus Salzburg: expired, already used for your service today, or not valid for this service. Customers should contact Tourismus Salzburg about their card.
"Card scans but no booking is created"
"Card scans but no booking is created"
The card type may not be mapped yet. Reload the connection page, map the new row and scan again. For a newly assigned service, click Refresh Mapping first. If it persists, contact Ventrata support.
"Connection can't be created or no services are loaded"
"Connection can't be created or no services are loaded"
Credentials may be wrong or your checkpoint isn't enabled for Ventrata. Check all five feratel credentials exactly as received and that your checkpoint is enabled. Then contact your Salzburg Card contact and copy [email protected].
FAQs
How does feratel relate to Salzburg Card?
How does feratel relate to Salzburg Card?
Salzburg Card is issued by Tourismus Salzburg GmbH and runs on feratel's Card System software. feratel is not a reseller: your commercial relationship is with Tourismus Salzburg, and Ventrata uses feratel's CheckAPI to validate and redeem the card. Each feratel-powered card needs its own connection and its own reseller in Ventrata.
Does a successful scan reserve the card for my attraction?
Does a successful scan reserve the card for my attraction?
No. Ventrata first checks the card without recording a use. If the card is used elsewhere before the redemption is sent, feratel rejects it.
When should I enable Redeem on Redemption/Upgrade?
When should I enable Redeem on Redemption/Upgrade?
When booking and admission happen at different times, for example on a ticket kiosk or a presale at a point of sale, so the card use is recorded at admission.
Useful Resources
📚 More about Ventrata connections
Partner Information
Tourismus Salzburg GmbH
Auerspergstraße 6, 5020 Salzburg
Austria
Ventrata Partner ID: 01a144a3-e3fa-7458-938a-1324332c0830