---
title: Setting up a voucher
slug: en/setting-up-a-voucher
createdAt: 2024-10-14T12:38:16.719Z
---

*How can I set up a voucher with a unique code?*

***

Vouchers can be used to define unique codes that give the code holder a specific benefit: for example, access to discounted ticket prices or a discount on the entire order. Here are some typical use cases for vouchers:

- A **loyalty card**, giving the holder a 10% discount on selected events
- A **gift card**, giving the holder a fixed amount to spend at checkout
- A **"Free ticket"** voucher, entitling the holder to one free ticket for specific events

Each voucher has a unique code (typically 12 to 16 characters) that is used to validate the voucher. Vouchers can be redeemed in web widgets, at the box office, and via the API.

A voucher has an expiration date, which determines how long the codes remain valid. The expiration can be a fixed date or a date relative to the creation date of the voucher.

To set up vouchers, go to **Events → Manage other items → Vouchers**.

![Voucher menu](https://api.archbee.com/api/optimize/zGnEynQy6cgPdn1J1kZsn/CNIXwLuW0MHKjwc32FHjp_schermafbeelding-2024-10-29-om-093819.png)

# Types of vouchers

## Price type voucher

A price type voucher is linked to one or more **price types** through a **price condition**. Only holders of these vouchers can buy tickets at the linked price type. This means that in order to add a ticket of this price type to an order, a **valid voucher code** must be entered.

You can configure how many times each voucher code can be used in total and per event.

*Examples of price type vouchers:*

- All loyal customers receive a **loyalty card**. With this card, they are allowed to purchase a maximum of 2 tickets per event at a reduced price. To implement this, you would create a price type ‘Discount’ and add it to the pricelist **for all events where the discount applies**. Then, create a price type voucher and link it to this new price type. In the configuration, you specify that each code can be used 2 times per event.
- You sell a **Movie Card** for €50.00, which allows the buyer to attend 5 movies. To implement this, create a **price type** called Movie Card and add it to the pricelist of the applicable events **at a price of €0.00**. Then create a price type voucher and link it to this price type. In the configuration, set that each code can be used 5 times in total.

## Payment voucher

A payment voucher can be used as a means of payment. Each payment voucher has a defined value, which can be spent across one or more orders.

Typical use cases include **gift cards or credit vouchers**.

# Creating a price type voucher

In the app, go to **Events → Manage other items → Vouchers** and click on **Add voucher → Add price type voucher**.

Enter a name for the voucher, choose a format, and save.

![Add price type voucher](https://api.archbee.com/api/optimize/tnY7Mf55_e2QgPQDb0pv7-zm80FK63DtaF3jrxMjBrr-20250506-143837.png)

In the next screen, you can edit the name, add a description, and configure a prefix to be added to all codes for this voucher.

You also define how many times the voucher can be used **in total** and **per event**.

:::hint{type="info"}
If you set **Max uses** to 10 and **Max per event** to 1, the customer can purchase one ticket for 10 different events where the discounted price type is valid.
:::

If the voucher should expire after a certain period, configure it here. You have three options:

- No expiration: voucher never expires
- Fixed date: all vouchers expire on the same specified date
- Months after creation: expiration is a number of months based on creation date

![Configure voucher settings](https://api.archbee.com/api/optimize/tnY7Mf55_e2QgPQDb0pv7-Rj50jpiZhdYqCkUF3m6EJ-20250506-143837.png)

If you want to sell the voucher (online or in the box office), click **Configure sales**. See also [Selling vouchers](#)

![Configure sales](https://api.archbee.com/api/optimize/tnY7Mf55_e2QgPQDb0pv7-hDM14ggJmx9-zcHLdirbd-20250506-144659.png)

# Creating a payment voucher

Again go to **Events → Manage other items → Vouchers**, but this time select **Payment voucher** when creating a new one.

Enter the **name** and **format**, and also select the **payment method** to use for this voucher.

:::hint{type="info"}
This must be a payment method of type **voucher**. We recommend creating a **dedicated payment method of type voucher** for each payment voucher, with the same name. See [Payment methods](#)
:::

Click save. You can now optionally add a description, prefix, and an **expiration date**.

![Create payment voucher](https://api.archbee.com/api/optimize/tnY7Mf55_e2QgPQDb0pv7-aKWHtimPkUSDh6sGGuDKs-20250506-145546.png)

In the sales configuration, choose what value the customer can purchase for the credit voucher. You can allow them to enter a **custom amount**, or offer a **preset list** of fixed values.

It’s also possible to create a payment voucher that sells at a lower price than its actual value — allowing you to offer discounts to customers.

To do this, in the voucher sales settings, choose **‘Preset values from list’** and then set a price that is lower than the value.

In the example below, the customer can buy a €50 voucher for €45, or a €40 voucher for €38.

![Value-based discount vouchers](https://api.archbee.com/api/optimize/tnY7Mf55_e2QgPQDb0pv7-9davWrmGWe7_4vU4BXFEp-20250506-150002.png)