GuidesHelp CenterRelease notesSign up
Guides

Key Concepts

Learn the key concepts to help you implement promotional campaigns and integrate Voucherify with your stack.

Suggest Edits

Voucherify operates on fundamental building blocks that you can use to create your promotional campaigns and integrate them with your system.

Project

A project is an environment for managing promotion activities in Voucherify. A project can be used to run those activities concerning a brand, region, or currency or for development or staging purposes.

Each project has a set of unique API keys. The data, e.g. customers, products, campaigns, are not shared between the projects.

📘

Learn more

Campaigns and vouchers

Campaign

A campaign is a basic entity in Voucherify that is used to carry out promotional activities.

There are six basic campaign types, which create:

For voucher-based campaigns, each campaign has a set of unique voucher codes, which have the same purpose.

📘

Learn more

Voucher

A voucher is an entity in Voucherify that is used as an incentive for end customers. Every voucher has a unique code.

Vouchers can be grouped under one campaign to serve the same purpose, e.g. a campaign that assigns vouchers to customers who have a birthday.

A voucher can be also used outside of a campaign as a standalone voucher. Standalone vouchers can be shared with a large group of customers or made public for big promotional activities, e.g. Black Friday.

A voucher is used in the following types of campaigns:

📘

Learn more

Promotions and promotion tiers

A promotion is a campaign that groups specific discounts and it does not require a voucher to be applied to a customer's cart. When a customer or their cart qualifies for a promotion, the discount is automatically applied to the cart or it can be shown to the customer as a part of the qualification process.

A promotion tier is a specific discount with conditions. The discount is automatically applied to the customers and carts that meet the conditions.

Promotion tiers can be applied together as a promotion stack or arranged in a hierarchy of an application in one promotion campaign.

📘

Learn more

Customer

A customer is an entity in Voucherify that represents an end customer of a store, a B2B customer, or any partner who sees products or services. A customer can be assigned vouchers or be eligible for promotions.

A customer object can have many parameters, e.g.:

  • name,
  • email,
  • birthdate,
  • metadata.

📘

Learn more

Customer segments

A segment is a customer group that shares the same parameters.

There are two types of segments in Voucherify:

  • static: it contains a manually prepared list of customers based on customer ID,
  • auto-update: customers are dynamically added to or removed from the segment if they match a given filter, e.g., the customer's birthday is today, they haven't placed any orders in the past 30 days, or joined a newsletter.

📘

Learn more

Incentivization rules and processes

In Voucherify, you can set rules that govern how incentives, such as vouchers or discounts, are applied. Also, the incentives can be managed under several processes related to their application.

Validation rules

Validation rules are conditions that are applied to campaigns, standalone vouchers, promotion tiers, or distributions. For example, the customer or their cart must meet the conditions for the incentive to be applied.

A validation rule can be created in advance. It is an independent object which can be attached to or detached from the above-mentioned objects to be reused in the future.

🚧

Managing validation rules

It is recommended to create validation rules in the Voucherify dashboard. The rule builder in the dashboard helps configuring the desired conditions in a convenient way. The API should not be used as a preferable way to create and manage validation rules.

📘

Learn more

Qualification

Qualification is the process that validates which incentives (e.g. products, vouchers, or promotions) can be used in the customer's cart.

📘

Learn more

Validation

Validation is the process that checks if a combination of vouchers or promotion tiers together with the applied validation rules are valid to the customer. On the basis of validation, the final price is calculated. Validation checks up to 30 vouchers or promotion tiers.

📘

Learn more

Redemption

Redemption is the process of applying and consuming vouchers or promotion tiers to the customer's order. Redemption checks if a voucher or promotion tier together with the applied validation rules is valid to the customer. Redemption checks up to 30 vouchers or promotion tiers.

📘

Learn more

Rollback

Rollback is the process in which redemption is reverted. Rollback withdraws the incentive from the customer's order and updates its status.

📘

Learn more

Communication

Distribution

Distribution is a process of sending vouchers and other promotional messages to end customers. Distribution can be used as a publication method.

There are two types of distributions:

  • automatic: it is triggered by an event,
  • manual: the message is sent to all end customers or a specified group.

Distribution channels include, among others:

  • emails,
  • text messages,
  • live chat,
  • push notifications.

📘

Learn more

Publication

Publication is the process of assigning a voucher to an end customer.

📘

Learn more

Webhooks

A webhook is an HTTP callback that is triggered by an event rather than a request. Webhooks can be used to notify external systems about any events or relevant actions performed with Voucherify.

The events can be custom. Custom events are objects that can be used to track end-customer interactions with a system.

📘

Learn more

Custom attributes (metadata)

Custom attributes (metadata) are customizable data that can be added to default Voucherify objects. A custom attribute consists of a key and value pair.

📘

Learn more

Updated 5 days ago