Obtain your feratel credentials and test cards from Salzburg Card. To create the connection you need five values: Feratel Username, Feratel Password, Feratel Tenant ID, Feratel Client ID and Feratel Client Secret.
​
In the same request, ask for at least one Salzburg Card of each type you accept (e.g. one Adult and one Child) that includes your services. You will need them to set up and test your mapping (see Mapping Products, steps 2–6). Request both from your Salzburg Card contact at Tourismus Salzburg. If you need help, copy [email protected] on your request.

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

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.

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

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):

(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).

Click Create Connection and proceed to Mapping Products.

Review Salzburg Card services. In Connections → Connections, open your Salzburg Card connection. The services assigned to your attraction are loaded automatically from feratel. These rows tell Ventrata which services to check, but they cannot be used for admission on their own.

Have one card of each type ready. Use the cards requested in Creating Connection, step 1. Test service cards don't work for this step, because they carry a test card type, not Adult or Child. If you scan a service card, a test card type row appears, which you can leave unmapped.

Scan each card. Scan the card on your Ventrata-powered hardware or mobile app, or enter its code or printed card number in Redeem Voucher Code in the dashboard. This first scan fails with a mapping error. This is expected, and the card is not mapped.

Reload the mapping. Back on the connection, reload the page (or click Refresh Mapping). A new row appears under the service for each card type you scanned (e.g. Adult, Child), highlighted in red as unmapped.

Map each card type. Click each row, select the Ventrata product, option and unit to be booked (e.g. Adult unit for Adult cards, Child unit for Child cards) and click Update Mapping. All three (product, option and unit) are required.

Scan again. Scan the same cards again. A booking is now created for the correct product and unit, and the redemption is sent to feratel according to your connection settings.

Repeat when anything changes. When a new service is assigned to your attraction, click Refresh Mapping first to import it, then scan a card of each type for that service and repeat steps 3–6. When Salzburg Card introduces a new card type for an existing service, just repeat steps 3–6. When a service is removed in feratel, Refresh Mapping deletes it together with its card-type mappings. If it is added back later, refresh, then scan and map it again.