Quickvee Help Center

Set up coupons in the web backend

The Coupons module on the Quickvee Merchant Dashboard lets merchants create and manage promotional discount codes that customers can redeem at checkout — both online (storefront) and in-store (POS register). Each coupon can be a flat dollar amount or percentage discount, with optional minimum order thresholds, maximum discount caps, validity dates, and per-customer redemption limits.

Access path: Merchant Backend → Promotions → Coupons


Coupons home page

The Coupons page lists all existing coupons for the store as cards. Each card displays:

  • Coupon code in a blue pill (e.g. EMPLYDISCNT, RECHARGE40)

  • Discount summary — either 20.00 % OFF on minimum order of $5.00 (percentage) or $20.00 OFF on minimum order of $80.00 (amount)

  • Valid from — start date and expiry date range

  • Max Discount — the maximum dollar amount this coupon can deduct from a single order

  • Edit (pencil icon) — opens the coupon for editing

  • Delete (trash icon) — removes the coupon

The currently selected coupon is highlighted with a blue outline border.

To create a new coupon, click Add New Coupon + in the top-right.

Web Backend - Promotions - Coupons_Clicking Add New Coupon-20260529-103329.jpg



Adding a new coupon

Clicking Add New Coupon + opens the Add Coupons form.

List Online toggle

Located at the top-right. When enabled, the coupon is published on the customer-facing online storefront so customers can see and apply it during online checkout. When disabled, the coupon still exists and can be applied manually at the POS register, but is not visible to customers shopping online.

Coupon Code

The redemption code customers enter at checkout (e.g. NEWBIE).

Best practice: Use uppercase, no spaces, and keep it short and memorable. Codes are case-insensitive at checkout but display in uppercase on the storefront.

Description

A short text description used for internal reference and may be displayed alongside the coupon on the storefront. Example: "Only for new customers".

Minimum Order Amount

The minimum cart subtotal required for the coupon to apply. The field is prefixed with a $ sign.

If the customer's cart subtotal is below this amount, the coupon will not apply at checkout.

Discount Type Selector — Amount ($) / Percentage (%)

Two side-by-side buttons that determine how the discount is calculated. The label of the field next to it changes:

Selected Type

Field Label

Field Behavior

Amount ($)

Discount Amount

Enter a flat dollar value (e.g. $2.00) — coupon takes this exact amount off

Percentage (%)

Discount Percentage

Enter a percentage (e.g. 10.00) — coupon takes this % off the cart subtotal

Switching between types is allowed even after the coupon has been created — edit, click the other button, enter the new value, and save.

Maximum Discount Amount (Percentage type only)

This field appears only when the discount type is Percentage (%). It caps the total dollar value the coupon can deduct from a single order.

Example: 20% off with Maximum Discount Amount of $20.00, customer's cart is $200 → discount applied is $20.00 (the cap), not $40.00 (raw 20% calc).

Setting this field is recommended for any percentage coupon to protect against unintended large discounts on high-value orders.

Start Date / Expire Date

Calendar date pickers defining the valid window for the coupon. The coupon will only apply between these two dates (inclusive). Both default to today's date and a far-future expiry.

Enable Redemption Limit? toggle

When enabled, an additional Redemption Limit field appears.

Redemption Limit

The maximum number of times a single customer can use this coupon. Default is 1.

Per-customer limit, not store-wide. Setting this to 1 means each customer can use the coupon once, but multiple different customers can each use it once. If the toggle is disabled, customers can use the coupon unlimited times.

Add / Cancel

  • Add (blue) — saves the coupon and returns to the Coupons list

  • Cancel (grey) — discards changes

Web Backend - Promotions - Coupons_opens the Add Coupons form-20260529-104236.jpg



Editing a coupon

Click the pencil icon on any coupon card. The same Add Coupons form opens, pre-populated. Make your changes and click Add to save (the button label remains "Add" even when editing).

You can switch a coupon between Amount and Percentage modes during editing — the form updates accordingly.

Web Backend - Promotions - Coupons_Editing a Coupon-20260529-104318.jpg



Deleting a coupon

Click the trash icon on any coupon card. The coupon will be permanently removed.

Web Backend - Promotions - Coupons_Deleting a Coupon-20260529-104339.jpg


Deleted coupons stop applying immediately at the POS, on the storefront, and in any active customer carts. There is no recovery — re-create the coupon if needed.


How coupons apply

Channel

Behavior

Online Storefront

Customers see eligible coupons (those with List Online enabled) and can apply during checkout by entering the code

POS Register

Cashiers apply coupons by tapping the Coupons button on the register. Coupons with List Online disabled are still applicable at the POS

Order details

The coupon name appears in Order Details and on the Discount per Employee Report

Coupon stacking is not supported — only one coupon can be applied per order on the POS register today. (Multi-coupon support is being researched.)

Coupon order with other discounts: When both a coupon and an item discount are present, the coupon is applied to the cart subtotal before the item discount is calculated.


Important notes

Maximum Discount Amount is only for Percentage coupons. When you switch to Amount mode, the Maximum Discount Amount field is hidden because the flat dollar amount serves as the cap.

Currency symbols in fields. All dollar amount fields display with a $ prefix. The Discount Percentage field does not display a % — enter the number only (e.g. 10.00 for 10%).

Date format. Dates display as MM/DD/YYYY throughout the Coupons module.

List Online vs Show Online. Older versions had two separate visibility toggles which caused confusion. The interface now uses a single List Online toggle.

Redemption Limit toggle behavior. When OFF, the limit field is hidden — customers can redeem unlimited times. When ON, the limit applies per customer (default 1).

Tax calculation with coupons. Tax is calculated on the original cart subtotal before the coupon discount is applied. The coupon reduces the post-tax total but does not reduce the taxable amount.

Hold/Resume orders. Coupons applied to a held POS sale are preserved when the sale is resumed.

Disabling a coupon mid-day. If you delete a coupon while customers have it in their cart, it stops applying on the next refresh — but already-completed orders that used the coupon remain unaffected.

Internal reference

Source ticket: MM-452 — Coupons (Web Backend)