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.
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 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, you have access to the free test (Sandbox) project. If you'll upgrade from the trial to a paid plan, the Sandbox project will be visible in your projects list but won't be counted to your projects limit. Learn more about the Sandbox mode.
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
- Time zone
- Team structure
- Email domain
- Metadata Schema
- Event Schema
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
Building the integration comes down to connecting with the Voucherify API. The integration connects your Voucherify account to your toolkit and customer touchpoints. Thanks to that, you can synchronize your data and validate/redeem Voucherify incentives on your website/application. When building integration, you can connect only these parts of API that you currently need and extend integration over time.
Need help integrating Voucherify?
We offer a team of dedicated, high-skilled developers who have experience with both Voucherify and CRM tools to integrate Voucherify with your existing technology stack. Learn more.
Here is a quick summary of points you need to consider while defining your integration requirements:
Which types of campaigns you want to run with Voucherify, including coupons, loyalty programs, referrals, cart-level discounts, gift cards, and giveaways.
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.
An analysis of what customer attributes should feed the Voucherify and how frequently to synchronize them to get the timing right.
A plan on integrating Voucherify with your inventory to enable product-specific discounts.
Designing how to connect marketing channels with promotion engine triggers.
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.
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.
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.
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.
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 into segments 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.
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.
- Read more about adding products to the Dashboard.
- Read more about product-specific campaigns without adding products to the Dashboard.
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 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:
For example, you can add custom attributes to your customers, like "group: VIP," "source: adwords," and segment them accordingly.
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.
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 enable customer segmentation around that event's recency and frequency.
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, you need to follow the steps below:
- Create event definition in the Project settings > Event Schema.
- Use the Track Custom Event method to log the event in Voucherify every time a customer performs the desired action in your application/website.
- Create 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.
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
|1. Create validation rules|| * Create Validation Rules
|2. Create a campaign with validation rules|| * Create Campaign
* Assign Validation Rules
|3. Send and publish code to a customer using distributions|| Publish Code
|4. The customer redeems the code, and Voucherify checks if it’s valid|| Validate Code
Redeem Code (Client-side)
|5. Track the code and the customer using dashboard metrics|| Get Code Redemptions
List Customer Activity
* 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.
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 or earning loyalty points.
- 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.
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.
Visit our dedicated tutorials that will lead you through the Campaign Manager to create your first promo campaign:
- Fixed (standalone) public code
- Unique coupon campaign
- Gift cards campaign
- Referral program
- Loyalty program
- Cart-level promotion
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.
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.
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.
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 send(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.
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.
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 options and methods.
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:
- Redemption tracking - every time someone tries to redeem your code Voucherify notes the redemption result with details in your Dashboard.
- 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.
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:
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.
- Contact support if you need any help during your journey with Voucherify.
- Contact sales to discuss your expectations.
- Visit docs for developers.
Your feedback is always highly appreciated. Please share with us all your insights and help us get better!
The pricing glossary explains how our pricing works and which parts of Voucherify are limited by the subscription plan.
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 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.
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 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.
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.
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 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!