> 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/vouchers.md).
# Vouchers
#### Understanding vouchers
When a customer redeems a reward in your loyalty program, they receive a voucher. This voucher serves as proof of their redeemed reward and contains important details for both customers and staff members.
**Accessing vouchers**
Customers can find their vouchers by navigating to the "Perks" tab and selecting the "My Vouchers" subtab. Here, they will see a list of all vouchers associated with their account. Business staff can view redemptions and their corresponding voucher code on the [customer profile page](/features/customers.md).
**Voucher details**
Each voucher includes the following information for the customer:
* **Name of the redeemed reward:** Clearly states the name or title of the reward that was redeemed.
* **Voucher status:** Indicates the current status of the voucher (e.g., Unused, Used, Issued).
* **Points deducted for the reward:** Specifies the number of loyalty points deducted from the customer's account upon redeeming the reward.
* **Expiration date:** Displays the date when the voucher expires.
* **Fine print:** Includes any specific terms or conditions associated with the voucher.
* **Code:**
* Vouchers can display a single-use coupon code, multi-use coupon code, Perkville voucher code/barcode, or a credential supplied by an external reward provider.
{% hint style="info" %}
If a customer redeemed a reward by mistake and did not receive or use it, staff may be able to void the redemption and return the points. See [Understanding voucher redemptions and how to handle mistaken redemptions](/faqs/redemptions/understanding-voucher-redemptions-and-how-to-handle-mistaken-redemptions.md).
{% endhint %}
## Which voucher code should I use?
Use the reward instructions and the code type to determine what should be presented or entered:
| Code or credential | When it is used | What to know |
| ---------------------------------- | ------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Single-use coupon code** | The reward has a unique code that should only be redeemed once | Perkville displays the code with a QR code when configured. |
| **Multi-use coupon code** | The same promotion or redemption code can be used more than once | Perkville displays the code with a QR code when configured. |
| **Perkville voucher code/barcode** | No single-use or multi-use coupon code was supplied for the reward | This identifies the Perkville voucher and can support the business's Perkville redemption workflow. |
| **External reward credential** | The reward is fulfilled by an external reward provider | The provider may supply a gift-card number, PIN, link, barcode, or other credential. Follow the provider-specific instructions shown with the reward. |
Related documentation: Redeeming options, External rewards, and Voucher statuses.
If a merchant or fulfillment system rejects the displayed code:
1. Confirm the customer is using the credential specified in the reward instructions, not simply another code shown on the voucher.
2. Check the voucher status. An **Issued** status means the voucher was issued without requiring a later Perkville status change; it does not by itself confirm that an external merchant accepted the credential.
3. For an external reward, follow the external provider's instructions and confirm any required number, PIN, link, or barcode was supplied.
4. If the credential still does not work, contact the business that issued the reward or Perkville Support with the reward name and voucher details.
**Using vouchers**
Customers can use their vouchers according to the instructions provided on each voucher [that the business provides](/features/redeeming-rules/custom-rewards.md). Typically, vouchers may need to be presented or referenced at the time of redemption, depending on your specific redemption process.
**Managing vouchers**
Staff members can view and manage vouchers through the [administrative tools](/features/customers.md) provided by Perkville. This includes verifying voucher status, assisting customers with voucher-related inquiries, and ensuring a smooth redemption process.
**Expiry notifications**
Assuming the customer is opted into Perkville emails, they will receive one notification about vouchers expiring in the next seven days. However, no email notification is sent when the voucher actually expires.
---
# 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/vouchers.md?ask=&goal=
```
`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.
