Voucherify Complete User Guide

This is the perfect place to start your journey with Voucherify and prepare your account for the first promo campaign. We're going to cover the key concepts of Voucherify that will let you build attractive & effective promo campaigns. 

  1. How does it work?
  2. Sign up (it’s free)
  3. Plan your integration
  4. Set up your account:
  5. Launch first campaign:
  6. Share codes:
  7. Redemptions
  8. Tracking and fraud prevention
  9. Help and support
  10. Pricing glossary

How does it work?

Voucherify is an all-in-one platform that helps companies launch customized coupons, gift cards, auto-applied promotions, loyalty programs, referral campaigns, and giveaways.

Voucherify account gives you access to API and Dashboard. It means that both marketing teams and developers can create and manage Voucherify promotions. In this guide, we will focus on the Dashboard and mention a few crucial functions of API. 

For more information about the API, visit the Developer Hub.

Watch our Product Demo to learn more about core Voucherify functionalities that are intended to help your business deliver personalized promotions at a fraction of time and cost:

If you prefer watching over reading, you can learn more about the platform with our webinars


Sign up (it’s free)

Voucherify gives you 30 days to play around with the platform and test it for free. After creating the account and logging in, it's time to set up your account and project details. Projects enable you to organize different workspaces within a single account.  You can separate your production and testing environments or create separate projects for different markets or time zones. Here are some project-specific settings:

  • Unique API keys
  • Currency
  • Time zone
  • Team structure
  • Email domain
  • Webhooks 
  • Metadata Schema
  • Event Schema

Campaigns and validation rules are also created per project. 

Project currency

Setting up currency in the project enables you to display values in the desired format, however, our API is currency-agnostic. Changes in project currency don't impact the way API calculates discounts and amounts.

Account settings in short:

  • The number of projects that you can create is limited by the selected plan according to the pricing.
  • In the Team settings, you can invite new users and manage data access. The Admin (owner of the account) can assign roles to team members and restrict their rights. 
  • In the Team settings > Billing, the Admin can manage the subscription and payment settings.

Tutorials and How-to Guides: 


Plan your integration

Integration is a connection between your Voucherify account and your customer touchpoints. Thanks to that, Voucherify will recognize and validate incentives used on your website/application. Building the integration comes down to connecting with the Voucherify API. 

Integration requirements

Here is a quick summary of points you need to consider while defining your integration requirements:

Promotional scenarios 

Which types of campaigns you want to run with Voucherify, including coupons, loyalty programs, referrals, cart-level discounts, gift cards, and giveaways.

Redemption touchpoints 

A deep dive into your customer journey and the technology supporting it. The aim is to find out how to apply Voucherify promotions to your e-commerce and CRM software.

User roles & budget 

Mapping how various departments like marketing, customer support, and engineering can collaborate to create and maintain successful campaigns. Estimate how many users you will need and what access control is required to manage user’s data access.

Customer data 

An analysis of what customer attributes should feed the Voucherify and how frequently to synchronize them to get the timing right.

Product catalog 

A plan on integrating Voucherify with your inventory to enable product-specific discounts.

Distribution 

Designing how to connect marketing channels with promotion engine triggers.

Reporting 

An overview of Voucherify data export capabilities for business intelligence and data integrity purposes.

Migrations from legacy systems 

Planning how to transition your legacy campaigns without causing harm to the customer experience.

Data volume estimation 

Depending on the traffic and data volume, the integration might require additional activities like setting up a dedicated cluster or splitting your promotional campaigns into several Voucherify projects. Try to estimate your traffic that refers directly to the limit of API calls that will provide seamless communication with our API.

Security requirements management 

We consider several security-sensitive inputs like PII data policy, GDPR requirements, history of fraud incidents, organization access policy to design and set up a secure Voucherify account compliant with international standards and protects your campaigns from malicious activity. 


Integration time

The more campaign types, customer touchpoints, and 3rd party systems you want to integrate with Voucherify, the more developer effort (and consequently time) are required. However, once you have Voucherify integrated, adding new campaign types takes less and less time.

Here are some Integration time benchmarks:

  • Lean startup – a day or two, our record is 1h front-end and 1h back-end to accept coupon redemptions in the production environment. 
  • Small and medium-sized brands – on average, a week to launch the first campaign, a couple of weeks for more advanced scenarios.
  • Enterprise brands with many dependencies – from a couple of weeks to several months, including securing the development team, going through security checks, and onboarding the marketing team.

Voucherify is API-first and headless, which means you can implement Voucherify one step at a time. You can switch to Voucherify only for a part of the promotional stack and expand to the others in the future. 

Let us help

  • We offer you the support of Voucherify developers and partners on the road towards flexible and personalized promotions. Go here to learn more.
  • For full guides on Voucherify implementation & integrations, visit Success Portal.

Set up your account 

This section aims to familiarize you with the Voucherify dashboard and teach you how to launch highly targeted promotions. All the features we're going to cover are optional but recommended as they enable you to build personalized promotional experiences. The customization comes down to:

  • Adding/syncing customers.
  • Adding a catalog with your products.
  • Customizing Voucherify objects (vouchers, customers, etc.) with metadata.
  • Integrating with your favorite tools.

Customers

The point of adding customers to Voucherify is segmentation and targeting. Your audience can be divided into segments based on customers' behavior, interactions with your brand, order history, geographical attributes, and many more. These segments can be used to create promotion rules and trigger auto-messages with promo codes. 

Adding customers

Before you explore segments, you need to decide how to synchronize customers with the platform. Here are your options:

If you are not interested in uploading your customer data, you can operate on source id property, a unique customer identifier in Voucherify. To help you identify and update customer profiles, you can pass your CRM unique id in the source id field. It can be email, phone number, or other characteristics of your choice.

Customers in short

  • You can pass your customers' data using CSV files, CRM integrations, or Customers API.
  • Each customer has a unique source id required to validate customer-specific promotion limits.
  • You can group customers using static and dynamic filters. Filters that aren’t built-in can be added using custom metadata attributes. 
  • Here is a complete guide on Customers.

Products

You can add your inventory to the Products section in the Dashboard. Syncing products enables you to create product-specific promotion rules straight from the Dashboard. However, if you don’t want to add a product catalog, you can use product metadata and still execute product-related limits. 

Each product can have many variants called SKUs (stock-keeping units). When executing product-specific limits, Voucherify validates all items from the customer's cart, including products and SKUs.

Product-specific rules in short

  • Specify what products and in what number can or cannot be in the customer’s cart.
  • Define how many items a customer needs to have in the cart.
  • Define required prices or subtotal of particular items.
  • Decide to which products the discount should be applied to.
  • Define a custom attribute that a product or SKU needs to have to be discounted.

Metadata Schema

Metadata enables you to add custom data to Voucherify. You can use metadata for building validation rules and reporting/tracking. Each metadata attribute is a key/value pair that carries custom information about Voucherify objects. You can assign metadata to the following object types:

  • voucher
  • campaign
  • customer
  • product
  • SKU
  • publication
  • redemption
  • order
  • loyalty tier
  • in-cart promotion tier
  • in-cart promotion

For example, you can add custom attributes to your customers, like "group: VIP," "source: adwords," and segment them accordingly.

Metadata schema

To provide data integrity and manage metadata across the Project, the app provides Metadata Schema in your Project settings. You can choose a particular schema and add new metadata definitions. The schema supports many data formats, including text, numbers, images, and many more. You can create a new metadata definition, decide if it’s mandatory when adding a new object, and list accepted values. 

There are plenty of use cases for metadata, and each of them is unique. They offer you extreme flexibility and freedom in creating rules and limits for promotions and the segmentation of your customers. 

Metadata in short

  • Metadata stores custom pieces of information in key/value pairs.
  • To add metadata, go to the Project settings > Metadata Schema.
  • Only the account Administrator can modify the Metadata Schema.
  • You can use metadata added to products, customers, redemptions, and orders to create custom validation rules.

Tutorials and Use Cases:

If you prefer watching over reading, learn more about Metadata with our webinar.


Event Schema

Custom Events are actions taken by your customers that you track in your application/website. They’re best suited for tracking high-value customer interactions with your brand. You can pass those actions to Voucherify in real-time by calling our Events API. Logging a custom event can trigger any number of distributions and enables customer segmentation around the recency and frequency of that event.

The Custom Events are directly linked to the customers' resources from Voucherify. It means that each event gets a connection to a customer.

To use Custom Events in your promotions, you need to follow the steps below:

  1. Create event definition in the Project settings > Event Schema.
  2. Use the Track Custom Event method to log the event in Voucherify every time a customer performs the desired action in your application/website.
  3. Create promotion workflow around the custom event. 
    • You can automatically send incentives to customers who performed the event keeping in mind its recency and frequency.
    • Custom events can also be used to build earning rules. As a result, customers are rewarded with a predefined number of loyalty points in response to the event. 

Read more about Custom Events.


Integrations

Voucherify lets you connect your favorite tools using API and built-in integrations. Visit our integration catalog to see what integrations we offer out-of-the-box:


Launch the first campaign

Campaigns and vouchers can be created using the Dashboard or via the API. In the Dashboard, there is a Campaign Manager that guides you through the creation of discount coupons, gift cards, loyalty programs, auto-applied promotions, referral campaigns, and giveaways.

Let’s go through a typical campaign workflow to understand the key concepts better. Note that this is just an example and both API and the Dashboard give you many ways to customize your campaigns. 


Campaign workflow / Quick API reference

The Dashboard  API
1. Create validation rules * Create Validation Rules
POSThttps://api.voucherify.io/v1/validation-rules
2. Create a campaign with validation rules * Create Campaign
POST https://api.voucherify.io/v1/campaigns

* Assign Validation Rules

POSThttps://api.voucherify.io/v1/validation-rules/validation-rule_id/assignments

3. Send and publish code to a customer using distributions Publish Code
POSThttps://api.voucherify.io/v1/publications
4. The customer redeems the code, and Voucherify checks if it’s valid Validate Code
POSThttps://api.voucherify.io/v1/vouchers/code/validate

Redeem Code (Client-side)
POSThttps://api.voucherify.io/client/v1/redeem?code=code
5. Track the code and the customer using dashboard metrics Get Code Redemptions
GEThttps://api.voucherify.io/v1/vouchers/code/redemption

List Customer Activity
 GET https://api.voucherify.io/v1/customers/customer_ID/activities

* Not recommended, we highly encourage you to create campaigns and validation rules using the Dashboard. 


Before we go through the Campaign Manager to create your first campaign, you need to learn more about Voucherify Rules Builder. It creates validation rules – optional limits and purchase conditions that need to be met to redeem code/promotion.

Rules Builder

You can open Rules Builder by clicking the plus in the Validation Rules section. This section enables you to prepare rules beforehand and use them in future campaigns. You can also access Rules Builder when creating a campaign in the Manager and add new rules on the spot. In general, the Builder supports the following groups of rules:

  • Audience-related rules define customers eligible for redemption.
  • Order-related rules refer to order structure and order volume. You can specify the required cart structure and volume (minimum, maximum order amount, number of items, and more).
  • Budget rules define redemption limits and campaign budget.
  • Many advanced limits including restricting redemption to a code owner and internal redemption limits related to data access.

Read more about the validation rules.


Campaign Manager

Campaign Manager lets you create all promotion types supported by Voucherify. Creating a new campaign comes down to the following steps:

  • Log into your account and click the plus in the Main view.
  • Click Create next to the desired campaign type.
  • Go through the Campaign Manager and configure campaign details.
  • Review a campaign summary and confirm with Save.

Some settings are common for all campaign types:

  • Time limits, including the campaign timeframe.
  • The number of incentives and optional validation rules.
  • Campaign name and optional description.
  • Campaign metadata for reporting and tracking purposes (optional).

Moreover, each campaign type has some specific settings related to its workflow. For example, referral and loyalty campaigns require setting up rewards and enable you to configure automatic notifications. 

Step-by-step tutorials

Visit our dedicated tutorials that will lead you through the Campaign Manager to create your first promo campaign:

Your first campaign in short

  • All campaigns and promotions are created in the Campaign Manager.
  • Rules Builder, available in the Validation Rules section and the Campaign Manager, creates optional redemption limits.
  • For more guidance on creating your first campaign go here.

Share codes

When the campaign is ready, you can share your incentives with customers. There are two main concepts in Voucherify that allow you for personalized and trackable incentives delivery. First, you can publish each unique code (coupon, referral code, loyalty card, gift card) to a particular customer. Second, you can use Landing Pages and Distributions that publish and send unique codes to end-customers or 3rd party applications.

Code publication

Publication means assigning a code to a customer. As a result, the customer becomes a code owner. Publications are required for loyalty cards and referral codes to work properly and are optional for coupons or gift cards. In the case of referral codes, publications enable the application to count referred customers. Loyalty cards need to be assigned to collect customer’s points. Unique coupons and gift cards can also be published to particular customers to secure your incentives from misuse better. Thanks to publications, you can use the following campaign rules:

  • Customer can join campaign only once – optional campaign mode ensuring that each customer can own only one code from the given campaign. You can enable this campaign mode in the Campaign Manager > Program Size.
  • Only for a customer who is a holder of the code – validation rule that limits code redemptions to a customer who has the code published to his/her account. Only the code owner can use the code. You can find this rule in the Advanced validation rules category. 
  • Keep valid for a specific amount of time after publishing – allows you to define how many days or hours the code is valid since it was published to the customer. You can find this limit in the Campaign Manager > Timeframe.

There are many ways of publishing codes. Using a dedicated API method, manually in the Dashboard, or via distributions and landing pages which we’re going to cover in the next parts of this guide. 

Here’s a summary of all publication methods.


Distributions

Distribution is a workflow set up in the Distribution Manager that sends messages from the Dashboard. Messages can be sent to customers or 3rd party applications of your choice. You can use distribution to send plain messages, inform customers about new promotions and finally, to send and publish unique codes. There are two distribution modes:

  • Manual messages are a one-time action. Messages are sent after you confirm distribution in the Manager, and then the distribution is completed.
  • Automatic distribution triggers messages in response to a predefined action like a customer’s birthday, order status change, a new customer in your database, and many more.

Every time you send a message with a unique code, the code is published to the message receiver. The Distribution Manager supports many channels like emails, SMS, webhooks, MailChimp, Braze, ActiveCampaign, and more. 

Read our Getting Started Guide on Distributions.


Landing Pages

Landing Pages created in your Dashboard are automatically connected to your account. It means that you can use them to collect subscribers, publish, and redeem codes. Incentives that your customers will use on the landing page are validated by Voucherify, and thanks to the real-time tracking, everything is noted in the Dashboard. Landing pages templates are fully customizable to let you design and publish landing pages consistent with your branding and promotion needs. 

Example landing pages you can create:

  • Subscribe form that triggers a message with a unique code to every new subscriber.
  • Invitation to join a loyalty program that sends loyalty cards to every invited customer.
  • Landing page with redeeming form to let your customers redeem their promo codes.
  • Landing page with subscribe form and referral links that ensure complete referral workflow. 

Read more about Landing Pages.


Redemptions

Redemption is a single usage of any code or cart-level promotion. In loyalty programs, redemption takes place when exchanging points for a reward. The number of invoked redemptions you can handle per month is defined by your pricing plan.

How redemption works

To let customers redeem codes, your website/app needs to be connected to your Voucherify account. This integration guarantees that the app will recognize promo codes used by your customers so they can be validated and redeemed.

Each redemption attempt is noted in your Dashboard with details like status (success, failed), customer’s data, date time, customer’s order, and more. If the redemption fails, you’ll see the failure reason also noted in the redemption details. 

With Voucherify connected to your application, our API handles redemptions invoked by your customers and sends a response with a redemption result. You can also enable redemptions on your landing pages or web widget. Moreover, the Dashboard allows you for manual redemptions done straight from a detailed code view. Read more about redemption points.

Mobile application

For offline redemptions, you can use our mobile application. All you need to do is download the Voucherify application (it’s free), and log into your Voucherify account. From that moment, you can scan QR codes in physical locations to validate and redeem incentives on mobile devices. The mobile app lets you also publish codes and track redemptions. Read more


Tracking and fraud prevention

Tracking the performance of your campaigns is crucial to meet the expectations of your customers and secure your budget. Voucherify tracks redemptions and campaigns so you can analyze them with the Dashboard metrics or export data for future analysis in external BI tools. 

Reports and tracking

Internal reporting system comes down to the following concepts:

  • Dashboard reports with a global perspective on your performance. They give you a birds-eye view of what’s working best at the moment.
  • Detailed campaign and incentive reports. You can track and monitor each campaign and incentive separately. The Dashboard presents detailed history and stats of each code usage and campaign performance.
  • Distribution reports with graphs and activity tab, including distribution updates and a result of each sent message.
  • Notifications that automatically notify you when something important happens. You can customize notification channels and events that you want to be informed about.
  • Customer activity tracking with 360 customer profile and Activity tab that notes all actions and updates of the customer’s data.
  • Data export enables you to analyze your promotions using external tools.
  • Quick troubleshooting with filtering comes in handy if there are any issues with your incentives. You can quickly filter codes based on numerous attributes and deactivate them with one click. 

Fraud prevention

The app provides two-sided security and fraud prevention. On the one hand, redemption limits and tracking of every interaction with your campaigns guard you against client-side misuses and enables you to react instantly to any suspicious activity. On the other hand, the app provides high-level account security with controlled data access, multi-factor authentication, SAML login protocol, and detailed account history. 

You can read more about reporting and fraud prevention in our docs:

  1. Campaign Security
    1. Anti-fraud limits
    2. Activity tracking
    3. Notifications & reports
  2. Account Security

Help and support

Our team is always ready to support you. If you have any questions or need more information about Voucherify capabilities, please reach out to us.

Feedback

Your feedback is always highly appreciated. Please share with us all your insights and help us get better!


Pricing glossary

The pricing glossary explains how our pricing works and which parts of Voucherify are limited by the subscription plan. 

Redemption

Redemption is a single usage of a promo code or an in-cart discount. In loyalty programs, redemption is equal to exchanging loyalty points for a reward.

Project

Project is a separate workspace in your account. Each project has its unique API keys. You can use projects to differentiate production and testing environments or create separate space for different stores, different markets, or timezones.

Message

The message means pushing out data from Voucherify to the end-customer or other application using the Distribution Manager. Message limit in the pricing refers to all distributions that use our API to send messages. For example, an email with a unique coupon and a webhook with a published voucher are both messages. 

API call

API call is a single request sent using our API. You can create API calls using methods from API reference or by using the dashboard that calls the API behind the scenes. Hourly API call limit refers to a single project and can’t be exceeded. When you reach your limit, access to the API is blocked. You can monitor your current usage in the Project settings > API usage to prevent exceeding the limit. 

User

There is one account Admin that can invite other users to join a Voucherify account. Admin counts as one user. Users are assigned to specific projects, but the overall user limit refers to a single Voucherify account. 

Self-service subscription

When you choose a self-service subscription, after the trial, you need to activate the paying plan. From that moment, you’ll be charged monthly with the flexibility of upgrading and downgrading each month. Self-service accounts are hosted on the multi-tenant infrastructure (Asia Singapore, US East, or Europe Ireland). Users can get in touch with the Voucherify team via email support. 

Enterprise subscription

Enterprise subscriptions are individual offers prepared by our team in response to your unique requirements. If you need higher limits or features not provided in self-service plans, let our team know, and we’ll get back to you to discuss details. Common enterprise features include premium support, dedicated infrastructure, custom API calls, and redemption limits. 

For more information:

Start a free 30-day trial (no credit card required)

You can enjoy our support all along the way!

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us