Sell and redeem a voucher

Use vouchers when customers buy value or a ticket product that can be redeemed later.

Voucher configuration is split between two systems. KORONA.studio owns the commercial configuration; the KORONA Event back office owns the customer-facing presentation and publication in the shop.

Before you start

Confirm with the person who manages KORONA.studio:

whether the voucher is a value voucher or a single-purpose voucher
its value, validity, and eligible products or offers
whether it is sold online, at the POS, or both
the product, price, tax, voucher number rules, and POS behavior
which payment and confirmation emails should be used

The KORONA.studio integration must be active and synchronized. You need Studio access to change voucher type, value, validity, or eligibility, and back-office access to edit the customer-facing content.

Choose the voucher configuration in KORONA.studio

Create and maintain the voucher configuration in KORONA.studio. KORONA Event imports it when the voucher package is active for the KORONA account.

Configuration	Benefit and use
Value voucher	Applies a monetary balance against an order total, up to the remaining voucher value. Useful for flexible gifts.
Single-purpose voucher	Uses a fixed tax rate. Product or tag restrictions in Studio limit which product can be selected in KORONA Event.

Choose the type based on what the customer is promised. Value vouchers pay the remaining order amount without changing the tax on the purchased products. Single-purpose vouchers use the tax configuration recorded when the voucher was issued.

For those accounts, a single-purpose voucher with neither restriction can cover the remaining order total, including deposit amounts, up to its available balance. It retains its fixed tax treatment. With mixed tax rates, a fully paid receipt can therefore still show offsetting net and tax amounts.

A configured tag with no matching products does not remove the restriction. Correct the product or tag assignment in KORONA.studio and synchronize before applying the voucher again. No additional eligibility setting is needed in KORONA Event. Product selection in KORONA Event does not guarantee the same product restriction is enforced by the native KORONA POS.

Vouchers use the order in which they were applied. Each subsequent voucher covers only the amount remaining after earlier vouchers. Removing a voucher and applying it again places it after the vouchers already applied. Canceling a completed redemption restores the redeemed balance with a separate credit and reverses the original voucher tax amounts.

Configure the commercial fields in Studio, including value or eligible product, validity, price and tax setup, and POS behavior. Do not try to correct these fields in the KORONA Event back office.

After saving in Studio, wait for the next synchronization or open Admin > Integrations and run Synchronize when an immediate import is required. See Connect KORONA.studio.

Edit the voucher presentation in the back office

In the back office, open Services > Vouchers.
Open the voucher configuration imported from KORONA.studio.
Enter the customer-facing Name and Description.
Add an image if the shop should show one.
Configure checkout policy only when the voucher should behave differently from the shop default.
Open Customer communications to add customer information, attachments, or scheduled emails when needed.
Save the voucher.

Review the canonical checkout policy options before overriding the shop default.

Voucher editor in the back office — Use the voucher editor to review customer-facing name, description, image, checkout behavior, and publish state before selling vouchers.

Make the voucher sellable

Publish the voucher only after checking:

the imported type, price, value, validity, and eligible products match KORONA.studio
the voucher is visible on the intended shop page or POS offer list
the voucher is not archived or hidden unintentionally
its customer-facing name, description, image, communication, and confirmation output are clear

The voucher's presence at a KORONA POS depends on the Studio/POS setup. Its presence in the online shop depends on its imported state, back-office publishing, and the shop page or page-builder offer list.

Test purchase and redemption

Buy the voucher through the same channel customers will use.
Confirm the order, payment state, and voucher code or document.
Open the public shop redemption path.
Enter the voucher code.
For a product-bound voucher, select the redeemable offer, date, time, and quantity. For a voucher without a product restriction, add the desired items and enter the voucher code in the cart.
Confirm that the voucher value or entitlement is applied before checkout is completed.

Online shop voucher redemption page — Use the redemption flow to confirm the voucher code is accepted and applied to the intended customer purchase.

Recover when an applied voucher cannot be used

The cart shows a warning if an applied voucher can no longer cover the order. Remove that voucher before continuing checkout. For a product-bound voucher, add an eligible product before applying it again. If another voucher already pays the full amount, leave the unused voucher removed and use it for a later purchase.

Expected result

The customer can buy a voucher, receive the correct voucher output, enter the code during redemption, and see the expected value or entitlement applied to the new order.

Troubleshooting

Problem	What to check
Voucher is missing from the shop	Sales channel, page builder offer list, publishing, hidden state, price, and voucher page activation.
Voucher code is not accepted	Code spelling, expiration, redeemed state, payment state of the original order, and whether the voucher belongs to this shop.
Redemption adds the wrong item	Eligible product in KORONA.studio, redeemable offer, required options, date/time selection, and cart contents before applying the code.
Voucher value is not deducted	Voucher state, value, selected offer eligibility, payment failure, duplicate cart rows, and whether the voucher was already consumed.
POS cannot redeem the voucher	KORONA.studio voucher/POS setup, synchronization, voucher recognition, and whether the voucher type is supported at that POS.