Qualification – Checking Eligibility

Overview

Sometimes you want to show a customer all the coupons they’re eligible for — taking into account their attributes as well as the current content of their cart.

Voucherify's Qualifications API helps recommend applicable promotions and coupons in the given customer and order context with filtering options based on campaign category and hierarchy.

The qualifications API can be applied (among others) for:

  • Upsell scenarios - showing the customers the discounts available for the customer, encouraging the customer to adjust the cart to conform to the available promotions.
  • Customer wallet - providing a list of vouchers the customer was assigned/received (in Voucherify's terms, a voucher was published to the customer) in the past that can be used for the current cart.
  • Strike through price - showing new prices for a list of products after a promotional discount is applied.
  • Showing coupons available for given products in a product catalog

Product Catalog Coupon

API Endpoints

There are two dedicated API Endpoints for checking eligibility:

EndpointLink
POST /v1/qualificationsCheck eligibility using the server-side endpoint.
POST /client/v1/qualificationsCheck eligibility using the client-side endpoint.

You can find a description of the qualification object schema in the data model description here.

Scenarios

To specify the types of promotions and codes that you would like to reveal to your customers, we introduced the option of including a scenario. A scenario defines the type of content that you would like to return from all the available campaigns and standalone codes that you've created in Voucherify.

ScenarioPossible Use Case
ALLReturns all redeemables available for the customer in one API request.
CUSTOMER_WALLETreturns vouchers applicable to the customer’s cart based on the vouchers assigned to the customer’s profile.
AUDIENCE_ONLYReturns all vouchers, promotion tiers, and campaigns available to the customer. Voucherify validates the rules based on the customer profile only.
PRODUCTSReturns all promotions available for the products (when a discount is defined to be applied to the item or when the item is required in the validation rule).
PRODUCTS_DISCOUNTReturns all promotions available for products when a discount is defined as applicable to specific item(s).
PROMOTION_STACKSReturns the applicable promotion stacks.
PRODUCTS_BY_CUSTOMERReturns all promotions available for a customer for the products (when a discount is defined to be applied to the item or when the item is required in the validation rule).
PRODUCTS_DISCOUNT_BY_CUSTOMERReturns all promotions available for a customer for products when a discount is defined as applicable to specific item(s).

In the request, you can add options to configure the parameters returned in the response, e.g. filters for types of redeemables or sorting rules like BEST_DEAL or LEAST_DEAL.

Use Cases

To show a couple of the use cases that are possible with the qualifications API, we'll show it using the following scenarios. Depending on the different scenario, we'll send a slightly different API call and the results will be returned in the context of the scenario.

Customer profile

The customer is assigned 2 vouchers.

CampaignDetails
Gift card campaignThe gift voucher maIxGd5r can be used by the owner of the code only
Discount campaign
camp_f78wOLL9cE2WCSdtliT0UIh0
Voucher code vm3HkNF2 from a 10% discount for BOSCH products redeemable by the owners of the code.

Promotions

The use case assumes there are also two promotions available.

  1. 10% for everyone on entire order
  2. 20% for Digital books for VIP customers.

We'll send a qualification API call with several different settings and explain the results.


Case 1 - Logged in vs non-logged in customers

  • If the customer is not logged in, the customer will see only one promotion - the 10% for everyone. | "scenario": "ALL"
  • If they are logged in, they will see two promotion tiers and all the vouchers they have on their hand. | "scenario": "ALL"

Not Logged in

Since we cannot identify the customer, we can not show redeemables that are out of scope, i.e. that are not dependent on the customer profile.

Promotions Available for non-logged in customers

{
    "scenario": "ALL",
    "order": {
        "items": [
            {
                "source_id": "bosch_product_1",
                "quantity": "1",
                "price": 10000,
                "related_object": "product",
                "product": {
                    "name": "BOSCH GDR 120-LI Cordless Impact Driver / Wrench"
                }
            },
            {
                "source_id": "digital_book",
                "quantity": "1",
                "price": 1500,
                "related_object": "product",
                "product": {
                    "name": "Digital Book"
                }
            }
        ]
    },
    "options": {
        "expand": [
            "redeemable"
        ]
    }
}
{
    "redeemables": {
        "object": "list",
        "data_ref": "data",
        "data": [
            {
                "id": "promo_mIVcCKyEOu47LPDjXn3rTUC1",
                "object": "promotion_tier",
                "created_at": "2023-09-18T11:52:08.234Z",
                "result": {
                    "discount": {
                        "type": "PERCENT",
                        "effect": "APPLY_TO_ORDER",
                        "percent_off": 10,
                        "is_dynamic": false
                    }
                },
                "order": {
                    "amount": 11500,
                    "discount_amount": 1150,
                    "total_discount_amount": 1150,
                    "total_amount": 10350,
                    "applied_discount_amount": 1150,
                    "total_applied_discount_amount": 1150,
                    "items": [
                        {
                            "object": "order_item",
                            "source_id": "bosch_product_1",
                            "related_object": "product",
                            "quantity": 1,
                            "amount": 10000,
                            "price": 10000,
                            "subtotal_amount": 10000,
                            "product": {
                                "name": "BOSCH GDR 120-LI Cordless Impact Driver / Wrench"
                            }
                        },
                        {
                            "object": "order_item",
                            "source_id": "digital_book",
                            "related_object": "product",
                            "quantity": 1,
                            "amount": 1500,
                            "price": 1500,
                            "subtotal_amount": 1500,
                            "product": {
                                "name": "Digital Book"
                            }
                        }
                    ],
                    "metadata": {},
                    "customer_id": null,
                    "referrer_id": null,
                    "object": "order"
                },
                "applicable_to": {
                    "data": [],
                    "total": 0,
                    "data_ref": "data",
                    "object": "list"
                },
                "inapplicable_to": {
                    "data": [],
                    "total": 0,
                    "data_ref": "data",
                    "object": "list"
                },
                "metadata": {},
                "name": "10% off",
                "banner": "10% off",
                "campaign_id": "camp_orPbvjZ9OSmaZzRvj5gjT1kK",
                "campaign_name": "Promotion - % off"
            }
        ],
        "total": 1,
        "has_more": false
    },
    "order": {
        "items": [
            {
                "object": "order_item",
                "source_id": "bosch_product_1",
                "related_object": "product",
                "quantity": 1,
                "price": 10000,
                "product": {
                    "name": "BOSCH GDR 120-LI Cordless Impact Driver / Wrench"
                }
            },
            {
                "object": "order_item",
                "source_id": "digital_book",
                "related_object": "product",
                "quantity": 1,
                "price": 1500,
                "product": {
                    "name": "Digital Book"
                }
            }
        ],
        "metadata": {},
        "customer_id": null,
        "referrer_id": null,
        "object": "order"
    },
    "stacking_rules": {
        "redeemables_limit": 30,
        "applicable_redeemables_limit": 5
    }
}

Logged in

Once we know who the customer is, the Qualifications API can now return the promotions that are customer specific and the voucher codes the customer owns and that can be used right now.

This would then return the following:

CampaignDetails
Gift card campaignThe gift voucher maIxGd5r can be used by the owner of the code only
Discount campaign
10% discount for BOSCH products
Voucher code vm3HkNF2 from a 10% discount for BOSCH products redeemable by the owners of the code
10% for everyone on entire orderThe promotion is available for anyone and gives a 10% discount
20% for Digital books for VIP customersThe promotion is available to customers who are VIP customers and is applicable to digital books only

Offers Available for logged in customers

{
    "scenario": "ALL",
    "customer": {
        "source_id": "GUID_123_john_wayne",
        "name": "John Wayne",
        "metadata": {
            "tier": "VIP"
        }
    },
    "order": {
        "items": [
            {
                "source_id": "bosch_product_1",
                "quantity": "1",
                "price": 10000,
                "related_object": "product",
                "product": {
                    "name": "BOSCH GDR 120-LI Cordless Impact Driver / Wrench"
                }
            },
            {
                "source_id": "digital_book",
                "quantity": "1",
                "price": 1500,
                "related_object": "product",
                "product": {
                    "name": "Digital Book"
                }
            }
        ]
    },
    "options": {
        "expand": [
            "redeemable"
        ]
    }
}
{
    "redeemables": {
        "object": "list",
        "data_ref": "data",
        "data": [
            {
                "id": "promo_mIVcCKyEOu47LPDjXn3rTUC1",
                "object": "promotion_tier",
                "created_at": "2023-09-18T11:52:08.234Z",
                "result": {
                    "discount": {
                        "type": "PERCENT",
                        "effect": "APPLY_TO_ORDER",
                        "percent_off": 10,
                        "is_dynamic": false
                    }
                },
                "order": {
                    "amount": 11500,
                    "discount_amount": 1150,
                    "total_discount_amount": 1150,
                    "total_amount": 10350,
                    "applied_discount_amount": 1150,
                    "total_applied_discount_amount": 1150,
                    "items": [
                        {
                            "object": "order_item",
                            "source_id": "bosch_product_1",
                            "related_object": "product",
                            "quantity": 1,
                            "amount": 10000,
                            "price": 10000,
                            "subtotal_amount": 10000,
                            "product": {
                                "name": "BOSCH GDR 120-LI Cordless Impact Driver / Wrench"
                            }
                        },
                        {
                            "object": "order_item",
                            "source_id": "digital_book",
                            "related_object": "product",
                            "quantity": 1,
                            "amount": 1500,
                            "price": 1500,
                            "subtotal_amount": 1500,
                            "product": {
                                "name": "Digital Book"
                            }
                        }
                    ],
                    "metadata": {},
                    "customer_id": null,
                    "referrer_id": null,
                    "object": "order"
                },
                "applicable_to": {
                    "data": [],
                    "total": 0,
                    "data_ref": "data",
                    "object": "list"
                },
                "inapplicable_to": {
                    "data": [],
                    "total": 0,
                    "data_ref": "data",
                    "object": "list"
                },
                "metadata": {},
                "name": "10% off",
                "banner": "10% off",
                "campaign_id": "camp_orPbvjZ9OSmaZzRvj5gjT1kK",
                "campaign_name": "Promotion - % off"
            },
            {
                "id": "maIxGd5r",
                "object": "voucher",
                "created_at": "2023-09-15T13:00:36.391Z",
                "result": {
                    "gift": {
                        "credits": 2500
                    }
                },
                "order": {
                    "amount": 11500,
                    "discount_amount": 2500,
                    "total_discount_amount": 2500,
                    "total_amount": 9000,
                    "applied_discount_amount": 2500,
                    "total_applied_discount_amount": 2500,
                    "items": [
                        {
                            "object": "order_item",
                            "source_id": "bosch_product_1",
                            "related_object": "product",
                            "quantity": 1,
                            "amount": 10000,
                            "price": 10000,
                            "subtotal_amount": 10000,
                            "product": {
                                "name": "BOSCH GDR 120-LI Cordless Impact Driver / Wrench"
                            }
                        },
                        {
                            "object": "order_item",
                            "source_id": "digital_book",
                            "related_object": "product",
                            "quantity": 1,
                            "amount": 1500,
                            "price": 1500,
                            "subtotal_amount": 1500,
                            "product": {
                                "name": "Digital Book"
                            }
                        }
                    ],
                    "metadata": {},
                    "customer_id": null,
                    "referrer_id": null,
                    "object": "order"
                },
                "applicable_to": {
                    "data": [],
                    "total": 0,
                    "data_ref": "data",
                    "object": "list"
                },
                "inapplicable_to": {
                    "data": [],
                    "total": 0,
                    "data_ref": "data",
                    "object": "list"
                },
                "metadata": {},
                "campaign_id": "camp_blYBZY5V5KQ3PuLfzs0DmuX0",
                "campaign_name": "Gift Card Campaign Fall 2023"
            },
            {
                "id": "vm3HkNF2",
                "object": "voucher",
                "created_at": "2023-09-15T12:59:34.860Z",
                "result": {
                    "discount": {
                        "type": "PERCENT",
                        "effect": "APPLY_TO_ITEMS",
                        "percent_off": 10,
                        "is_dynamic": false
                    }
                },
                "order": {
                    "amount": 11500,
                    "items_discount_amount": 1000,
                    "total_discount_amount": 1000,
                    "total_amount": 10500,
                    "items_applied_discount_amount": 1000,
                    "total_applied_discount_amount": 1000,
                    "items": [
                        {
                            "object": "order_item",
                            "source_id": "bosch_product_1",
                            "related_object": "product",
                            "quantity": 1,
                            "amount": 10000,
                            "discount_amount": 1000,
                            "applied_discount_amount": 1000,
                            "price": 10000,
                            "subtotal_amount": 9000,
                            "product": {
                                "name": "BOSCH GDR 120-LI Cordless Impact Driver / Wrench"
                            }
                        },
                        {
                            "object": "order_item",
                            "source_id": "digital_book",
                            "related_object": "product",
                            "quantity": 1,
                            "amount": 1500,
                            "price": 1500,
                            "subtotal_amount": 1500,
                            "product": {
                                "name": "Digital Book"
                            }
                        }
                    ],
                    "metadata": {},
                    "customer_id": null,
                    "referrer_id": null,
                    "object": "order"
                },
                "applicable_to": {
                    "data": [
                        {
                            "object": "products_collection",
                            "id": "pc_kHDQEBDVn8G04oxvgzRf5et9",
                            "strict": false,
                            "effect": "APPLY_TO_EVERY",
                            "order_item_indices": [
                                0
                            ]
                        },
                        {
                            "object": "product",
                            "id": "bosch_product_1",
                            "source_id": "bosch_product_1",
                            "strict": true,
                            "effect": "APPLY_TO_EVERY",
                            "order_item_indices": [
                                0
                            ]
                        }
                    ],
                    "total": 2,
                    "data_ref": "data",
                    "object": "list"
                },
                "inapplicable_to": {
                    "data": [],
                    "total": 0,
                    "data_ref": "data",
                    "object": "list"
                },
                "metadata": {},
                "campaign_id": "camp_f78wOLL9cE2WCSdtliT0UIh0",
                "campaign_name": "10% discount for BOSCH products"
            },
            {
                "id": "promo_QwH9khhoiNAthPykdnpAcpAi",
                "object": "promotion_tier",
                "created_at": "2023-09-15T12:48:11.443Z",
                "result": {
                    "discount": {
                        "type": "PERCENT",
                        "effect": "APPLY_TO_ITEMS",
                        "percent_off": 20,
                        "is_dynamic": false
                    }
                },
                "order": {
                    "amount": 11500,
                    "items_discount_amount": 300,
                    "total_discount_amount": 300,
                    "total_amount": 11200,
                    "items_applied_discount_amount": 300,
                    "total_applied_discount_amount": 300,
                    "items": [
                        {
                            "object": "order_item",
                            "source_id": "bosch_product_1",
                            "related_object": "product",
                            "quantity": 1,
                            "amount": 10000,
                            "price": 10000,
                            "subtotal_amount": 10000,
                            "product": {
                                "name": "BOSCH GDR 120-LI Cordless Impact Driver / Wrench"
                            }
                        },
                        {
                            "object": "order_item",
                            "source_id": "digital_book",
                            "related_object": "product",
                            "quantity": 1,
                            "amount": 1500,
                            "discount_amount": 300,
                            "applied_discount_amount": 300,
                            "price": 1500,
                            "subtotal_amount": 1200,
                            "product": {
                                "name": "Digital Book"
                            }
                        }
                    ],
                    "metadata": {},
                    "customer_id": null,
                    "referrer_id": null,
                    "object": "order"
                },
                "applicable_to": {
                    "data": [
                        {
                            "object": "products_collection",
                            "id": "pc_KM2mzWPu77CFvZX2wWBqVKVp",
                            "strict": false,
                            "effect": "APPLY_TO_EVERY",
                            "order_item_indices": [
                                1
                            ]
                        },
                        {
                            "object": "product",
                            "id": "digital_book",
                            "source_id": "digital_book",
                            "strict": true,
                            "effect": "APPLY_TO_EVERY",
                            "order_item_indices": [
                                1
                            ]
                        }
                    ],
                    "total": 2,
                    "data_ref": "data",
                    "object": "list"
                },
                "inapplicable_to": {
                    "data": [],
                    "total": 0,
                    "data_ref": "data",
                    "object": "list"
                },
                "metadata": {},
                "name": "20% off Digital books for VIP customers",
                "banner": "20% off Digital books for VIP customers",
                "campaign_id": "camp_orPbvjZ9OSmaZzRvj5gjT1kK",
                "campaign_name": "Promotion - % off"
            }
        ],
        "total": 4,
        "has_more": false
    },
    "tracking_id": "track_wBhrnKJfwZMTuOpQ+uItfJXOJ6STUymy",
    "order": {
        "items": [
            {
                "object": "order_item",
                "source_id": "bosch_product_1",
                "related_object": "product",
                "quantity": 1,
                "price": 10000,
                "product": {
                    "name": "BOSCH GDR 120-LI Cordless Impact Driver / Wrench"
                }
            },
            {
                "object": "order_item",
                "source_id": "digital_book",
                "related_object": "product",
                "quantity": 1,
                "price": 1500,
                "product": {
                    "name": "Digital Book"
                }
            }
        ],
        "metadata": {},
        "customer_id": null,
        "referrer_id": null,
        "object": "order"
    },
    "stacking_rules": {
        "redeemables_limit": 30,
        "applicable_redeemables_limit": 5
    }
}

Case 1 Summary

The qualification request returned all of the possible vouchers and redeemables the customer could use right now. You can use the qualifications API request to enhance the customer experience by:

  • Showing the current promotions available for everyone on the home page
  • Showing a different set of promotions available for a specific customer on the home page
  • Present the list of available discounts during the customer's checkout

All of these scenarios require one API request per attempt.

📘

Audience only

This scenario considered the promotions, voucher codes, and voucher campaigns available for the customer to be used on the current cart. You can experiment with the "Audience Only" scenario that will return all of the discounts based on the customer profile alone, enabling you to create upsell scenarios.


Case 2 - Vouchers assigned to customer

We'll send the same request, but with a different scenario setting.

Only the voucher codes assigned to the customer will be returned. "scenario": "CUSTOMER_WALLET"

Product Catalog Coupon

{
    "scenario": "CUSTOMER_WALLET",
    "customer": {
        "source_id": "GUID_123_john_wayne",
        "name": "John Wayne",
        "metadata": {
            "tier": "VIP"
        }
    },
    "order": {
        "items": [
            {
                "source_id": "bosch_product_1",
                "quantity": "1",
                "price": 10000,
                "related_object": "product",
                "product": {
                    "name": "BOSCH GDR 120-LI Cordless Impact Driver / Wrench"
                }
            },
            {
                "source_id": "digital_book",
                "quantity": "1",
                "price": 1500,
                "related_object": "product",
                "product": {
                    "name": "Digital Book"
                }
            }
        ]
    },
    "options": {
        "expand": [
            "redeemable"
        ]
    }
}
{
    "redeemables": {
        "object": "list",
        "data_ref": "data",
        "data": [
            {
                "id": "maIxGd5r",
                "object": "voucher",
                "created_at": "2023-09-15T13:00:36.391Z",
                "result": {
                    "gift": {
                        "credits": 2500
                    }
                },
                "order": {
                    "amount": 11500,
                    "discount_amount": 2500,
                    "total_discount_amount": 2500,
                    "total_amount": 9000,
                    "applied_discount_amount": 2500,
                    "total_applied_discount_amount": 2500,
                    "items": [
                        {
                            "object": "order_item",
                            "source_id": "bosch_product_1",
                            "related_object": "product",
                            "quantity": 1,
                            "amount": 10000,
                            "price": 10000,
                            "subtotal_amount": 10000,
                            "product": {
                                "name": "BOSCH GDR 120-LI Cordless Impact Driver / Wrench"
                            }
                        },
                        {
                            "object": "order_item",
                            "source_id": "digital_book",
                            "related_object": "product",
                            "quantity": 1,
                            "amount": 1500,
                            "price": 1500,
                            "subtotal_amount": 1500,
                            "product": {
                                "name": "Digital Book"
                            }
                        }
                    ],
                    "metadata": {},
                    "customer_id": null,
                    "referrer_id": null,
                    "object": "order"
                },
                "applicable_to": {
                    "data": [],
                    "total": 0,
                    "data_ref": "data",
                    "object": "list"
                },
                "inapplicable_to": {
                    "data": [],
                    "total": 0,
                    "data_ref": "data",
                    "object": "list"
                },
                "metadata": {},
                "campaign_id": "camp_blYBZY5V5KQ3PuLfzs0DmuX0",
                "campaign_name": "Gift Card Campaign Fall 2023"
            },
            {
                "id": "vm3HkNF2",
                "object": "voucher",
                "created_at": "2023-09-15T12:59:34.860Z",
                "result": {
                    "discount": {
                        "type": "PERCENT",
                        "effect": "APPLY_TO_ITEMS",
                        "percent_off": 10,
                        "is_dynamic": false
                    }
                },
                "order": {
                    "amount": 11500,
                    "items_discount_amount": 1000,
                    "total_discount_amount": 1000,
                    "total_amount": 10500,
                    "items_applied_discount_amount": 1000,
                    "total_applied_discount_amount": 1000,
                    "items": [
                        {
                            "object": "order_item",
                            "source_id": "bosch_product_1",
                            "related_object": "product",
                            "quantity": 1,
                            "amount": 10000,
                            "discount_amount": 1000,
                            "applied_discount_amount": 1000,
                            "price": 10000,
                            "subtotal_amount": 9000,
                            "product": {
                                "name": "BOSCH GDR 120-LI Cordless Impact Driver / Wrench"
                            }
                        },
                        {
                            "object": "order_item",
                            "source_id": "digital_book",
                            "related_object": "product",
                            "quantity": 1,
                            "amount": 1500,
                            "price": 1500,
                            "subtotal_amount": 1500,
                            "product": {
                                "name": "Digital Book"
                            }
                        }
                    ],
                    "metadata": {},
                    "customer_id": null,
                    "referrer_id": null,
                    "object": "order"
                },
                "applicable_to": {
                    "data": [
                        {
                            "object": "products_collection",
                            "id": "pc_kHDQEBDVn8G04oxvgzRf5et9",
                            "strict": false,
                            "effect": "APPLY_TO_EVERY",
                            "order_item_indices": [
                                0
                            ]
                        },
                        {
                            "object": "product",
                            "id": "bosch_product_1",
                            "source_id": "bosch_product_1",
                            "strict": true,
                            "effect": "APPLY_TO_EVERY",
                            "order_item_indices": [
                                0
                            ]
                        }
                    ],
                    "total": 2,
                    "data_ref": "data",
                    "object": "list"
                },
                "inapplicable_to": {
                    "data": [],
                    "total": 0,
                    "data_ref": "data",
                    "object": "list"
                },
                "metadata": {},
                "campaign_id": "camp_f78wOLL9cE2WCSdtliT0UIh0",
                "campaign_name": "10% discount for BOSCH products"
            }
        ],
        "total": 2,
        "has_more": false
    },
    "tracking_id": "track_wBhrnKJfwZMTuOpQ+uItfJXOJ6STUymy",
    "order": {
        "items": [
            {
                "object": "order_item",
                "source_id": "bosch_product_1",
                "related_object": "product",
                "quantity": 1,
                "price": 10000,
                "product": {
                    "name": "BOSCH GDR 120-LI Cordless Impact Driver / Wrench"
                }
            },
            {
                "object": "order_item",
                "source_id": "digital_book",
                "related_object": "product",
                "quantity": 1,
                "price": 1500,
                "product": {
                    "name": "Digital Book"
                }
            }
        ],
        "metadata": {},
        "customer_id": null,
        "referrer_id": null,
        "object": "order"
    },
    "stacking_rules": {
        "redeemables_limit": 30,
        "applicable_redeemables_limit": 5
    }
}

Case 2 Summary

The customer wallet scenario returned the list of vouchers the customer can use right now. This mechanism enables you to show the customer, at the cart level, all of his/her vouchers he/she can use, including the gift vouchers and loyalty cards that can be used as the means of payment, enabling your customers to choose a specific reward for themselves, or allowing you to apply the discounts automatically.


Case 3 - Vouchers applicable to specific products

Only a promotion that is applicable to items in the cart. "scenario": "PRODUCTS_DISCOUNT"

Product Coupons In Cart

{
    "scenario": "PRODUCTS_DISCOUNT",
    "customer": {
        "source_id": "GUID_123_john_wayne",
        "name": "John Wayne",
        "metadata": {
            "tier": "VIP"
        }
    },
    "order": {
        "items": [
            {
                "source_id": "bosch_product_1",
                "quantity": "1",
                "price": 10000,
                "related_object": "product",
                "product": {
                    "name": "BOSCH GDR 120-LI Cordless Impact Driver / Wrench"
                }
            },
            {
                "source_id": "digital_book",
                "quantity": "1",
                "price": 1500,
                "related_object": "product",
                "product": {
                    "name": "Digital Book"
                }
            }
        ]
    },
    "options": {
        "expand": [
            "redeemable"
        ]
    }
}
{
    "redeemables": {
        "object": "list",
        "data_ref": "data",
        "data": [
            {
                "id": "vm3HkNF2",
                "object": "voucher",
                "created_at": "2023-09-15T12:59:34.860Z",
                "result": {
                    "discount": {
                        "type": "PERCENT",
                        "effect": "APPLY_TO_ITEMS",
                        "percent_off": 10,
                        "is_dynamic": false
                    }
                },
                "order": {
                    "amount": 11500,
                    "items_discount_amount": 1000,
                    "total_discount_amount": 1000,
                    "total_amount": 10500,
                    "items_applied_discount_amount": 1000,
                    "total_applied_discount_amount": 1000,
                    "items": [
                        {
                            "object": "order_item",
                            "source_id": "bosch_product_1",
                            "related_object": "product",
                            "quantity": 1,
                            "amount": 10000,
                            "discount_amount": 1000,
                            "applied_discount_amount": 1000,
                            "price": 10000,
                            "subtotal_amount": 9000,
                            "product": {
                                "name": "BOSCH GDR 120-LI Cordless Impact Driver / Wrench"
                            }
                        },
                        {
                            "object": "order_item",
                            "source_id": "digital_book",
                            "related_object": "product",
                            "quantity": 1,
                            "amount": 1500,
                            "price": 1500,
                            "subtotal_amount": 1500,
                            "product": {
                                "name": "Digital Book"
                            }
                        }
                    ],
                    "metadata": {},
                    "customer_id": null,
                    "referrer_id": null,
                    "object": "order"
                },
                "applicable_to": {
                    "data": [
                        {
                            "object": "products_collection",
                            "id": "pc_kHDQEBDVn8G04oxvgzRf5et9",
                            "strict": false,
                            "effect": "APPLY_TO_EVERY",
                            "order_item_indices": [
                                0
                            ]
                        },
                        {
                            "object": "product",
                            "id": "bosch_product_1",
                            "source_id": "bosch_product_1",
                            "strict": true,
                            "effect": "APPLY_TO_EVERY",
                            "order_item_indices": [
                                0
                            ]
                        }
                    ],
                    "total": 2,
                    "data_ref": "data",
                    "object": "list"
                },
                "inapplicable_to": {
                    "data": [],
                    "total": 0,
                    "data_ref": "data",
                    "object": "list"
                },
                "metadata": {},
                "campaign_id": "camp_f78wOLL9cE2WCSdtliT0UIh0",
                "campaign_name": "10% discount for BOSCH products"
            },
            {
                "id": "camp_f78wOLL9cE2WCSdtliT0UIh0",
                "object": "campaign",
                "created_at": "2023-09-15T12:59:34.307Z",
                "result": {
                    "discount": {
                        "type": "PERCENT",
                        "effect": "APPLY_TO_ITEMS",
                        "percent_off": 10,
                        "is_dynamic": false
                    }
                },
                "order": {
                    "amount": 11500,
                    "items_discount_amount": 1000,
                    "total_discount_amount": 1000,
                    "total_amount": 10500,
                    "items_applied_discount_amount": 1000,
                    "total_applied_discount_amount": 1000,
                    "items": [
                        {
                            "object": "order_item",
                            "source_id": "bosch_product_1",
                            "related_object": "product",
                            "quantity": 1,
                            "amount": 10000,
                            "discount_amount": 1000,
                            "applied_discount_amount": 1000,
                            "price": 10000,
                            "subtotal_amount": 9000,
                            "product": {
                                "name": "BOSCH GDR 120-LI Cordless Impact Driver / Wrench"
                            }
                        },
                        {
                            "object": "order_item",
                            "source_id": "digital_book",
                            "related_object": "product",
                            "quantity": 1,
                            "amount": 1500,
                            "price": 1500,
                            "subtotal_amount": 1500,
                            "product": {
                                "name": "Digital Book"
                            }
                        }
                    ],
                    "metadata": {},
                    "customer_id": null,
                    "referrer_id": null,
                    "object": "order"
                },
                "applicable_to": {
                    "data": [
                        {
                            "object": "products_collection",
                            "id": "pc_kHDQEBDVn8G04oxvgzRf5et9",
                            "strict": false,
                            "effect": "APPLY_TO_EVERY",
                            "order_item_indices": [
                                0
                            ]
                        },
                        {
                            "object": "product",
                            "id": "bosch_product_1",
                            "source_id": "bosch_product_1",
                            "strict": true,
                            "effect": "APPLY_TO_EVERY",
                            "order_item_indices": [
                                0
                            ]
                        }
                    ],
                    "total": 2,
                    "data_ref": "data",
                    "object": "list"
                },
                "inapplicable_to": {
                    "data": [],
                    "total": 0,
                    "data_ref": "data",
                    "object": "list"
                },
                "metadata": {},
                "name": "10% discount for BOSCH products"
            },
            {
                "id": "promo_QwH9khhoiNAthPykdnpAcpAi",
                "object": "promotion_tier",
                "created_at": "2023-09-15T12:48:11.443Z",
                "result": {
                    "discount": {
                        "type": "PERCENT",
                        "effect": "APPLY_TO_ITEMS",
                        "percent_off": 20,
                        "is_dynamic": false
                    }
                },
                "order": {
                    "amount": 11500,
                    "items_discount_amount": 300,
                    "total_discount_amount": 300,
                    "total_amount": 11200,
                    "items_applied_discount_amount": 300,
                    "total_applied_discount_amount": 300,
                    "items": [
                        {
                            "object": "order_item",
                            "source_id": "bosch_product_1",
                            "related_object": "product",
                            "quantity": 1,
                            "amount": 10000,
                            "price": 10000,
                            "subtotal_amount": 10000,
                            "product": {
                                "name": "BOSCH GDR 120-LI Cordless Impact Driver / Wrench"
                            }
                        },
                        {
                            "object": "order_item",
                            "source_id": "digital_book",
                            "related_object": "product",
                            "quantity": 1,
                            "amount": 1500,
                            "discount_amount": 300,
                            "applied_discount_amount": 300,
                            "price": 1500,
                            "subtotal_amount": 1200,
                            "product": {
                                "name": "Digital Book"
                            }
                        }
                    ],
                    "metadata": {},
                    "customer_id": null,
                    "referrer_id": null,
                    "object": "order"
                },
                "applicable_to": {
                    "data": [
                        {
                            "object": "products_collection",
                            "id": "pc_KM2mzWPu77CFvZX2wWBqVKVp",
                            "strict": false,
                            "effect": "APPLY_TO_EVERY",
                            "order_item_indices": [
                                1
                            ]
                        },
                        {
                            "object": "product",
                            "id": "digital_book",
                            "source_id": "digital_book",
                            "strict": true,
                            "effect": "APPLY_TO_EVERY",
                            "order_item_indices": [
                                1
                            ]
                        }
                    ],
                    "total": 2,
                    "data_ref": "data",
                    "object": "list"
                },
                "inapplicable_to": {
                    "data": [],
                    "total": 0,
                    "data_ref": "data",
                    "object": "list"
                },
                "metadata": {},
                "name": "20% off Digital books for VIP customers",
                "banner": "20% off Digital books for VIP customers",
                "campaign_id": "camp_orPbvjZ9OSmaZzRvj5gjT1kK",
                "campaign_name": "Promotion - % off"
            }
        ],
        "total": 3,
        "has_more": false
    },
    "tracking_id": "track_wBhrnKJfwZMTuOpQ+uItfJXOJ6STUymy",
    "order": {
        "items": [
            {
                "object": "order_item",
                "source_id": "bosch_product_1",
                "related_object": "product",
                "quantity": 1,
                "price": 10000,
                "product": {
                    "name": "BOSCH GDR 120-LI Cordless Impact Driver / Wrench"
                }
            },
            {
                "object": "order_item",
                "source_id": "digital_book",
                "related_object": "product",
                "quantity": 1,
                "price": 1500,
                "product": {
                    "name": "Digital Book"
                }
            }
        ],
        "metadata": {},
        "customer_id": null,
        "referrer_id": null,
        "object": "order"
    },
    "stacking_rules": {
        "redeemables_limit": 30,
        "applicable_redeemables_limit": 5
    }
}

Case 3 Summary

Voucherify will return all the discounts that apply to the products you sent in the order. When a customer is browsing your products and is shown the product listing page, you can send, in the payload, the list of all the products the customer is presented and Voucherify will return all the discounts that apply to these products. The returned results can be visualized, for example, by a striked-through price.


Case 4 - Upselling (audience only)

The upsell scenario displays all the incentives within customer's reach in their cart view and encourages them to purchase additional products. "scenario": "Upselling"

Upselling


{
    "scenario": "AUDIENCE_ONLY",
    "customer": {
        "source_id": "test_customer_id_1",
        "name": "John Doe",
        "metadata": {
            "subscribed": true
        },
        "order": {
            "status": "CREATED",
            "metadata": {
                "currency": "USD"
            },
            "items": [
                {
                    "quantity": 1,
                    "price": 10000,
                    "amount": 10000,
                    "source_id": "GDR_Drill",
                    "related_object": "product",
                    "product": {
                        "name": "Bosch Drill",
                        "metadata": {
                            "cateogry": "tools",
                            "brand": "GDR",
                            "star_rating": 4,
                            "SKU": 10280472384
                        }
                    }
                },
                {
                    "quantity": 1,
                    "price": 40000,
                    "amount": 40000,
                    "source_id": "GRW_Stirring_Mech",
                    "related_object": "product",
                    "product": {
                        "name": "Bosch Stirring Mechanism",
                        "metadata": {
                            "cateogry": "tools",
                            "brand": "GRW",
                            "star_rating": 5,
                            "SKU": 10294856379
                        }
                    }
                }
            ]
        }
    },
    "options": {
        "limit": 30,
        "expand": [
            "redeemable"
        ]
    }
}

{
    "redeemables": {
        "object": "list",
        "data_ref": "data",
        "data": [
            {
                "id": "camp_wh33be7BHtYtyoIdeS5TM7ZO",
                "object": "campaign",
                "created_at": "2024-07-03T14:01:45.254Z",
                "result": {
                    "discount": {
                        "type": "PERCENT",
                        "effect": "APPLY_TO_ITEMS",
                        "percent_off": 25
                    }
                },
                "applicable_to": {
                    "data": [
                        {
                            "object": "product",
                            "id": "prod_0efff4bd5b88dc03ee",
                            "source_id": "23787597244",
                            "strict": false,
                            "effect": "APPLY_TO_EVERY"
                        }
                    ],
                    "total": 1,
                    "data_ref": "data",
                    "object": "list"
                },
                "inapplicable_to": {
                    "data": [],
                    "total": 0,
                    "data_ref": "data",
                    "object": "list"
                },
                "metadata": {},
                "name": "Mix it Up with Power"
            },
            {
                "id": "camp_y5sKLTJThlKa2xzSg0dpdMuZ",
                "object": "campaign",
                "created_at": "2024-07-03T13:56:18.389Z",
                "result": {
                    "discount": {
                        "type": "PERCENT",
                        "effect": "APPLY_TO_ORDER",
                        "percent_off": 15
                    }
                },
                "applicable_to": {
                    "data": [],
                    "total": 0,
                    "data_ref": "data",
                    "object": "list"
                },
                "inapplicable_to": {
                    "data": [],
                    "total": 0,
                    "data_ref": "data",
                    "object": "list"
                },
                "metadata": {},
                "name": "Complete Your Set"
            },
            {
                "id": "camp_Y5ZRGz534MNt4Hk0PgmGC5aw",
                "object": "campaign",
                "created_at": "2024-07-03T13:51:21.481Z",
                "result": {
                    "discount": {
                        "type": "UNIT",
                        "effect": "ADD_MISSING_ITEMS",
                        "unit_off": 1,
                        "unit_type": "prod_0efff23a1648dc2df0"
                    }
                },
                "applicable_to": {
                    "data": [],
                    "total": 0,
                    "data_ref": "data",
                    "object": "list"
                },
                "inapplicable_to": {
                    "data": [],
                    "total": 0,
                    "data_ref": "data",
                    "object": "list"
                },
                "metadata": {},
                "name": "Stay Charged"
            },
            {
                "id": "camp_OCSDKKQoC4h6MwWJ9TcJ79bu",
                "object": "campaign",
                "created_at": "2024-07-03T13:39:26.731Z",
                "result": {
                    "discount": {
                        "type": "PERCENT",
                        "effect": "APPLY_TO_ITEMS",
                        "percent_off": 20
                    }
                },
                "applicable_to": {
                    "data": [
                        {
                            "object": "products_collection",
                            "id": "pc_BKKzXVL6vaLQXn1ASFsvi3FP",
                            "strict": false,
                            "effect": "APPLY_TO_EVERY"
                        }
                    ],
                    "total": 1,
                    "data_ref": "data",
                    "object": "list"
                },
                "inapplicable_to": {
                    "data": [],
                    "total": 0,
                    "data_ref": "data",
                    "object": "list"
                },
                "metadata": {},
                "name": "Enhance Your Workshop"
                   }
        ],
        "total": 4,
        "has_more": false
    },
}

Case 4 Summary

Based on the customer order, Voucherify will encourage customers to buy a more expensive version of a product or add extra products from a matching theme adding various incentives. This process focuses on enhancing the customer's purchase to increase the total sale.