Coupons offer you the possibility to hand out codes to your ticket buyers, which grant discounts to certain events or tickets. Coupons 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 coupons. The coupon value can correspond to both a variable discount and a fixed discount.
Hint: Vouchers can also be used instead of coupons. 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 coupons that give discounts for an Early Bird Sale.
And much more.
CouponsCreate and manage
To create or manage a coupon, select the Discounts module and go to Coupons. All existing coupons will be listed and can be edited with one click. New coupons can be built using the Create Coupon button.
The following settings are available for coupons and can be customized for both new coupons and existing coupons.
Hint: All settings can be changed and customized at any time. Thus, expired or deactivated coupons can be reactivated.
General
Expand all
Name
Enter a name for the coupon 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 coupon creation, a random code will be generated automatically.
Activation
Activate the coupon using the active button. Only active coupons can be redeemed. You can activate and deactivate a coupon at any time.
Discount
Select the discount the coupon 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 coupon across all customers.
Maximum redemption
Define the maximum number of times the coupon can be used. This setting applies to the entire coupon across all customers.
Maximum redemption (per Event)
Define the maximum number of times the coupon 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 coupon across all events, tickets, and transactions.
Combinability
Decide if other coupons can be added when using the coupon in the same transaction. To allow this, activate the Combinable toggle.
Limitations
Expand all
Validity date
Ability to select a date until which the coupon can be used. After this date, the coupon 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 coupon 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 coupon 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 Coupon Tagging
With Coupon Tagging, every customer gets a tag on his customer record after using the coupon, 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 coupon 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 coupon module offers.
Coupon creation checklist
Expand all
Who should have access to the coupon?
First of all, narrow down the circle of ticket buyers. Find out who the target group of your coupon is and how many coupons 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 coupons cannot be limited per customer. A coupon 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 coupon should be used per ticket purchaser.
How many times may the code be redeemed in principle?
Consider whether the ticket purchaser may redeem the coupon more than once. A coupon is considered "redeemed" when used in a transaction with successful payment. Note that a coupon 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 coupon 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 coupon?
Define how many tickets the ticket purchaser can buy with the coupon. If this number is reached, the coupon will appear as invalid.
Can the coupon be redeemed for all events ever created?
Keep in mind that to enable the coupon to be valid for all events you have ever created and will create, you should enable the Allow all events option.
Can the coupon be redeemed for all ticket types ever created?
Keep in mind that to enable the coupon 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 coupon should be valid?
Note that the validity date is for expiring codes. So if you don't set an event restriction, the coupon could still be redeemed for all events in the coming months and years.
CouponsImport Coupons
If you don't want to create coupons individually, but instead create bulk coupons in the system, you can use the import function. When importing a coupon, you need to upload a CSV file with all the necessary information. Each line of this CSV file will then be generated as a coupon.
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 coupon import, select the Discounts and Coupons 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.
Coupon Import File
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 coupon 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 coupon.
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 coupon creation.
Coupon 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.
Perform Coupon Import
To perform a coupon import, select the Import button via the Discounts and Coupons 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 Coupons 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.
Coupon 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 coupons 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.
