Docs
← cabintale.com EN · CZ Email support
Products · Tutorial

Vouchers

Sell gift vouchers from your account. Each one a customer buys becomes a unique code they can spend on a booking, service, or product.

By the end of this guide you'll know how to create a voucher, how codes reach your customers, how to hand out codes yourself (or import codes you've sold elsewhere), how to chase up an unpaid voucher order, what happens to codes when you refund or cancel, and how a voucher gets redeemed.

Before you start

What you'll need

  • A payment gateway set up in Settings → Payments — only needed if customers will buy vouchers online. Handing out vouchers yourself works without one.
  • Optionally, a short code prefix (e.g. SUNNY) so codes carry your brand.
  • About 10 minutes for your first voucher.
What you'll achieve
  • A voucher for sale on your website
  • A Vouchers tab listing every code you've issued
  • The ability to hand out gift codes yourself — or import codes you sold elsewhere
  • A PDF export of all your codes for your records
  • A clear choice over what happens to codes when you refund or cancel an order

What's a voucher?

A voucher is a prepaid code your customer can spend later. When someone buys one, cabintale creates the code and emails it to them. Each voucher has:

  • A unique code like SUNNY-RDX9-RPMS (or RDX9-RPMS if you don't set a prefix)
  • A value and currency, fixed at the moment it's bought
  • A status — Active, Redeemed, Expired, or Cancelled
  • An optional expiry date

Your customer sees their code(s) on the payment success screen and in their confirmation email.

Step 1: Create a voucher product

Sidebar → Products+ → fill in the new-product form:

FieldVoucher value
NameWhat the customer sees (e.g. Cellar Voucher, Spa Day Voucher).
TypeVoucher.
Country / CurrencyPair automatically; must match what your payment gateway supports.
Pricing modeSingle price (one voucher value) or Options (several values sold from one button).
Price (single mode)The value of each voucher (e.g. 500 for a 500 CZK voucher). Every code from this product carries this value.
Options (options mode)One line per voucher value, e.g. 500 CZK voucher — 500, 1 000 CZK voucher — 1000. Each line's price becomes the value of vouchers sold from it.
Code prefix (optional)1–8 letters/digits, e.g. SUNNY. Codes then look like SUNNY-RDX9-RPMS. Leave empty for code-only.
Validity (days) (optional)How long after purchase before the voucher expires. Empty = never expires.

Click Save. The product opens, and a Vouchers tab appears under it (only voucher products get this tab).

Step 2: Set up the Checkout button

Add a Checkout button exactly as you would for a regular product (see Products overview, Step 2). The button label can show the value: Buy a 500 CZK voucher.

The quantity limits you set on the product apply here — e.g. allow up to 10 vouchers in one checkout, each generating its own code.

Step 3: How a guest buys a voucher

It's the same 4-step dialog as any product:

  1. Quantity — how many vouchers (one stepper per value in Options mode).
  2. Details — name and email (required); you can add a gift-message or recipient-name field.
  3. Review — the running total.
  4. Pay — the payment page.

When payment goes through:

  • One code is created for each voucher bought, with the value and currency locked in, and an expiry date if you set one.
  • The customer's confirmation email lists every code as a chip showing the code, value, and expiry (if any).
  • You get the usual new-order notification.

Step 4: View and manage issued vouchers

Sidebar → Products → {your voucher} → Vouchers.

Two tabs at the top:

  • Active — codes that can still be spent.
  • Expired — codes that have been used, have expired, or were cancelled.

Each row shows the customer's name and email, when it was issued, when it expires, the linked order, the code, its status, and an actions menu. Click a row to open the voucher's Detail page, where you can see its value, what it was redeemed against (once used), and cancel it if it's still active.

See and export all your vouchers

Sidebar → Products → All vouchers gathers every code across all of your voucher products into one list — customer, value, issue date, validity, linked order, and status, all in one place.

To take a copy with you, click Export vouchers and pick which to include:

  • All vouchers — everything.
  • Active — codes that can still be spent.
  • Redeemed — codes that have been used.

cabintale builds a PDF listing each voucher's code, customer, value, issue date, validity, linked order, and status — handy for your own records or your accountant.

Step 5: Hand out vouchers yourself — or import codes from elsewhere

For gift codes, in-person sales, comps where no online payment is involved — and to bring in codes you've already sold somewhere else (paper vouchers, codes from a partner, leftovers from an old till) so guests can redeem them here.

Path: Sidebar → Products → {your voucher} → VouchersAdd voucher.

FieldWhat it does
Value per voucherOverride the product's price; leave empty to use it.
Custom code (optional)Paste a code that already exists — printed on a paper voucher, issued by a partner, or from your old till. Leave it empty to have cabintale generate a fresh code. (Letters, numbers, dashes and underscores; up to 50 characters.)
QuantityHow many codes to generate in this batch (1–100). When you enter a Custom code this locks to 1 — a single code can't be reused.
Validity (days)Same as on the product; empty = never expires.

The Preview under the form shows what the code will look like: a placeholder like SUNNY-XXXX-XXXX if cabintale is generating one, or the exact code you typed if you entered a Custom code.

Submit, and cabintale generates the codes and takes you to the Active tab with a note of how many were created. A matching order is recorded (marked as issued manually, with no payment) so your books stay tidy — there's nothing to refund on it. To switch off a manual voucher, use Cancel on its row.

Importing a voucher sold elsewhere

For each existing code you want guests to be able to redeem here:

  1. Open Add voucher on the matching voucher product.
  2. Set Value per voucher to the printed value.
  3. Paste the existing code into Custom code.
  4. Set Validity (days) to match its printed expiry (or leave empty).
  5. Save.

The customer can now redeem that code in your booking widget or via Add Payment — exactly as if it had been issued here from the start.

Step 6: Send a payment link for an unpaid order

If a customer started buying a voucher but didn't finish paying, send them a link to pick up where they left off:

  1. Open the order in Orders.
  2. In the Payments section, click Send payment link.
  3. cabintale copies a payment link to your clipboard — paste it into a chat or email.
  4. When they pay, their codes are created just as if they'd finished the first time.

The button only appears if the product has a payment gateway and the order isn't already paid.

Step 7: Cancel, refund, or delete — what happens to the codes

Whenever you do something that ends a voucher order, cabintale asks what to do with the codes on it. You'll see this when you refund a payment, cancel the order, or delete it. Two choices:

  • Cancel all vouchers — every code on the order stops working.
  • Keep vouchers — the codes stay active and spendable; only the order changes.

Step 8: Cancel a single voucher

Two ways:

  • Vouchers list → row menu → Cancel voucher
  • Order detail → Issued Vouchers → the trash icon on the row

Confirm, and the code stops working. To give the customer their money back instead, refund the payment on the order — cabintale will then ask whether to cancel the codes too.

Step 9: Redeem a voucher

A voucher code can be used as payment toward a place booking, a service booking, or another product order. Codes aren't fussy about formatting — SUNNY-RDX9-RPMS, sunnyrdx9rpms, and SUNNY RDX9 RPMS all work.

Currency and account must match. A CZK voucher can't pay for a EUR booking, and a code from one account can't be used on another.

When a guest redeems it

  1. On the Summary step, they click Use voucher code.
  2. They enter the code and press Use. cabintale checks it and shows the value.
  3. If the voucher covers the whole amount, no card is charged.
  4. If it only covers part, the rest shows as Due now and they pay the remainder on the payment page.

Either way the voucher is used up in full — there's no leftover balance.

When you redeem it for them

  1. Open the booking or order in the admin.
  2. In Payments, click Add Payment.
  3. Set Type to Voucher, enter the code, and submit. The voucher is marked as redeemed.

When you redeem it manually

Sometimes a voucher is spent on something you arrange outside cabintale — an in-person experience, an offline booking, anything you don't sell through your widget. You can mark it as used yourself, straight from the admin.

Where to find it:

  • Vouchers list (Sidebar → Products → {your voucher} → Vouchers, Active tab) → row menu → Redeem.
  • Voucher detail page → the Redeem button in the header.

The button only shows on Active vouchers — ones already redeemed, expired, or cancelled can't be redeemed this way.

When you click Redeem, a dialog asks what the voucher was spent on:

  • Pick one of your places, services, or products — to link the redemption to a specific item.
  • Or choose "Redeem without linking — used elsewhere" (the default) — for anything you don't sell through cabintale, or when you just want to mark it as used.

Confirm, and the voucher is marked Redeemed right away. Its detail page then shows a Redeemed against card with the date — and the linked item, if you picked one.

What the statuses mean

  • Active — ready to be spent.
  • Redeemed — already used. The voucher's detail page shows which booking or order it paid for, and when.
  • A code can also be briefly on hold while a guest is in the middle of paying. It frees up on its own when they finish or give up — and you can release it yourself with Release hold on the voucher's detail page if one ever gets stuck.

Limitations (for now)

  • One value per code. To sell several values from one button, use Options mode and add a line per value.
  • PDF export only. You can export your vouchers to PDF (from Products → All vouchers); a CSV or API export isn't available yet.
  • One voucher per booking or order. Codes can't be stacked.
  • Always used in full. There's no remaining balance to carry over.
  • No transfer. A code stays tied to the account that issued it.

Related guides

Still stuck?

We reply to every email within one business day.

Email support →