How to implement Vriendenloterij VIP card validation

Updated: 12 June 2025 for Release v214


Vriendenloterij VIP card memberships can offer discounts on ticket prices. This article explains how to set up the validation steps to enable this new feature in your Peppered integrated purchase path.

Application

You can apply for Vriendenloterij discounts via the form that will be provided to you by the VSCD. If you have not received an e-mail by the end of April 2025, please e-mail ย francoise@fmeulemans.nlย (project lead Vriendenloterij - VSCD).

๐Ÿ‘‰

All Dutch venues with an integrated Peppered purchase path can now offer Vriendenloterij discounts. The VIP cards are validated and checked for the maximum allowed number of tickets per event, even across multiple orders. Card numbers are sent to the Ticketing system for reporting. Both Ticketmatic and Itix require a feature to be turned on to accept the incoming VIP card during the purchase. Contact your ticketing provider to make sure this option is activated.


General Functionality

  • Validation of the Vriendenloterij VIP card happens in the personal account, before a Visitor enters the purchase path.
  • A temporary privilege will become active during the web session. After the order this privilege is removed.
  • This privilege enables a new conditional price type, linked to any event that offers Vriendenloterij discounts.
  • Orders are limited to one Vriendenloterij VIP card, and a max of 2 tickets for the discount price type per Event.
  • The VIP card number is send to the ticketing system during the online order (Ticketmatic, Itix) for administrative purposes.

How to set up Vriendenloterij in Peppered

Step 1: Create Price Type in Ticketing System and Peppered

  1. Create a new Price Type called โ€œVriendenloterijโ€ in your ticketing system and add this Price Type to any Event eligible for the Vriendenloterij discount
  1. In your Price types module in the Peppered Dashboard, select Import to import the new Price Type. It will be set to โ€˜conditionalโ€™ by default.
    1. Open the Price Type and set the Max to 2
  1. Optional: You can check the box Automatically select this price (for bundles). This will make sure that in the seatmap, this Price type is automatically selected for the first two seats.
  1. Select Save.
    1. Notion image
      ย 

Step 2: Create Visitor Tag

Go to Marketing > Visitor tags and create a new Visitor tag. This will temporarily be assigned to all Visitors that completed the Vriendenloterij VIP card validation.

  1. Name the Visitor tag โ€œVriendenloterijโ€
  1. The Source should be โ€œwebsiteโ€
Notion image
ย 

Step 3: Set up Privileges

  1. Go to Marketing > Privileges and create a new Privilege. This Privilege will make sure every Visitor with the Visitor tag โ€œVriendenloterijโ€ will be able to see the โ€œVriendenloterijโ€ Price type during the order process.
Notion image

Step 4: Create a page where the Vriendenloterij validation form will be available

  1. Go to Stories > Pages and create a new Page.
    1. Notion image
  1. Build the Page like any other:
    1. Add a Title in the Hero part
    2. Add the Validate membership part.
    3. Optional: Hide the Page from search results using the Advanced Visibility setting and set Allow Indexing to No.
    4. Notion image
      ๐Ÿšง
      Take note! If you can not find the Validate membership Page part, please create a ticket in our service portal.
      ย 
  1. The Validate membership part is a form that will handle the VIP card validation through the Vriendenloterij API. Open the part and select the Visitor tag โ€œVriendenloterijโ€ from the drop-down. This will make sure the correct Visitor tag will become active for the Visitor after a succesful validation.
  1. Save the Page part.
    1. Notion image
      ย 

Step 5: Add Vriendenloterij validation Page to My Account Menu

In order for the set-up to work, a Visitor needs to be logged in before starting the purchase. The most effective way to do this, is to add the page with the validation form to the personal โ€œMy accountโ€ menu. This works by adding a new menu item in the โ€œvisitorโ€ menu section in your โ€œmenuโ€ module in the dashboard and link that to the page with the validation form.

Notion image

This will make sure the page is accessible in the โ€œMy accountโ€ pop-up and start page:

Notion image
ย 
  1. Check if the โ€œvriendenloterijโ€ API entry is already created for you in your โ€œAPI connectionsโ€ CMS module. If itโ€™s there, you are all set.
    1. Notion image

      If itโ€™s not there, just send us a support ticket so we can add the API connection for you.

  1. Test! The page should display the form and validate the VIP card. After successfull validation, the visitor tag should be visible in the โ€œSpecial accessโ€ menu on the next page refresh. The Vriendenloterij price type should also be visible during the order process.
    1. Notion image
ย 

We recommend adding some extra communication on your website to send visitors to the form, or tell visitors to log into their account and find the โ€œVriendenloterijโ€ page in their account menu.

The setup steps of this feature should become more automatic and simple in the future, after the pilot is successfull.

๐Ÿ‘‰

API credentials for the validation of the VIP card can be provided by CultureSuite.

Test VIP cards can be provided to you by Vriendenloterij.


Related articles

Did this answer your question?
๐Ÿ˜ž
๐Ÿ˜
๐Ÿคฉ