Loyalty & POS Redemption

This guide covers how wine club rewards integrate with your Toast POS system at your tasting room or retail location. When a member visits in person, their configured discounts apply automatically through Toast.

Looking for the points-based loyalty program for non-club customers? See the Rewards Program guide. The Rewards Program runs alongside everything described here — it adds points-priced rewards on top of the tier-based rewards covered in this guide.

How POS Redemption Works

Member arrives at your tasting room and identifies themselves to staff
Staff searches for the member by name, phone number, or email — or scans the customer's member QR code
Toast queries WineView and returns the customer's tier rewards, points-priced program rewards, points balance, and any pending pickups
Available discounts appear as loyalty offers on the Toast check
Staff applies the appropriate offers to the check
WineView records each redemption and updates the member's usage count or points balance

Your staff does not need to manually look up rewards or apply discount codes — the system handles eligibility and presents available discounts directly in Toast.

Member QR Code

Members can show a QR code at the register for fast check-in. The QR is available in two places in their member dashboard:

/member/qr — A combined view of every QR card the member has, including club QR cards (one per active membership) and rewards QR cards (one per business with rewards enrollment).
/member/rewards/[businessGroupId] — A focused view of the QR card for a single business's Rewards Program.

Scanning the QR identifies the customer instantly and pulls up their tier rewards, points balance, and any pending pickups in one step.

Toast Integration Setup

POS redemption requires:

An active Toast integration on the location (configured at Dashboard → Integrations → Toast)
Rewards configured with location-level settings (enabled locations, item mappings for Item scope rewards)
The Toast Loyalty API connection between WineView and your Toast account

Member Eligibility

Only members with specific statuses are found in Toast loyalty searches:

Membership Status	Appears in Toast?	Receives Discount Offers?
Active	Yes	Yes — Full access to discount offers
Trialing	Yes	Yes — Full access to discount offers
Paused	Yes	No — Appears with an informational "membership paused" message but receives no discount offers
Past Due	Yes	May show payment issue banner
Cancelled	No	No — Does not appear in loyalty searches
Staged	No	No — Pre-active members are not yet eligible

What Staff Sees at the Register

When a member is looked up in Toast, the following appears:

Account info — Member name, tier, membership status
Discount offers — Check-level and item-level discounts from their tier's rewards, with remaining redemption counts
Pickup offers — Any pending reservations eligible for in-store pickup (shown as comps on the check)
Status messages — Pause notice, payment issue banners, or other informational messages if applicable

Discount Types at POS

Check Discounts

A percentage or fixed amount off the entire check. Respects minimum spend thresholds if configured on the reward.

Item Discounts

A percentage or fixed amount off specific eligible items on the check. Only qualifying items receive the discount based on the reward's item type (Alcohol, Non-Alcohol, or All) and selection mode (Any item or Specific items) settings.

All discounts follow the rules defined in your reward configuration: discount type (percentage or flat), scope (check or item), applicable items, spend requirements, and per-cycle redemption limits.

POS Pickup

When a member has a pending reservation marked for pickup, it appears as a pickup offer at the register:

Staff can add the pickup to the Toast check
The items appear as comps on the check (the member already paid for them as part of their membership)
The reservation is fulfilled when the check is completed
If the check is voided, the pickup is reversed automatically

This feature requires the POS Terminal Pickups toggle to be enabled on the Toast integration settings page (Dashboard → Integrations → Toast → Settings → POS Terminal Pickups).

When Automatic Charge Adjustments is also enabled, WineView automatically charges overages or issues credits when the Toast pickup is completed and any price differences exist.

Redemption Tracking at POS

Every POS redemption is logged with:

Date and time
Location
Items the discount was applied to
Toast check and order IDs
Which reward was used
Quantity redeemed

Staff can view redemption history on the Members page in the member sidebar (Dashboard → Members → click member → Redemption History). Members see their own history on the Membership Rewards card in their dashboard.

Reversals

If a Toast check is voided or reversed, the associated reward redemptions are automatically reversed and the member's usage count is restored. No manual action is needed. Each reversal records the reversed status, timestamp, quantity, and reason.

For points-based redemptions from a Rewards Program, the reversal also returns the spent points to the customer's balance via a Reversal ledger entry.

Card on File Payments at the POS

When a customer is enrolled in your Rewards Program and has a payment method saved (per the program's Card on File policy), Toast can offer a Charge to card on file payment option for that customer.

The flow:

Customer is identified at the register (QR code or search).
Toast presents a "Charge to card on file" tender option for the matched customer.
Staff applies it to the check; WineView authorizes the saved card via Stripe and reports the result back to Toast.
The check settles. If a Rewards Program is active, points accrue normally on the settled total per the program's earn rules.

If the card-on-file authorization fails (insufficient funds, declined, etc.), Toast surfaces the failure inline and staff can fall back to another tender. Failed and reversed tender attempts are logged on the customer's record.

This feature requires a Toast integration with the Tender Handler enabled. See Toast Integration.

Troubleshooting POS Rewards

If rewards are not appearing on Toast checks:

Check the Toast integration — Verify the connection is active at Dashboard → Integrations → Toast. The status badge should show Active.
Verify location configuration — The reward must be enabled at the specific location where the member is visiting. Go to the reward's settings and check the location toggles.
Confirm member status — Only Active members receive discount offers. Paused members appear but get no discounts. Cancelled members don't appear at all.
Check redemption limits — The member may have used all their allowed redemptions for the current cycle. Check the member sidebar for current cycle usage.
Verify item mappings — For Item scope rewards with Specific mode, qualifying menu items must be selected for that location. Go to the reward's location configuration and check the item list.
Check the POS Terminal Pickups toggle — For pickup offers, ensure the toggle is enabled in Toast integration settings.