Overview

Vouchers (also called promo codes) give guests a discount when they book. Unlike gift cards which store a balance, vouchers apply a percentage or fixed-amount discount to the booking total. They are ideal for marketing campaigns, seasonal promotions, loyalty rewards, or partnership deals.

You can create a single voucher code for a targeted promotion (e.g., SUMMER25 for 25% off) or generate a batch of unique codes for a distribution campaign (e.g., 500 unique codes to include in a mailer).

Creating a Voucher

Open Vouchers from the sidebar under Billing
Click New Voucher
Fill in the voucher details:
- Name — an internal name for the campaign (e.g., “Summer 2025 Promotion”)
- Discount Type — choose Percentage or Fixed Amount
- Discount Value — the discount to apply (e.g., 15 for 15%, or 50 for $50 off)
- Code Mode — choose Single Code or Batch Codes

Single Code Mode

Enter the exact code guests will use (e.g., WELCOME10). This is best for promotions where everyone uses the same code.

Batch Code Mode

Vesta generates unique codes automatically:

Set the number of codes to generate (1 to 1,000 per batch)
Optionally add a prefix (e.g., PROMO- produces codes like PROMO-A7K2M9)
Each code is 6 uppercase alphanumeric characters plus your prefix

Set validation rules (see below)
Click Create

:::tip Use single codes for public promotions (social media, website banners) and batch codes for personalized campaigns (email to specific guests, partner distribution) where you want each recipient to have a unique code. :::

Validation Rules

Vouchers can be restricted to control when and how they are used:

Rule	What It Controls
Valid From / Valid Until	The date range during which the code can be redeemed
Total Usage Limit	Maximum number of times the code can be used across all guests
Per-Guest Limit	Maximum number of times a single guest can use the code
Room Type Restriction	Only applies to bookings for specific room types
Rate Plan Restriction	Only applies to bookings using specific rate plans

:::info All validation rules are optional. If you leave them blank, the voucher has no restrictions beyond its active status. For most promotions, setting at least a date range is recommended. :::

How Vouchers Are Applied

When a guest (or staff member) applies a voucher during booking:

The system validates the code against all configured rules
If valid, the discount is calculated:
- Percentage: applied to the total accommodation charge
- Fixed amount: subtracted from the total
A discount line item appears on the booking’s folio as a negative charge
The voucher’s usage count is incremented

The discount appears on the folio alongside accommodation charges, so the guest can see exactly how much they saved.

Managing Vouchers

Viewing Voucher Details

Click any voucher in the Vouchers list to see:

Code(s) and current status
Discount type and value
Validation rules
Usage statistics — how many times the code has been redeemed
For batch vouchers, a list of all generated codes and their individual usage

Deactivating a Voucher

To stop a voucher from being used:

Open the voucher detail page
Toggle the voucher to Inactive

Inactive vouchers cannot be redeemed but remain in the system for reporting purposes. You can reactivate them later if needed.

Troubleshooting

Guest says code is not working?

Check that the voucher is active and within its valid date range
Verify the total usage limit has not been reached
If room type or rate plan restrictions are set, make sure the guest’s booking matches
Check if the guest has exceeded the per-guest usage limit

Discount amount looks wrong?

For percentage vouchers, the discount is calculated on the accommodation total, not the per-night rate
For fixed-amount vouchers, the full amount is applied regardless of the booking length

:::permissions

vouchers:view — view vouchers and their details
vouchers:create — create new voucher campaigns
vouchers:edit — modify voucher rules and status
vouchers:delete — remove vouchers :::

Selling and Managing Gift Cards — prepaid gift cards (balance-based, not discount-based)
Creating a Booking — where guests or staff apply voucher codes
Adding Charges to a Booking — how discount line items appear on the folio