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.
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 likePROMO-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?