> For the complete documentation index, see [llms.txt](https://docs.perkville.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.perkville.com/features/redeeming-rules/instant-rewards.md).

# Instant rewards

Instant Rewards let a business issue a reward immediately when a qualifying event occurs. Issuing an Instant Reward creates a voucher for the customer; it does not necessarily mean the voucher has already been used. The customer redeems the voucher according to the voucher status and redemption instructions you configure.

Instant Rewards can be connected to earning activities, referrals, challenges, or other automated workflows so the voucher is issued when the qualifying action occurs. An active Instant Reward that is not connected to an earning activity or other automation will not be issued automatically, although authorized staff can still issue it manually to a customer.

## Accessing Instant Rewards

To create instant rewards:

1. From the Dashboard, navigate to **Loyalty Program** in the left-hand navigation.
2. Click the **+** sign next to **Rewards**.
3. Select **Instant** from the dropdown menu.

## Creating Instant Rewards

When creating instant rewards, you can enter the following fields:

* **Name:** Enter the name of the reward.
* **Description:** Enter the description of the reward.
* **Fine Print:** Enter any fine print for the reward.
* **Display Order:** Choose the order in which the reward is displayed.

## Issuing versus redeeming an Instant Reward

**Issuing the reward** creates the customer's voucher. This can happen automatically when the Instant Reward is connected to qualifying program activity or manually when an authorized staff member issues the reward.

**Redeeming the voucher** is the later step when the customer uses the reward. The voucher's initial status and redemption instructions determine how that experience works.

## Voucher options

Customize voucher settings to suit your business needs:

* **Days Before Expiration:** Determine how many days the customer has to use the voucher before it expires.
* **Initial Voucher Status:** Set the status assigned to the voucher when it is issued.
* **Redemption Instructions:** Provide instructions telling customers how to use the voucher. Examples are provided based on the initial voucher status selected.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.perkville.com/features/redeeming-rules/instant-rewards.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
