Voucher code pools

Distribute pre-generated codes using voucher code pools. Great for POS or partner fulfilment where codes are known and managed outside the Loyalty Engine.

This article describes distributing voucher codes to users from a voucher code pool as part of reward redemption.

It should not be confused with promotional code pools included with the Promo Codes module, which allows users to input product or promotional codes themselves to trigger reactors.

Voucher code pools let you upload a pre-defined list of codes into a single reward. When a user redeems that reward, they’re given one code from the pool. That code is then marked as used and won’t be distributed again.

When to use code pool vouchers

Code pool vouchers are ideal when:

• You’ve generated a batch of codes in your own POS or e-commerce system.

• You’ve been supplied codes from a partner or third-party service.

• You want each code to be single-use, but don’t want to integrate fully with the Loyalty Engine.

Each code in the pool typically maps to a known discount or offer in the system that will redeem it (e.g., £10 off at POS, a discount on a partner website, etc.). That system—whether it’s a POS terminal or an external partner—must know what each code is worth, as the Loyalty Engine does not attach incentive logic to codes from a pool.

You don’t need to integrate your POS to use this method. However, if you do want to integrate, you can still use the Validate voucher code API endpoint to verify codes from the pool at the point of redemption.

This setup offers a flexible, low-integration approach to reward validation, while still giving you the benefits of control, traceability, and single-use security.

Advantages of voucher code pools	Disadvantages of voucher code pools
Prevents duplicate distribution and reduces risk of fraud Works well with batch exports from your POS or e-commerce system Easier to implement than one-time code integrations	Code pool must be kept in sync with your POS/e-commerce platform to ensure codes are recognised at point of redemption

---

Managing voucher code pools

Creating rewards with a voucher code pool

• Select Code Pool Voucher as the redemption type when creating your reward.

• Paste your comma-separated list of voucher codes into the Code Pool field.

• (Optional) Set a Notification Threshold to receive an email alert when the pool is running low.

Refilling your code pool

• Edit the reward and navigate to the Redemption tab.

• Add more codes to the existing pool.

When a code pool runs out of codes

• API calls to purchase the reward will return an error if the pool is exhausted.

When calling the reward list endpoint:

• With an administrator access token, rewards with an empty code pool will be returned.

• With a user access token, rewards with an empty code pool will not be returned.

If you're using one of the WLL interface products, the behaviour depends on your implementation:

• Loyalty Microsite (embedded): Shown

• Loyalty Microsite (standalone): Hidden

• Loyalty Mobile App: Hidden

---

Voucher code pool FAQs

Can I view the issued code for a specific user?

Yes. The issued code appears in the corresponding REDEEMED_VOUCHER event.

Can the Loyalty Console generate codes for me?

No. You must upload your own codes. You can use an online code generator - like this one - to create a batch (e.g. set suffix to comma, then paste into the code pool).

Can a code pool contain duplicate codes?

Yes. Simply repeat the code as needed, e.g. SAVE10, SAVE10, SAVE10.

Can I use the code pool to limit reward purchases?

Yes. The number of codes in the pool determines how many times the reward can be redeemed.

If you don’t need unique codes, repeat the same one multiple times.

If no code is required, you can toggle Hide Code to true.