One-time voucher codes

Automatically generated, single-use voucher codes that are validated in real time via API. Ideal for integrated POS or e-commerce systems with secure, centralised reward handling.

One-time voucher codes are automatically generated by the Loyalty Engine when a user redeems a reward configured with this code type. Each code is unique, tracked per user, and validated in real time by your POS, e-commerce platform, or any integrated system using the Validate voucher code API endpoint.

When to use one-time voucher codes

This code type is ideal for integrated setups where your POS or e-commerce system can query the WLL API in real time to validate codes. It ensures tight control, security, and traceability.

Advantages of one-time voucher codes
Disadvantages of one-time voucher codes
  • Real-time validation: POS or external systems can check the authenticity of each voucher at the point of redemption.

  • Secure and unique: Each code is single-use and tied to an individual user.

  • Centralised reward management: No need to distribute codes in advance—vouchers are issued and tracked centrally from the Loyalty Console.

  • Requires a real-time system integration with the WLL API.

  • Codes cannot be pre-defined or customised individually—if you need to upload your own codes, use a code pool instead.


Configuration options

Incentive configuration

Incentive configuration defines the benefit a reward provides—such as a discount or price override—and communicates that logic to external systems, like point-of-sale (POS) platforms, when a one-time voucher code is validated.

See Incentives for more information.

Custom code format

In the redemption settings for a one-time voucher reward, you can define a format that wraps around the generated portion. Use {code} as a placeholder.

Example:

PROMO-{code} → Might generate a code like PROMO-7HD3XP


One-time voucher code FAQs

Can I view the one-time voucher code given to a user in the Loyalty Console?

Not in the PURCHASED_REWARD event. You can find the specific code in the related REDEEMED_VOUCHER event.

Can I choose or upload my own codes?

No. One-time codes are generated by the Loyalty Engine. If you want to customise the codes given out and still make use of the Loyalty Engine's code validation feature, you can use a Voucher code pools in combination with the Validate voucher API endpoint.

Last updated

Was this helpful?