# Vouchers

Voucher codes can be created to offer shopping discounts to new or existing customers. Voucher functionality is still relatively limited, please read through [this guide before implementing vouchers in your shop process](/hub-management-tips/how-tos/vouchers-v.-tags.md).&#x20;

{% hint style="info" %}
Vouchers is in 'beta' mode, meaning it's a new feature that may still have some glitches. Please [contact us](https://www.openfoodnetwork.org/find-your-local-open-food-network/) with any feedback about what works, what needs improving or how it could be better explained.
{% endhint %}

{% hint style="success" %}
Visit these pages for a step-by-step guide to using the Vouchers feature to:

* offer a percentage discount via a[ social media campaign](/hub-management-tips/how-tos/running-a-social-media-promotion.md)
* [sell and manage gift vouchers](/hub-management-tips/how-tos/how-to-create-gift-vouchers.md)
  {% endhint %}

Set up and manage vouchers in the **Vouchers** tab in your [Enterprise Settings](/basic-features/enterprise-profile/enterprise-settings.md).

<figure><img src="/files/1BCfRXPSg7WnR2rdIBg8" alt=""><figcaption></figcaption></figure>

## Setting up a voucher

* Go to 'Vouchers' by clicking on **Enterprises** in the main menu at the top of the page and then click **Settings** next to your enterprise. The **Vouchers** page is found in the menu on the left hand side
* Click **Add New** in the top right of the vouchers page to be taken to the new vouchers page

<figure><img src="/files/Ay1zLL5BnO60YZXIEyae" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/bAslg5fzxbbwRXTM7Ndu" alt=""><figcaption></figcaption></figure>

* **Voucher Code** - the code customers will enter to receive a discount. Code is string matched, so double check the spelling, spaces and numbers.&#x20;
* **Voucher Type-** There are two options here: Flat (for a flat rate discount) and Percentage (so someone can have a percentage discount).
* **Amount** - The numeric percentage or flat rate you wish the discount to apply.
* Click **save** to create the voucher.

{% hint style="warning" %}
New vouchers will be created as active. If you do not want your voucher to be active, switch it off using the steps below
{% endhint %}

## Managing vouchers

Vouchers can be turned off and on as needed by enterprise managers.&#x20;

{% hint style="warning" %}
Voucher codes will not automatically switch off after customer use
{% endhint %}

In the **Vouchers** page in Enterprise Settings, use the checkbox against each voucher code to deactivate or reactive your vouchers.&#x20;

Click **update** to save changes

<figure><img src="/files/7CWFKkyGiyWqvwEQ9j4f" alt=""><figcaption></figcaption></figure>

## Customer facing use

Customers will need the exact code as entered in the Voucher Code field of set up (above).

In step 2 of check out, **Payment method**, customers can enter the voucher code to have it applied to their order.&#x20;

{% hint style="info" %}
Only 1 voucher code can be applied per order
{% endhint %}

After applying the code, continue through check out to finalise the order

<div data-full-width="true"><figure><img src="/files/b93OKC8RXf4AdlK2W0AE" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
If the voucher brings the **order total cost to zero**, or below, the customer will not be prompted to enter payment method or details. *See screenshot below*
{% endhint %}

<figure><img src="/files/FxPgcmHiuyb7JDrFWhIo" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
If only part of the voucher is used (**order total becomes negative**), the remaining credit will not be carried over to the customers next order.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guide.openfoodnetwork.org/basic-features/shopfront/vouchers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
