Skip to content
Resrv
Esc
↑↓navigate↵open⌘Jpreview
On this page

Vouchers

The Vouchers add-on gives every confirmed booking a QR code voucher. Guests get it with their confirmation email, and your staff scan it in the Control Panel when the guest arrives. It suits anything a guest turns up for: spa treatments, restaurant tables, tours, classes or tickets.

How it works

  • When a booking in one of your chosen collections is confirmed, its confirmation email comes with the voucher as a PDF. The email can show the QR code too.
  • At the door, staff scan the QR code or look up the booking reference, then mark the voucher as used. The guest gets a “Thank you for attending!” email.
  • If the booking is cancelled or refunded, its voucher stops working. An unused voucher expires a day after the booking ends.

A voucher looked up on the Scan page.

A voucher looked up on the Scan page.

Installation

Install the add-on with Composer, then run its install command:

composer require reachweb/statamic-resrv-vouchers
php artisan resrv-vouchers:install

The install command sets up the add-on’s config file and database tables. It also asks whether to publish the email templates and language files: say yes only if you want to edit them. You can run it again later to publish them.

Then list the collections that should get vouchers in config/resrv-vouchers.php, by their handles:

'enabled_collections' => ['spa_treatments', 'restaurant'],

The list starts empty, so no booking gets a voucher until you add a collection.

The “Thank you for attending!” email goes out through your queue. If your queue runs in the background, keep a worker running (php artisan queue:work).

Permissions

Staff need the Use Resrv Vouchers permission, in the Resrv Vouchers Permissions group under Users → Roles. Resrv’s own permission doesn’t include it, so door staff can scan vouchers without seeing your reservations. Super users have it already.

Scanning vouchers

Go to Resrv → Vouchers → Scan, then either:

  • press Start camera and point it at the guest’s QR code, or
  • type the booking reference or reservation code from the guest’s email and press Find voucher.

The result shows the booking and whether the voucher is valid. Press Mark as used when the guest arrives, then Scan another for the next guest. Marking a voucher as used can’t be undone.

The camera only works when the Control Panel is on HTTPS. Without it, type the booking reference instead.

Voucher statuses

Status Meaning
Issued Valid and not used yet. Only issued vouchers can be marked as used.
Used Staff marked it as used. It stays used even if the booking is refunded later.
Invalidated The booking was cancelled or refunded before the voucher was used.
Expired It wasn’t used in time.

Vouchers expire a day after the booking’s end date. To give guests longer, raise grace_days in config/resrv-vouchers.php. The change applies to vouchers issued after it.

The voucher list

Resrv → Vouchers → List shows every voucher, newest first. Filter it by status or entry, or search by booking reference.

The voucher list, with a voucher in each status.

The voucher list, with a voucher in each status.

Showing the QR code in the email

The voucher PDF is always attached to the confirmation email. To show the QR code in the email itself, publish Resrv’s email templates and add this line to resources/views/vendor/statamic-resrv/email/reservations/confirmed.blade.php, where you want the code to appear:

@include('statamic-resrv-vouchers::email.vouchers.partials.qr')

Emails for bookings without a voucher show nothing there. To change the caption under the code, publish the add-on’s language files.

The QR code in the confirmation email.

The QR code in the confirmation email.

The “Thank you for attending!” email

Change its subject and sender in config/resrv-vouchers.php:

'email' => [
    'attended' => [
        'subject' => 'Thanks for visiting the spa',
        'from' => [
            'address' => '[email protected]',
            'name' => 'The Spa',
        ],
    ],
],

To change its text, publish the add-on’s email templates and edit resources/views/vendor/statamic-resrv-vouchers/email/vouchers/attended.blade.php.

Dashboard widget

To put buttons for the Scan page and the voucher list on the Control Panel dashboard, add the widget to config/statamic/cp.php:

'widgets' => [
    [
        'type' => 'vouchers',
        'width' => 'md',
    ],
],

Only staff with the voucher permission see it.

The Vouchers dashboard widget.

The Vouchers dashboard widget.

Troubleshooting

  • A booking has no voucher. Check that its collection is in enabled_collections.
  • The “Thank you for attending!” email doesn’t arrive. Check that a queue worker is running.
  • Mark as used doesn’t appear. The voucher was already used, or it’s invalidated or expired. The result says which.

For developers, the add-on’s README covers its events, its separate signing key option and more.

Was this page helpful?