v2/loyalties API. In the dashboard, you manage the loyalty model in a new section called Loyalty hub.
For definitions of the individual components — point wallets, earning rules, tier structures, benefits, and rewards — see Loyalty key concepts.
New loyalty: Roadmap
The new loyalty program model – loyalty v2 – is rolled out over several phases.1
Initial phase
You’re here!Loyalty v2 is enabled for everyone. New organizations and the existing organizations which don’t use the legacy loyalty can use only the new loyalty solution.The Loyalty v2 API is available for production integrations during the initial phase. Voucherify avoids breaking changes to published contracts whenever possible. Some endpoint pages may still be marked as “work in progress documentation”. Voucherify may still improve the API and the Loyalty hub UI. Follow the release notes and contact your Technical Account Manager for change notifications that affect your integration.If you use or used the legacy loyalty, you can still continue to do so. However, Voucherify team will contact you with the details regarding future migration to the new solution.
Legacy loyalty maintenanceThe legacy loyalty will be eventually sunset. As a result, it’s not going to be further developed. Only critical issues will be fixed.
2
Expansion
We continue to add new features and API endpoints to the new loyalty solution. Also, the developers improve the overall loyalty v2 and fix the issues found.Planned features:
- Additional customization for each tier level and guardrails.
- Partial refund handling.
- Support for household cards.
- Advanced analytics.
3
Legacy loyalty migration
If you use the legacy loyalty, you’ll have to prepare for the migration to the new loyalty solution. You’ll need to recreate your integration of the loyalty system to use the new API.
4
Final sunset of legacy loyalty
Once everyone migrates to the new loyalty solution, the legacy loyalty is turned off.The new loyalty solution becomes the only loyalty system in Voucherify.
What changes in loyalty
The greatest change in the new loyalty program model is structural. It separates program setup into reusable components, headed by the support of multiple point wallets. In existing loyalty campaigns, most settings belong to one campaign. This makes each campaign more isolated. If you need a similar setup in another campaign, you often need to configure it again. Also, the members can earn points only on one card that’s governed by the campaign settings. In the new model, you connect components inside a loyalty program. This helps you reuse configuration, manage more complex setups, and create programs with many point wallets. Your loyalty program members can earn points on different loyalty cards whose behavior is defined by separate point wallets.How components work together
A loyalty program connects all components — point wallets, earning rules, rewards, tier structures, and benefits — into one customer experience. For definitions of each component, see Loyalty key concepts. A simplified structure looks like this:- The loyalty program contains the full setup.
- Point wallets store and manage points the members earn on their loyalty cards.
- Earning rules decide when members earn points or benefits.
- Rewards define what members can redeem.
- Tier structures group members into levels.
- Benefits grant points, material objects, or digital incentives automatically.
Differences from existing loyalty campaigns
The new loyalty program model expands what marketers can build compared with existing loyalty campaigns. Existing loyalty campaigns are more isolated. They use one point balance and keep most configuration inside one campaign. New loyalty programs use reusable components, multiple point wallets, wallet-specific reward prices, and more advanced tier behavior. Additionally, the new loyalty program model improves security and fraud prevention. For example, it offers guardrails like point spending and earning limits, earning rule trigger limits, reward purchase limits, and more.
Detailed configuration options are covered in the dedicated feature articles.
Program limits
Program limits define how large one loyalty program can be. Current limits:- Up to 10 point wallets in one loyalty program
- Up to 100 rewards in one loyalty program
- Up to 100 earning rules in one loyalty program
- One tier structure in one loyalty program
- Up to 10 tier levels in one tier structure
- Up to 100,000 members in one loyalty program
Why use the new loyalty program model
The new model is useful when a program needs more flexibility than one point balance and one isolated campaign setup:- Reusable configuration: Create components once and connect them where they are needed.
- Multiple point wallets: Manage different point balances or point currencies in one program.
- More control over points: Configure pending periods, expiration, earning limits, spending limits, refunds, and pay with points.
- Tier-specific behavior: Use tier mappings to adjust selected rules for different member levels.
- Larger program structures: Build complex loyalty setups without creating separate isolated campaigns for every variation.
- Improved experience: The new loyalty program model will be developed, while the legacy loyalty will be eventually sunset and only critical issues will be fixed.

