Skip to content
Log in

Managing and spending vouchers

On this page

Allow customers to check voucher balance

Customers can check their voucher balance without logging in to your store.

  1. Customers can navigate to https://your-store-domain.com/check-voucher, substituting your store’s domain.
  2. They then enter their voucher Code.
  3. They can view:
    • Current balance
    • Order history (anonymized)
    • Expiry date (if applicable)

Using vouchers at online checkout

Customers can apply multiple vouchers to a single order. On the web storefront, vouchers are fully consumed up to their balance, so customers cannot choose to apply only part of a voucher’s value. (At the POS, staff can take a partial amount. See Process vouchers at POS.)

Customers can also apply vouchers when they pay an order’s balance through a payment link. See Use vouchers on an order’s payment page.

  1. The customer adds products to their cart and proceeds to the checkout.
  2. In the Voucher Panel during checkout, the customer enters the voucher Code.
  3. The customer clicks Apply or Add Voucher.
  4. StoreConnect validates:
    • Voucher code exists
    • Voucher has available balance
    • Voucher has not expired
    • Voucher has been activated and is not cancelled or locked
    • Voucher usage restrictions allow use on this store
  5. If the voucher is PIN-protected, the customer is prompted to enter the PIN. The voucher is not applied until the correct PIN is entered. An incorrect PIN prevents the voucher from being applied.
  6. If valid, the voucher amount is applied to the order total.
  7. If the voucher doesn’t cover the full amount, the customer selects a payment method for the remaining balance.
  8. The customer completes the checkout process.

Gift cards from Vii

If your store accepts Vii gift cards, checkout shows an Apply a gift card panel in the vouchers area. Unlike a StoreConnect voucher, a customer can choose how much of a Vii gift card to use. See Vii gift cards.

Use vouchers on an order’s payment page

A customer paying an order’s balance through a payment link can apply StoreConnect vouchers and Vii gift cards on the payment page, the same way they do at checkout. This includes a link sent from the register with Pay by link.

  • Applying — the customer enters the voucher code, and the PIN if the voucher has one. For a Vii gift card they enter the card number and PIN, check the balance, and choose how much to apply.
  • Removing — the customer can remove an applied voucher or gift card before paying.
  • Paying the rest — the applied amount comes off the amount the customer is paying now, and they pay the rest with a payment method. When vouchers cover the whole amount, the page shows Complete payment instead of the payment methods.
  • Redemption — vouchers are redeemed when the customer submits the payment, not when they apply them. A voucher with balance left can be used again on a later payment for the same order.
  • Who sees them — applied vouchers belong to the customer’s browser session. Anyone else who opens the same link sees the order without them.

For example, an order has a $100 balance and the customer holds a $30 voucher. They apply the voucher on the payment page, and pay the remaining $70 by card.

These limits apply on the payment page:

  • Subscriptions — vouchers cannot pay for subscription lines, as at checkout. The customer sees “You can’t use vouchers to pay for subscriptions.” and pays the subscription share with a payment method.
  • Renewal orders — vouchers cannot pay a subscription renewal order. The voucher and gift card panels do not appear on a renewal order’s payment page.
  • Custom amounts — if the store lets customers pay part of the balance, lowering the amount below the applied vouchers removes them, and the customer applies them again.
  • Balance checks — each voucher the customer applies counts toward the same limit as gift card balance checks. By default, one IP address can make 10 a minute, shared by every customer on the same network.

A voucher can fail to redeem when the customer pays, for example because it expired or was spent elsewhere. What happens next depends on the payment method:

  • A card payment taken on the page — StoreConnect refuses the payment before charging the card. The customer can review their vouchers and try again.
  • A payment method that collects the money before the page is submitted — the payment goes through. The page then shows the customer the amount still due on the order.

The voucher panels are part of the default payment page. If your theme overrides the additional_payment page template, render the additional_payment/vouchers snippet in the override, as the default template does, or the panels do not appear.

Spending vouchers at the POS

Vouchers can also be redeemed in-store at the point of sale, where staff select Voucher as a payment method, enter the code (and PIN if required), and can take the full balance or a partial amount. Staff can also look up a voucher balance at the register. For the full walkthrough, see Process vouchers at POS.

How voucher payments are tracked in StoreConnect.

When a voucher is used at checkout:

  • A Payment record is created for each voucher applied.
  • A Voucher Payment record (Voucher_Payment__c) is created to track the spend.
  • The voucher’s remaining balance is automatically calculated.
  • The voucher can be used on future orders until the balance is depleted or it expires.

Stop a voucher from being spent

Use this process when a voucher is lost, stolen, or refunded, or needs to be put on hold. Use Cancelled for a voucher that should never be used again, and Locked for a temporary hold.

  1. Open the Voucher record (s_c__Voucher__c) in Salesforce.
  2. Set Status to Cancelled or Locked.
  3. Click Save.

When a customer now applies the code at online checkout, the voucher is not applied and they see “Voucher is cancelled” or “Voucher is locked”. At the POS, the voucher lookup shows Status as Cancelled or Locked and the payment buttons stay disabled. Each rejected attempt adds a failed redeem entry to the Voucher Logs related list with the reason wrong status. To make a locked voucher spendable again, set Status back to Active.

Voucher redemption logging

StoreConnect automatically creates a Voucher Log record in Salesforce for every voucher event — including redemptions, failed attempts, activations, cancellations, and balance checks. Each log entry captures the event type, date and time, whether it succeeded, and a failure reason if applicable.

To view the log for a voucher:

  1. Open the Voucher record in Salesforce.
  2. Navigate to the Voucher Logs related list.

Voucher Log records are synced to Salesforce and are read-only. They are useful for investigating disputed redemptions or auditing voucher activity.

Resend voucher emails

Voucher emails are triggered at voucher creation, and can be manually resent later. If a voucher was not received electronically, make sure you check the recipients email address.

  1. Open the Voucher record in Salesforce.
  2. Verify the correct recipient email address.
  3. Check the Resend Email checkbox.
  4. Click Save. The email is resent.

To verify email delivery check email logs or contact the customer.

Was this article helpful?

Was this article helpful?