Fall Product Update: MCP, Shopify Plus & deeper control ahead of BFCM
0
Days
0
Hours
0
Minutes
0
Seconds
See what's new
2025-09-24 12:00 am
2025-05-21 12:00 am
2025-03-14 12:00 am
2025-05-20 12:00 am
2025-04-22 12:00 am
2025-09-29 12:00 am
Product

Qualification API for smart promotion recommendations

Julia Gaj
May 8, 2025
  • With Qualification API, you send customer and order context, and it returns the applicable offers (standalone codes, unique-code campaigns, cart promo tiers) for that moment.
  • It’s built for real surfaces, not just checkout. Use cases called out include customer wallets, bundling/BOGO discovery, upsell prompts, and strikethrough pricing at SKU/product level.
Table of contents
Share it on Twitter
Share it on Facebook
Share it on LinkedIn

Searching for the best deals can be a challenging task for customers, given the vast number of online marketplaces, coupon websites, and available discounts. It often feels like looking for a needle in a haystack.

With over 90% of US customers considering discounts and promotions crucial in their purchase decisions, competition is fierce. Brands aiming to reach customers with the right promotions at the right time need to step up their game. This is where the Voucherify Qualification API and its new set of qualification scenarios come into play.

In this article, I will delve into how Voucherify's Qualification API improves discount recommendations. We'll explore how brands can utilize it to provide highly targeted and personalized offers to customers.

How do discount recommendations work?

Discount recommendations rely on analyzing the order and customer context to provide relevant suggestions for available discounts or promotions. Recognizing the growing need for personalization and improved promotion experiences, we have developed a new mechanism to offer intelligent discounts.

This mechanism enables you to dynamically display relevant campaigns to achieve next-level promotion experiences, such as:

  • Digital wallets – with lightning-fast qualification and GET APIs, you can build customer cockpits, where your audience can access information like loyalty points balance, current promotions and discounts, exclusive vouchers, and referral programs.
  • Product bundling – by analyzing cart content, Voucherify can quickly display relevant bundling campaigns and BOGO offers to increase AOV.
  • Upselling – by informing customers about potential savings right around the corner, you get an opportunity to encourage bigger purchases.
  • Strikethrough pricing – the qualification functionality allows you to display product- and SKU-based discounts at the catalog or product page details levels.
Visual of discount recommendations

What is the Voucherify Qualification API and how does it work?

The new Voucherify qualification is a specially designed API endpoint that returns available offers (generic promo codes, unique coupon campaigns, and cart promotion tiers) based on the product and customer contexts. This is an update to legacy recommendation methods – with better performance and new scenarios to choose from.

1. No limit on returned redeemables

The absence of limitations on returned redeemables through the new Qualification API allows you to obtain more information with a lesser amount of effort. This way, you can display all the available discounts to your customers with just one API call, optizming the number of API calls you need which directly impacts your subscription plan.

The Voucherify Qualifications API request will return to you all redeemables in batches of up to 50 redeemables. To get the next batch of redeemables, you need to use the starting_after cursor. See docs to learn more.

2. Improved user experience

With the new qualification API, you can provide faster qualification results to customers, leveraging Voucherify to create super responsive digital wallets where customers can find available promotions and coupons. This enables quicker access to rewards and benefits.

Given the shopping context, Voucherify offers your brand a possibility to provide your customers with smart discounts at the cart level. What’s more, the new qualification API improves the overall customer experience by streamlining the up- and cross-selling campaigns.

3. New qualification scenarios

The new qualification API allows businesses to introduce unique qualification scenarios and filter campaigns based on various contexts – from customer segment membership to products they currently have in the cart.

How Qualification API enhances discount recommendations?

Unlocking the full potential of personalized discounts and product recommendations, the upgraded version of Voucherify Qualification API offers a list of new scenarios and use cases.

All it takes is sharing the shopping context with Voucherify to check whether any offers are available and can be suggested.

Here is a sample API request you can use:

{  "customer": 
{    "id": 
"{{customer_id}}"  },  
"order": {   
"amount": {{order_amount}}  },  
"scenario": "{{qualification_scenario}}"}

1. All redeemables available

In this qualification scenario, the API request retrieves all available offers for a specific customer. It provides a comprehensive view of all the vouchers, campaigns, and cart promotion tiers that the customer is eligible for by checking the offers against customer and order limits.

What is checked?

This scenario checks both the customer and order eligibility.

What is returned?

This endpoint return all possible redeemables – standalone promo codes, unique codes campaigns & cart promotion levels.

2. Customer wallet

In this qualification scenario, the API retrieves vouchers that are specifically assigned to the customer profile. Similarly to the ALL scenario, this scenario checks offers against customer and order context and additionally retrieved only assigned incentives.

This scenario is suitable for building custom dashboards to display all owned and available incentives to customers.

What is checked?

This scenario checks both the customer and order eligibility.

What is returned?

This endpoint returns assigned promo codes to the individual user.

3. Audience-based redeemables

This scenario returns all offers available for the customer. This scenario validates the rules based on the customer profile only, such as customer attributes and segment membership. This can be used to show the customer what promotions are available to them. For instance, you can run a location-specific campaigns targeted at precise geofences.

What is checked?

This scenario checks only the customer context, skipping order information.

What is returned?

This endpoint return all possible redeemables – standalone promo codes, unique codes campaigns & cart promotion levels.

4. Product-based redeemables

In this qualification scenario, the API request retrieves all offers applicable to specific products or if the product is used in the validation rule. This scenarios will check the order context and return any applicable promotions

This way, you can provide targeted promotions and incentives for certain products in the customer's cart, increasing AOVs.

What is checked?

This scenario checks only the order context (products), skipping customer information.

What is returned?

This endpoint return all possible redeemables – standalone promo codes, unique codes campaigns & cart promotion levels.

5. Product-discount redeemables

This scenarios is a sub-type of the previous type. This version focuses solely on returning all promotions available for the products when a discount is defined to be applied to the specific item. As such, is it a perfect choice for displaying discounted product prices right in the cart and checkout views.

What is checked?

This scenario checks only the order context (products), skipping customer information.

What is returned?

This endpoint return all possible redeemables – standalone promo codes, unique codes campaigns & cart promotion levels.

6. Redeemables based on promotion stacks

In this qualification scenario, the API request returns the promotion stacks that are applicable to the given customer and order context. Promotion stacking in Voucherify is a set of promotion tiers that are redeemed as a single redeemable.

By returning the applicable promotion stacks, you can enhance the customer's experience by offering a bundled or layered set of benefits, resulting in increased customer satisfaction and potentially higher average order value.

What is checked?

This scenario checks both the customer and order eligibility.

What is returned?

This endpoint returns all available promotion tiers (levels).

7. Customer and item-specific redeemables

In this case, the scenario identifies promotions that are accessible to a particular customer and products in the cart when:

  • Discount is applicable to the specific item – in this case, if a discount is applicable to a specific product, the API will retrieve promotions that provide discounts for that product.
  • Item is required in validation rules – this scenario covers situations where a certain product is required to meet the validation rules of a promotion.

So both scenarios check the customer and order context but in the first case the product discount must be applied to a specific item in the cart, and in the second case the specific order item needs to be required by the validation rule.

How to use Qualification API?

Imagine a situation where your customer has $50 worth of products in their shopping cart. Let’s say you want to use the customer wallet scenario to examine the contents of their cart and then align them with the promotions accessible in their profile.

Depending on your location, you can use one of the following endpoints:

  • Europe (default) https://api.voucherify.io/v1/qualifications
  • United States – https://us1.api.voucherify.io/v1/qualifications
  • Asia (Singapore) – https://as1.api.voucherify.io/v1/qualifications

Voucherify will then return all the redeemables available to the customer that you can display on your front-end at the shopping cart level or anywhere else in the user journey.

In the case of our test customer, the response looks as follows, which means that our customer has a couple of promotions assigned to their profile to choose from. This means, you can easily showcase them on your front-end, displaying them, for instance, next to the shopping cart, ensuring a positive user experience.

 FAQs

What is Voucherify?
Voucherify is a promotion & loyalty platform designed for enterprises that need scalability and customization. Voucherify helps world-leading brands create, manage, and track personalized promotions across multiple channels – whether it’s discounts, vouchers, loyalty programs, or referrals.

With its powerful API-first architecture, Voucherify can be quickly integrated into any existing systems and scaled effortlessly as the business grows. It's perfect for brands that want to take full control of their promotional strategies, without the limitations of cookie-cutter solutions and ready plug-ins.

When should I use Qualification API vs validating a promo code at checkout?

Use Qualification when you want to recommend or display eligible offers proactively (wallet, cart suggestions, PDP strikethrough, upsell prompts). Use validation/redemption when you need the final, enforceable decision at checkout or POS.

Can Qualification API return “everything this customer can use” in one call?

It can return all eligible redeemables for a scenario in one request, with pagination in batches (up to 50 per page) using a cursor when there’s more.

Are you optimizing your incentives or just running them?