Promo Codes offer you the possibility to hand out codes to your ticket buyers, which grant discounts to certain events or tickets. Promo Codes are characterized by the fact that they can be redeemed for a certain number of uses. In addition, a number of settings can be used to individually limit the redemption of promo codes. The promo code value can correspond to both a variable discount and a fixed discount.
Hint: Vouchers can also be used instead of promo codes. Vouchers have a fixed residual value. They can be applied until the residual value is $0, regardless of the number of uses.
Examples of use:
Give sponsors a code that allows them to purchase 3 tickets per game at a discount.
Give a customer access to a free ticket with a 100% discount.
To handle a marketing campaign with promo codes that give discounts for an Early Bird Sale.
And much more.
Promo CodesSetup
To create or manage a promo code, select the Discounts module and go to Promo Codes. All existing promo codes will be listed and can be edited with one click. New promo codes can be built using the Create Promo Code button.
The following settings are available for promo codes and can be customized for both new promo codes and existing promo codes.
Hint: All settings can be changed and customized at any time. Thus, expired or deactivated promo codes can be reactivated.
General
Expand all
Name
Enter a name for the promo code which is used for internal reference. You can filter the full list by name.
Code
Specify the code that must be entered by the ticket purchaser to redeem the discount. You can use only numbers and letters. The system is case-sensitive. If you leave the field empty in the promo code creation, a random code will be generated automatically.
Activation
Activate the promo code using the active button. Only active promo codes can be redeemed. You can activate and deactivate a promo code at any time.
Discount
Select the discount the promo code should give. You can choose between a variable (percentage) and a nominal discount. If you select nominal discount per item, it will be calculated for each item in the shopping cart.
Usage
Expand all
Single use
Enable single usage if the discount is to be redeemed for only one transaction. This setting applies to the entire promo code across all customers.
Maximum redemption
Define the maximum number of times the promo code can be used. This setting applies to the entire promo code across all customers.
Maximum redemption (per Event)
Define the maximum number of times the promo code can be redeemed per event. You can limit which events it applies to further down.
Maximum redemption (Tickets)
Limit the number of tickets that can be purchased with this promo code across all events, tickets, and transactions.
Combinability
Decide if other promo codes can be added when using the promo code in the same transaction. To allow this, activate the Combinable toggle.
Limitations
Expand all
Validity date
Ability to select a date until which the promo code can be used. After this date, the promo code will appear as invalid in the shopping cart.
Restrict number of tickets
Limit the number of tickets per use that can be in the shopping cart. For example, limit a code to be redeemed for up to 5 tickets in a Transaction.
Allow all events
If the promo code can be redeemed for all your events, activate the Allow all events checkbox. If it should only apply to specific events, use the Add event option to select them.
Allow all tickets
Select the ticket types for which the promo code will be valid. Note that the ticket types can only be limited if the events have been limited before. If all ticket types can be used, activate the Allow all ticket types checkbox.
Select customer
Select a specific customer who can use the discount. Only a single customer can be selected.
Other
Expand all
Enable Promo Code Tagging
With promo code Tagging, every customer gets a tag on his customer record after using the promo code, which you can use in reporting. Activate the toggle and add the tag you want to use. Confirm your tag entry by pressing Enter so you see a colored box around the tag.
Note
Add an internal note. The note is only visible internally via this view.
Checklist
A promo code can be created and used in no time. However, you should keep in mind that certain settings can lead to unwanted results. Use the following checklist to avoid such mistakes in advance, and take advantage of all the possibilities the promo code module offers.
Promo code creation checklist
Expand all
Who should have access to the promo code?
First of all, narrow down the circle of ticket buyers. Find out who the target group of your promo code is and how many promo codes need to be created.
Does each ticket buyer need to get a separate code or is one code enough for all?
Keep in mind that promo codes cannot be limited per customer. A promo code that is valid for all means that a customer could also redeem all uses only for himself. We therefore recommend that as soon as there is a limitation in the number of uses, one promo code should be used per ticket purchaser.
How many times may the code be redeemed in principle?
Consider whether the ticket purchaser may redeem the promo code more than once. A promo code is considered "redeemed" when used in a transaction with successful payment. Note that a promo code can only be redeemed per transaction and not per checkout. So if there are multiple events in a cart, the redemption is per event and not per cart.
How many times can the code be redeemed per event?
Specify whether the promo code can be redeemed as often as you like in a single event or whether the use per event should be limited.
How many tickets can the ticket purchaser buy with the promo code?
Define how many tickets the ticket purchaser can buy with the promo code. If this number is reached, the promo code will appear as invalid.
Can the promo code be redeemed for all events ever created?
Keep in mind that to enable the promo code to be valid for all events you have ever created and will create, you should enable the Allow all events option.
Can the promo code be redeemed for all ticket types ever created?
Keep in mind that to enable the promo code to be valid for all ticket types you have ever created and will create, you should enable the Allow all events option.
Is there a date until which the promo code should be valid?
Note that the validity date is for expiring codes. So if you don't set an event restriction, the promo code could still be redeemed for all events in the coming months and years.
Promo CodesImport Promo Codes
If you don't want to create promo codes individually, but instead create bulk promo codes in the system, you can use the import function. When importing a promo code, you need to upload a CSV file with all the necessary information. Each line of this CSV file will then be generated as a promo code.
Once you upload the file in the system, the field names of your CSV file must be associated with the field names of our system. If you name the fields of the CSV file directly in the same wording, the fields will even be linked automatically.
To start a promo code import, select the Discounts and Promo Codes module. Then click on the Import option in the upper right, and select the CSV file you want to import. After that, more settings options will display. Here you have to link the field names as described above.
The following variables can be stored in the CSV file. We also explain the meaning of the field as well as the possible contents. More information about the variables can be found in the promo code creation.
The file must meet the following requirements:
File format: CSV (semi-colon delineated)
File size: Any
Column names: Best case, the columns of the CSV should have the exact name of the internal fields they will be linked to during import. This is because they will be directly linked when the file is selected, so they do not have to be selected individually.
Structure: one line must correspond to a single promo code.
Mandatory fields:
Name
Note: Only the name is mandatory. All other fields can be left blank if necessary. The fields correspond to the fields which can be filled in the manual promo code creation.
Promo Code import file
Expand all
active
Activation | true, false
name
Name | letters, numbers, characters
code
Code | letters, numbers
singleUsage
Single use | true, false
maxUsage
Maximum usage number per transaction | number
maxUsagePerEvent
Maximum usage per event | number
maxTickets
Maximum number of uses per ticket | number
canBeCombined
Combinability | true, false
discountType
Discount type | fix, fixPerItem, var
discountValue
Discount value | number (e.g. 50.0 = 50€, 0,5 = 5%)
discountMaxValue
Maximum discount | number
validUntil
Validity date | ISO date (e.g. 2023-01-19T14:59:05.226Z)
maxTicketsinCart
Limit number of tickets | Number
allowedEvents
Limit events | Event IDs (separated by "|")
allowedTickets
Limit ticket types | ticket type IDs (separated by "|")
tags
tags | letters, numbers (separated by "|")
note
notes | letters, numbers, characters
customerEmail
e-mail of the customer
inviteEmail
Email of the customer to invite. If this field is filled, an e-mail will be sent to this customer.
Import Process
To perform a promo code import, select the Import button via the Discounts and Promo Codes module. Alternatively, the ticket import can also be triggered via the same process in the Jobs module.
Perform the following steps for the import:
Click the Import button via the Promo Codes module. A new window will open.
Select the Select button to upload the import file. After that, more settings will pop up.
Connect the fields of your CSV file with the internal fields. If the fields of your CSV are already named with the same wording, the mapping will be done automatically.
Click Import to start the import. You will be automatically redirected to the Jobs module.
In the Jobs module you have the possibility to download a file of the successful imports. If there are any records that could not be imported successfully, you can also download a file with all failed records.
Import Errors
After performing an import, you will be automatically redirected to the Jobs module. There you have the possibility to download all successful and all failed records. You can access the Jobs module later by clicking on your vivenu account name in the lower-left corner of the dashboard.
Failed records are those promo codes that could not be imported for certain reasons. In the right column of each failed record file, you will find the so-called Error reason.
Was this page helpful?
For the sake of better readability, the simultaneous use of the language forms male, female and diverse (m/f/d) is waived. All personal designations apply equally to all genders.
