Skip to main content

Salzburg Card Reseller Connection

How to connect with Salzburg Card to scan, validate and redeem cards in Ventrata via feratel

Salzburg Card logo

powered by

feratel


​Salzburg Card is the official city card of Salzburg, Austria, issued by Tourismus Salzburg GmbH, the city's tourism board. Available for 24, 48 or 72 hours as a physical card or a digital card on the visitor's smartphone, it includes one admission to the city's attractions and museums, free use of public transport, and discounts on cultural events, concerts and excursions. Cards are sold online and through hotels, tourist information offices, ticket bureaus and Salzburg Airport. To learn more about partnering with Salzburg Card visit https://www.salzburg.info/en/hotels-offers/salzburg-card

Salzburg Card runs on feratel's Card System software, and Ventrata is integrated with feratel's API to validate and redeem the card.

📒 NOTE

Coming soon. This connection is in its final development stages and may not be available to all users yet. Please contact our Technical Support or your Customer Success Manager to check availability.

This connection enables you to scan, validate and redeem Salzburg Cards from walk-up customers directly in Ventrata, eliminating the need for a separate feratel scanner or app and capturing every card visit in your Ventrata reporting. Capabilities of this connection allow you to:

  • Scan and validate cards on Ventrata-powered hardware (turnstile, ticket kiosk, point of sale / terminal), the mobile app or the dashboard.

  • Create bookings automatically in Ventrata for every valid card, so Salzburg Card visitors appear in your reporting, capacity and settlement.

  • Record redemptions (checks with transactions) from Ventrata back to feratel instantly, marking the card as used for your service.


🔐 Required Role Permissions: See Connections, Modify Connections

Connection Capabilities

Card Scanning

When a QR code is scanned by Ventrata-powered hardware (e.g. turnstile, ticket kiosk, point of sale / terminal), the mobile app, or is entered into "Redeem Voucher Code" in the Ventrata dashboard AND it does not belong to one of your existing bookings/tickets, Ventrata verifies in real time with feratel whether the code belongs to a Salzburg Card and whether it is valid for admission to your attraction or activity at that moment. Validity rules (card period, number of uses, double-use windows) are controlled by the card issuer in feratel.

Booking

If the card scanned is a valid Salzburg Card for your attraction or activity, a booking is automatically created in Ventrata under the Salzburg Card reseller, with the card identifier recorded as the reseller reference. The booking is made for the earliest tour/availability currently running, unless otherwise specified by a user (e.g. when booking on a ticket kiosk or with staff using a point of sale / terminal device). The product, option and unit booked are determined by your product mapping (see Mapping Products below).

Redemption

The card use is communicated to feratel as a redemption (check with transaction), marking the card as used for your service. When this transaction is sent is defined on the connection (see Creating Connection, step 5): by default when the card is validated and the booking created, or, if enabled, when the booking/ticket is redeemed or upgraded in Ventrata and/or when it is marked as a no-show. Redemption in Ventrata fails if feratel does not accept the transaction (for example, the card has already been used for your service within the allowed window). Redemptions recorded in feratel cannot be reversed from Ventrata.


Creating Connection

Before you begin:

  • You must be a Salzburg Card partner attraction with a commercial agreement with Tourismus Salzburg GmbH. To inquire about joining the Salzburg Card, contact Tourismus Salzburg at [email protected].

  • You must be using Ventrata-powered hardware (turnstile, ticket kiosk, point of sale / terminal), the mobile app or the dashboard at the entry to your attraction or activity.

  • You must have Salzburg Card created as a Reseller in Ventrata with their pricing (retail, wholesale/commission) defined correctly. Note that this connection requires that the reseller is set to the "Bill to my account" settlement method.

  1. Obtain your feratel credentials from Salzburg Card. To create the connection you need five values issued for your attraction: Feratel Username, Feratel Password, Feratel Tenant ID, Feratel Client ID and Feratel Client Secret. These are usually provided by Tourismus Salzburg either to you or to Ventrata directly. If you have not received them, contact your Salzburg Card contact or email [email protected] and we will help coordinate with Tourismus Salzburg and feratel.
    ​

  2. In Ventrata Dashboard, go to Connections → Connections, click + New Connection, and select Salzburg Card from the list of partners:
    ​


    ​

  3. Select Salzburg Card Reseller (e.g. Tourismus Salzburg GmbH) from the list of your resellers (must be created before creating a connection). The connection will inherit the reseller's configuration like pricing, allowed destinations, products and items, and all card bookings will be recorded on behalf of this reseller.
    ​

  4. Enter the Feratel Username, Password, Tenant ID, Client ID and Client Secret received in step 1.
    ​

  5. Define when the redemption transaction is sent to feratel, as agreed with Tourismus Salzburg, or leave the default (both unticked, in which case the card use is recorded with feratel when the card is validated and the booking created):

    • Redeem on Redemption/Upgrade — send the redemption to feratel when the booking is redeemed in Ventrata.

    • Redeem on No-show — send the redemption to feratel when the booking is marked as a no-show in Ventrata, including automatic no-shows.
      ​
      ​


      ​

  6. (Optional) Set the connection Name of your choosing, allow/disallow destinations, products or items on the connection level in addition to what you have configured on the reseller, and tick Test if you want all Salzburg Card bookings forced into test mode and scans accepted only from equipment in test mode (un-tick before going live).
    ​

  7. Click Create Connection and proceed to Mapping Products.
    ​


Mapping Products

  1. Review Salzburg Card services. In Connections → Connections, open the Salzburg Card connection you created. You will see a table with the Salzburg Card services assigned to your attraction on the left (loaded automatically from feratel when the connection is created) and the corresponding Ventrata product, option and unit (if mapped) on the right. Services not yet mapped are highlighted in red.
    ​

  2. Map services to Ventrata products. Click a service row, select the Ventrata product, option and unit to be booked for that card and click Update Mapping. Repeat for every service shown.
    ​

  3. Test before going live. Scan the test cards received from Salzburg Card or feratel to confirm a booking is created for the correct product.


Troubleshooting

Issue

Possible Solutions

Card scans but no booking is created.

Check that the service shown for your attraction is mapped to a Ventrata product, option and unit. Unmapped services are highlighted in red on the connection page. If the issue persists, please contact our support team.

Card is rejected as not valid.

The error message comes from feratel and reflects the card's status and the usage rules set by Tourismus Salzburg (card expired, already used for your service today, not valid for this service). Customers should contact Tourismus Salzburg with questions about their card.

Connection cannot be created or no services are loaded.

Check that all five feratel credentials are entered exactly as issued for your attraction. If they were sent to Ventrata directly, contact our support team to have them verified.


Partner Information

Tourismus Salzburg GmbH

Auerspergstraße 6

5020 Salzburg, Austria


​Ventrata Partner ID 01a144a3-e3fa-7458-938a-1324332c0830


feratel media technologies AG
Maria-Theresien-Straße 8
6020 Innsbruck, Austria


​Ventrata Partner ID 56adbc3a-dfe5-49dd-8b39-481ebb8b3108

Did this answer your question?