> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Vouchers

> Creating and managing vouchers in the Admin Interface: creating voucher charges, setting up purchase voucher templates for sold vouchers and reusing voucher templates.

export const confGutscheine = "Marketing → Gutscheine";

Vouchers are created and managed in the Admin Interface under the service {confGutscheine}. This page describes how a voucher is created, which settings are available and how purchase vouchers differ from promotional vouchers.

The page [Practical examples - Vouchers](/en/gutscheine) describes, among other things, how vouchers can be integrated into the template. How a product becomes a sellable voucher is described under [Creating a purchase voucher product](/en/admin-interface/katalog/produkte/kaufgutschein-produkt).

***

## Accessing the service

You reach the service via the following URL:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.<ihr-shop>.de/admin/vouchers
```

***

## Voucher and voucher charge

A voucher is the code that a customer can redeem in the shop. A voucher charge governs everything around the voucher, for example value, currency, validity period and redemption conditions. Each voucher belongs to exactly one charge and inherits its settings.<br /><br />When you create a voucher, a charge is therefore always created and, depending on the procedure, the vouchers within it.<br /><br />The charge is addressed via its ID. This ID is the only value with which other places in the system refer to a charge, for example a purchase voucher product.

<Warning>
  The charge ID is not the name of the charge. If no ID is entered when creating the charge, the system assigns a sequential number such as "122".
</Warning>

***

## The areas of the voucher administration

The service is divided into three tabs with the following contents:

| Tab                           | Content                                                                             | Purpose                                                                                               |
| ----------------------------- | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| **Vouchers**                  | All voucher charges with name, charge ID, quantity, voucher value and label         | Overview of the existing voucher charges                                                              |
| **Purchase voucher template** | Templates from which vouchers are created when a purchase voucher product is bought | Sellable vouchers, see [Creating a purchase voucher template](#creating-a-purchase-voucher-template). |
| **Voucher templates**         | Reusable presets for the input form                                                 | Set up recurring campaigns faster                                                                     |

<Frame caption="Screenshot as of 01.09.2026">
  <img src="https://mintcdn.com/websaleag-44ee7ea6/cF4ADxA5wsk-HyAI/images/gutscheine_drei_wege.png?fit=max&auto=format&n=cF4ADxA5wsk-HyAI&q=85&s=f7d70d65232ad60614371b29a73726bc" alt="Vouchers Three Ways" width="1897" height="1014" data-path="images/gutscheine_drei_wege.png" />
</Frame>

<Note>
  In the list of charges, the "Quantity" column is the quickest distinguishing feature. If it shows a number greater than zero, the charge contains ready-made voucher codes. If it shows `0`, the charge belongs to a purchase voucher template whose codes are only created with an order.
</Note>

***

## Voucher types

When creating a voucher, "Voucher type" distinguishes between two types. The selection you make determines which items the voucher applies to.

| Type                    | Effect                                                                                                                                           |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Promotional voucher** | Only applies to products for which the field "Eligible for value vouchers" is set. This lets you exclude product groups from discount campaigns. |
| **Purchase voucher**    | Acts as a means of payment on all items and overrides this restriction. This setting applies to sold vouchers and gift vouchers.                 |

***

## Creating a voucher charge

"+ New voucher" opens a form with several sections. It is filled in from top to bottom; the sections are also accessible as tabs.

### Template

First, a voucher template is selected or the option "Without template" is chosen. The remaining sections are only displayed after this selection. A selected template prefills the corresponding fields and locks the others.

### General settings

<Frame caption="Screenshot as of 01.09.2026">
  <img src="https://mintcdn.com/websaleag-44ee7ea6/cF4ADxA5wsk-HyAI/images/gutschein_neuer_gutschein_anlegen.png?fit=max&auto=format&n=cF4ADxA5wsk-HyAI&q=85&s=31f188b39a2e2654436c58d2a4fbf213" alt="Voucher Create New Voucher" width="1906" height="1014" data-path="images/gutschein_neuer_gutschein_anlegen.png" />
</Frame>

| Field                                              | Meaning                                                                                                                                                            |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Active**                                         | Controls whether the vouchers of the charge can be redeemed.                                                                                                       |
| **Name**                                           | Mandatory field. Name of the charge. Spaces are not allowed, otherwise the field is marked as invalid.                                                             |
| **Charge ID**                                      | Freely assignable ID of the charge. If the field is left empty, the system assigns a sequential number. An ID that is already in use is rejected.                  |
| **Set voucher code manually**                      | Allows you to enter your own code. Only useful if exactly one voucher is generated.                                                                                |
| **Voucher code**                                   | The manually assigned code. Without the switch above it, the system generates the codes itself.                                                                    |
| **Quantity**                                       | Number of voucher codes to generate. Irrelevant for purchase voucher templates, see [Creating a purchase voucher template](#creating-a-purchase-voucher-template). |
| **Set maximum number of redemptions**              | Limits how often a voucher can be redeemed in total.                                                                                                               |
| **Voucher redeemable by different customers**      | Allows redemption by multiple customers.                                                                                                                           |
| **Set maximum number of redemptions per customer** | Limits the redemptions per customer.                                                                                                                               |
| **Voucher type**                                   | Mandatory field. Promotional voucher or purchase voucher, see [Voucher types](#voucher-types).                                                                     |
| **Labels**                                         | Keywords for the charge. Labels control which vouchers can be combined with one another in an order. Without input, the shop sets the label itself.                |

### Voucher value

The calculation type determines whether the voucher deducts an absolute amount, grants a percentage discount or grants a percentage discount up to a maximum amount.

Below that, there is one row per currency with currency, VAT ID, voucher value and minimum order value. Further rows can be added via "Add another currency". A voucher only applies in currencies for which a row exists.

This section contains two further settings:

* **Remaining amount**: With "Remaining amount reusable", an unused amount is retained and can be redeemed again later. With "Remaining amount expires", the voucher is used up after the first redemption.
* **Free shipping**: Sets the shipping costs to zero upon redemption.

### Further sections

| Section                                             | Content                                                                   |
| --------------------------------------------------- | ------------------------------------------------------------------------- |
| **Subshops**                                        | In which subshops the vouchers are valid.                                 |
| **Validity period**                                 | Start from generation or from a date, end open or on a date.              |
| **Target group**                                    | Restriction to new customers, existing customers or individual customers. |
| **Automatically add products to the basket**        | Products that are added automatically upon redemption.                    |
| **Redemption conditions - categories and products** | Restriction of validity to specific categories or products.               |

### Saving

The "Generate voucher" button is a split button. The arrow next to it opens three further options. The selection determines what is actually generated:

<Frame caption="Screenshot as of 01.09.2026">
  <img src="https://mintcdn.com/websaleag-44ee7ea6/cF4ADxA5wsk-HyAI/images/button_gutschein_generieren_geoeffnet.png?fit=max&auto=format&n=cF4ADxA5wsk-HyAI&q=85&s=9cbb59bf423eabaf26a665ce5c685fc3" alt="Generate Voucher Button Opened" width="435" height="181" data-path="images/button_gutschein_generieren_geoeffnet.png" />
</Frame>

| Action                                        | Result                                                                                      |
| --------------------------------------------- | ------------------------------------------------------------------------------------------- |
| Generate voucher                              | Generates the configured number of ready-made voucher codes in a new charge.                |
| Generate voucher and close                    | Same as above, then closes the form.                                                        |
| Generate voucher and save as template         | Same as above, additionally saves the entries as a voucher template.                        |
| **Save voucher as purchase voucher template** | Does not generate any codes, but creates a purchase voucher template along with its charge. |

***

## Creating a purchase voucher template

A purchase voucher template is the basis for vouchers that are sold in the shop. It does not contain any codes itself. These are only created when a customer orders a [purchase voucher product](/en/admin-interface/katalog/produkte/kaufgutschein-produkt), one per ordered unit.

The template is created in the same form as an ordinary charge:

<Steps>
  <Step title="Assign name and charge ID">
    The name becomes the purchase voucher template ID. The charge ID should be assigned manually and meaningfully, for example `geschenkgutschein`, because exactly this value is later entered at the product. If the field is left empty, the generated number has to be looked up in the list afterwards.
  </Step>

  <Step title="Set the voucher type to purchase voucher">
    Sold vouchers are a means of payment and should work regardless of whether individual products are approved for value vouchers.
  </Step>

  <Step title="Voucher value absolute, but without an amount">
    The calculation type is set to "absolute", the voucher value remains at `0`. The actual value is set by the price of the sold product. The charge should only carry one currency. For the remaining amount, "Remaining amount reusable" is the right choice, otherwise the rest of the purchased credit expires after a partial redemption.
  </Step>

  <Step title="Save via the arrow menu">
    In the menu next to "Generate voucher", select the entry "**Save voucher as purchase voucher template**". The main button would instead create ready-made voucher codes, which a purchase voucher product cannot use.
  </Step>
</Steps>

After saving, the entry is available in the Purchase voucher template tab with template ID and charge ID. The same charge additionally appears in the Vouchers tab with the quantity `0`.

<Frame caption="Screenshot as of 01.09.2026">
  <img src="https://mintcdn.com/websaleag-44ee7ea6/cF4ADxA5wsk-HyAI/images/kaufgutscheinvorlage_erstellt.png?fit=max&auto=format&n=cF4ADxA5wsk-HyAI&q=85&s=91a7469042a0b1a99e7132aa75da2735" alt="Purchase Voucher Template Created" width="1900" height="1020" data-path="images/kaufgutscheinvorlage_erstellt.png" />
</Frame>

The next step in creating a purchase voucher is the product page → [Creating a purchase voucher product](/en/admin-interface/katalog/produkte/kaufgutschein-produkt).

***

## Voucher templates

A voucher template saves the entries of the form so that recurring campaigns do not have to be filled in from scratch every time. It is created via the entry "Generate voucher and save as template" and is then available for selection in the "Template" section at the top.

Templates only take effect when creating a voucher. A changed or deleted template has no influence on charges and vouchers that have already been generated.

***

## Display in the shop

How vouchers appear in the shop is determined by the template. There are no settings for this in the Admin Interface.

* The input field for the voucher code, the list of redeemed vouchers and the error texts are output in the template. Examples are given in the [practical examples for vouchers](/en/gutscheine).
* Which data is available for this is described by the module [\$wsVoucher](/en/frontend/referenz/module/wsvoucher).
* Sold vouchers do not appear via this module, but at the basket item, see [Creating a purchase voucher product](/en/admin-interface/katalog/produkte/kaufgutschein-produkt).

***

## Concepts and technical names

| Concept                    | Admin Interface           | Interface            |
| -------------------------- | ------------------------- | -------------------- |
| Group of vouchers          | Voucher charge            | `vouchers/charges`   |
| Individual code            | Voucher                   | `vouchers`           |
| Template for sold vouchers | Purchase voucher template | `vouchers/templates` |
| Preset for the input form  | Voucher template          | `vouchers/presets`   |
| Reference to a charge      | Charge ID                 | `chargeId`           |

***

## Guide

* [Creating a purchase voucher product](/en/admin-interface/katalog/produkte/kaufgutschein-produkt) describes the second part of the process.
* [API reference vouchers](/en/schnittstellen/admin-interface-api/api-referenz-gutscheine) describes the same objects via the interface.
* [Practical examples - Vouchers](/en/gutscheine) shows how vouchers are redeemed in the shop template.
* [checkout - Order flow](/en/konfiguration/checkout-bestellablauf) describes the settings for redemption during the order flow.


## Related topics

- [Voucher](/en/frontend/referenz/aktionen/voucher.md)
- [$wsVoucher - Vouchers](/en/frontend/referenz/module/wsvoucher.md)
- [API reference vouchers](/en/schnittstellen/admin-interface-api/api-referenz-gutscheine.md)
- [Storefront API Vouchers](/en/schnittstellen/storefront-api/storefront-api-gutscheine.md)
- [Practical examples - Vouchers](/en/gutscheine.md)