Zerra logo

ZerraLivin Documentation Campaign

Voucher

Create discount vouchers tied to a merchant, for residents or for units, valid over a set date range.

  • view
  • get
  • create
  • update
  • delete

What it’s for

A Voucher is a discount offer from a merchant — a percentage or fixed amount off, valid over a date range, targeted at either residents or units. This page is where those are created and managed.

Where to find it

Sidebar → CampaignVoucher, at /admin/campaign/voucher.

Who can use it

  • See the menu item and open the page — needs view.
  • See the voucher list — needs get.
  • Create, edit, delete — each needs its own permission.

On this screen

A table of vouchers, filterable by merchant and type, with create, edit, and delete.

How to…

Create a voucher

  1. Click create.
  2. Enter a title and, optionally, a code.
  3. Pick the merchant it’s issued for.
  4. Set the validity period — a start and end date, end on or after start.
  5. Pick who it’s for: Resident or Unit.
  6. Set the discount — Percent (capped at 100%) or Fixed amount.
  7. Optionally add a description.
  8. Set it active or inactive.
  9. Save.

Edit or delete a voucher

  1. Open the edit or delete action on its row.
  2. For edit, change any field. For delete, confirm.

Field reference

FieldRequiredNotes
TitleYes
CodeNo
MerchantYes
Validity periodYesEnd date can’t be before the start date
TypeYesResident or Unit
Discount type / valueYesPercent (max 100) or Fixed amount
ActiveYes

Rules & statuses

Active is a separate flag from the validity period — a voucher can be marked inactive even while still inside its date range, and a voucher outside its date range doesn’t automatically flip to inactive. Both should be checked when a voucher isn’t showing up where expected.

  • Merchant — where the merchants a voucher can belong to are managed.
  • Banner — a banner can link directly to a voucher instead of a URL.