Zonal Voucher Manager Setup

Created 20 November 2025 • Updated 20 November 2025

Voucher Redemptions

Unique voucher codes generated through Voucher Manager or third-party systems can be redeemed at the point of sale, automatically triggering configured payments, product sales, discounts, or promotions. To enable the voucher feature, complete the setup on the following page.

Requirements

The following requirements are needed for voucher redemptions to be processed:

  • Configuration of Voucher Manager Completed

  • API accounts created for each site required

Setup

Head Office Site Master

POS Integration Configuration

Navigate to Base Data → Estate Structure → Site Settings → CLM

Follow these steps to configure the plugin information:

  1. From the Plugin drop down select TXD

  2. Enter the following required information

    • Username - enter username as created in Voucher Manager API user account

    • Password - enter password as created in Voucher Manager API user account

    • Base URL - enter the following URL

      • Production Accounts:

      • Staging Accounts: https://vouchers-but.znl-qa03.com/

  3. Click Save

Theme Settings

Voucher Buttons

Follow these steps to add voucher buttons:

Navigate to Theme Modelling → Themes / Shared Panels
  1. Select the required Theme Panel Design or Shared Panel where the buttons should be added

  2. From the Button Picker | Other Lists | iZone add the following buttons

    • Redeem TXD Voucher

      • Enables a POS operator to redeem voucher codes

    • Cancel TXD Voucher

      • Enables a the POS operator cancel the redemption of a single voucher code

    • Cancel All TXD Vouchers

      • Enables a POS operator to cancel all redeemed voucher codes in one action

    Zonal recommends to update the name of the buttons using the override text so that POS operators understand their usage
  3. Click Save

Local Panels for Trigger & Other Voucher Related Buttons

When voucher redemptions trigger a promotion or discount, the associated products that activate these rewards must be added to a theme panel design. This ensures that, during the redemption process, the point of sale terminal can automatically apply the relevant products or discounts to the order. If these products are not included in the theme panel, the transaction will fail.

Zonal recommends that the related buttons are added to a Local Panel of the Theme Panel Design, for more information on managing local panels click here

Further information on creating manually activated promotions can be found here, and additional details on adding trigger products that activate the promotion are available here.

Prefixes

For the point of sale terminal to recognise voucher codes and perform the appropriate actions when they are entered or scanned, the prefix groups must be updated to match the specified number of digits that make up the voucher prefix.

Prefix groups are added with the account type TXD

For more information on managing prefixes click here to view the prefix setup help guide.

Other Setup

Site Master Site

  • POS Integration - 1.52.0 or above installed with TXD Plugin

    Requests for POS Integration installation should be made to your Zonal Account Representative