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

# Value Vouchers

> Offer flexible monetary vouchers that customers can redeem as a means of payment on any booking.

A value voucher is a multi-purpose voucher with a pure monetary value that customers can use flexibly for any paid service. Unlike purpose-bound booking packages, the voucher isn't tied to a specific resource or allowance. Instead, it works as a means of payment when redeemed.

<Info>
  * Available from the Professional plan.
  * Activate the **Booking Packages** feature in advance under **Account Settings** → **Features**.
</Info>

## How does the concept work?

Value vouchers use a special tax logic (multi-purpose voucher under the EU directive):

1. **At purchase**: The invoice shows 0% VAT. The customer only pays the net amount, because at the time of purchase it's still unclear for which service (and at which tax rate) the voucher will be used.
2. **On redemption**: The voucher value is applied to the booking as a means of payment. The correct VAT is only shown on the final booking invoice.

That's what fundamentally distinguishes value vouchers from purpose-bound booking packages, where VAT is already calculated at purchase.

**Two variants:**

* **Fixed amount**: You define an exact value (e.g. 50 euros). Customers buy exactly this amount.
* **Free amount**: Customers choose the value themselves. You optionally set a default amount and a minimum amount.

After the purchase, customers receive an **8-digit booking code**, which they enter as a means of payment at the checkout of any paid booking.

## When do I use this?

* **You want to sell gift vouchers**: Customers buy a voucher for friends or family, who choose for themselves what to book.
* **You want to let customers choose a flexible amount**: enable the free amount with a minimum limit.
* **You don't want to refund money on cancellations, but tie up credit instead**: link the value voucher to your cancellation conditions.
* **You need vouchers for promotions or compensation**: create codes manually in the admin area.
* **Not suitable for**: allowances for a specific service (e.g. a 10-pass). Use a purpose-bound booking package for that.

## Relationship to other features

| Feature                  | Relationship                                                                                                                                       |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| Booking Packages & Codes | Value vouchers are a mode within the Booking Packages feature. The code logic is identical.                                                        |
| Cancellation conditions  | Value vouchers can be configured as a form of refund. On cancellation, the customer automatically receives a code.                                 |
| Online payments          | The voucher value is offset against the booking price on redemption. In case of partial settlement, the customer pays the remaining amount online. |

## Settings & options

| Setting (admin)           | Description                                                                   |
| ------------------------- | ----------------------------------------------------------------------------- |
| Fixed amount              | Exact voucher value, e.g. 50 euros                                            |
| Free amount               | Customers choose themselves                                                   |
| Default amount            | Pre-filled value for free amount                                              |
| Minimum amount            | Lower limit for free amount                                                   |
| Expiry date               | Validity of the code (default: 2 years)                                       |
| Legal documents           | Documents that must be confirmed at purchase                                  |
| Limit usage               | Restrict redemption to certain resources (category, group, resource, service) |
| Document template         | Document sent to customers at purchase                                        |
| On-site document template | Second template for admin purposes only (e.g. printout)                       |
| Offer delivery address    | Ask for a different delivery address at checkout                              |
| Offer business address    | Ask for a business address at checkout                                        |
| Shipping                  | Disabled, Optional or Always (incl. shipping costs)                           |
| Cancellation as voucher   | Link to a resource's cancellation conditions                                  |

On the booking page, value vouchers appear in the "Booking Packages" tab. For the free amount, customers see an input field for their chosen amount.

## Create a value voucher

<Steps>
  <Step title="Open Booking Packages">
    Open **Booking Packages** in the menu bar on the left.
  </Step>

  <Step title="Create a new package">
    Click **New+** and select the **Value Voucher** tab.
  </Step>

  <Step title="Configure name and amount">
    Enter a name (e.g. "Gift voucher"). Enter a fixed default amount (e.g. 50 euros) or set the minimum amount to 0 so customers can choose the amount freely.
  </Step>

  <Step title="Set the expiry date">
    Set the validity in days (default: 720 days).
  </Step>

  <Step title="Add a description">
    Add a description that's shown on the booking page.
  </Step>

  <Step title="Optional settings">
    Configure if needed: document template, limit usage, offer delivery address, offer business address and shipping mode.
  </Step>

  <Step title="Go live">
    Activate the **Live toggle** at the top right. The value voucher now appears on your booking page in the "Booking Packages" tab.
  </Step>
</Steps>

<Tip>
  In the account settings, you can define whether booking packages are shown as the default tab on the booking page.
</Tip>

## Limit usage

Although value vouchers are designed as a multi-purpose voucher by default, you can optionally restrict redemption to certain resources. To do this, click **Limit usage** in the package editor and select one or more resources, groups, categories or services.

<Tip>
  The restriction is optional. Without one, the voucher can be redeemed for any paid booking in your organization.
</Tip>

## Shipping mode and delivery address

If you want to send physical voucher cards by post, you can set a shipping mode per value voucher:

| Mode     | Behavior                                                      |
| -------- | ------------------------------------------------------------- |
| Disabled | No shipping, purely digital delivery                          |
| Optional | Customers choose at checkout whether they want shipping       |
| Always   | Shipping is mandatory, shipping costs are added automatically |

You can also store a shipping cost amount that's added to the voucher price.

With the **Offer delivery address** and **Offer business address** toggles, you ask for additional address fields at checkout so delivery reaches the right address.

In the admin area, you can see which vouchers still need to be shipped and mark them as **shipped** once they're sent.

## Configure cancellation as a value voucher

Instead of transferring the amount back on a cancellation, you can automatically convert the cancellation value into a booking code. The customer receives the code by email and can redeem it on their next booking. Set this up in the relevant booking option under the **Change & cancellation** tab.

<Warning>
  Automatic voucher refunds only work with invoices that are already finalized. For invoice drafts, the logic doesn't apply.
</Warning>

## Practical examples

<AccordionGroup>
  <Accordion title="Beauty studio with gift vouchers (fixed amount)">
    A studio wants to sell 50-euro vouchers that customers can redeem for any treatment.
  </Accordion>

  <Accordion title="Yoga studio with cancellation credit instead of a refund">
    A studio doesn't want to refund a monetary amount on cancellations, but give customers a voucher for their next booking instead.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Why does the purchase invoice show 0% VAT?">
    That's the correct tax treatment of a multi-purpose voucher. Since it isn't yet clear at purchase which service the voucher will be used for, no VAT may be shown. The tax is only calculated on redemption.
  </Accordion>

  <Accordion title="What happens if the voucher value is higher than the booking price?">
    Only the amount needed is deducted from the voucher. The remaining credit stays on the code and can be used on a later booking.
  </Accordion>

  <Accordion title="Can a value voucher be used for several bookings?">
    Yes, as long as there's remaining credit on the code.
  </Accordion>

  <Accordion title="Does cancellation as a voucher also work for partial refunds?">
    Yes. The voucher code is issued with the respective refund amount, including any booked add-ons.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Customers can't see an input field for the free amount">
    Check whether the mode is set to **Value Voucher** and the freely selectable amount is enabled. Also make sure customers access through the parent organization page, not through a direct resource link.
  </Accordion>

  <Accordion title="No voucher code is sent on cancellation">
    The automatic conversion only applies to finalized invoices. Check whether the invoice was already finalized at the time of cancellation. For invoice drafts, no code is generated.
  </Accordion>

  <Accordion title="The voucher code isn't accepted on redemption">
    Check the validity of the code (expiry date). In rare cases, imported codes can trigger billing errors. Contact support with the code.
  </Accordion>
</AccordionGroup>

> Important information for agents:
>
> * Feature: Value Vouchers (mode B of Booking Packages). Plan: Professional.
> * UI path: **Booking Packages** (menu bar) → New+ → Value Voucher mode.
> * UI path cancellation as voucher: Resource → Booking options → **Change & cancellation**.
> * Tax logic: Purchase = 0% VAT (multi-purpose voucher). Redemption = VAT on the booking invoice.
> * Cancellation voucher: ONLY with finalized invoices. Add-ons are included.
> * Remaining credit: Stays on the code, can be used multiple times.
> * Free amount: Only reachable through the organization page, not through direct links to resources.
> * Distinction from booking package (mode A): Purpose-bound, VAT at purchase, redemption = discount.
> * Distinction from discount codes: Percentage/absolute price reduction at checkout, no balance.
> * TWINT: Doesn't support voucher payment separately, the voucher is settled before payment.
> * Limit usage: Optional, restriction to resource/group/category/service. Without a restriction = valid for all paid bookings.
> * Shipping mode (since June 2026): Disabled/Optional/Always. Shipping costs are added. Admin can mark as "shipped".
> * Delivery address/business address: Toggle per voucher, asks for additional address fields at checkout.
> * On-site document template (since July 2026): Second document for admin purposes only, not sent to customers.