Integration blueprint
What does Voucherify integration entail?
Voucherify offers a business-agnostic API to model any promotion case. You can start with a single campaign type, for example, a discount campaign, and expand to other types later, such as gift card campaigns. Thanks to its modular API, you can choose the specific building blocks you need at the moment. This approach allows you to start small and scale to larger projects without significant upfront costs.
A key factor in evaluating the total cost of integration is understanding how Voucherify connects to your existing e-commerce and marketing infrastructure.
Scenario discovery
Before you start your integration with Voucherify, work with your team to:
- Identify a campaign type for your scenario,
- Learn key capabilities for each campaign type.
Choose between available campaign types
Voucherify supports the following campaign types:
- Coupon campaigns (generic and bulk promo codes) – Read the discount coupon guide
- Cart-level discounts (strike-through promotions and bundling) – Read the promotion guide
- Gift cards – Read the gift card guide
- Loyalty programs (earn and burn points, tiers, cashback, paid membership, and more) – Read the loyalty program guide
- Referral programs (affiliate programs) – Read the referral program guide
Each campaign type has a different operational flow, but all of them can be parametrized with customer attributes, order structure, or any custom data (metadata).
Voucherify supports your team throughout the entire promotion lifecycle:
- Selecting campaign type and defining eligibility conditions (if conditions).
- Defining discount or reward values and effects (then effects).
- Distributing incentives and rewards via a built-in engine or third-party solutions.
- Validating and redeeming offers.
- Managing campaigns and monitoring real-time performance across channels.
After selecting the promotion type for the pilot campaign, the next step is to define the precise promotion scenario (use case) you want to model.
How to write a use case?
A use case should specify the scenario you want to launch using Voucherify, covering the following aspects:
- Campaign type: Determine the type of campaign, such as discount coupons, automatic promotions, gift cards, a referral program, a loyalty program, or a combination of them.
- Campaign effect: Define the primary goal and intended outcome of the campaign.
- Target audience: Identify the specific customers the campaign should target, including any groups to be excluded. This involves defining all customer-level rules.
- Promotion distribution: Outline how incentives will be distributed. Specify when customers should receive the promotional message or qualify for the promotion.
- Time constraints: Determine if the promotion requires time limitations, such as specific days, hours, or recurring events.
- Qualifying orders and products: Establish any order- and product-level restrictions. For instance, whether the promotion applies to a minimum order value or excludes specific items.
- Other limitations: Detail any additional restrictions or limits that should apply to the campaign.
- Customer journey: Map out where the promotion will be displayed and the entire workflow across various customer touchpoints.
- Budget limits: Specify if the campaign should automatically conclude upon reaching a predefined redemption threshold or if other budget constraints are necessary.
Sample campaigns based on industry
Here are some of the popular use cases that Voucherify clients have launched.
Ecommerce
The most popular ecommerce use cases are:
- Generic (standalone) promo codes with robust redemption limits.
- One- and two-sided referrals.
- Before- and after-churn promo codes.
- Behavior-based campaigns, for example, a promo code for orders above $500.
- Upselling and cross-selling scenarios.
- Volume-based cart promotions with levels.
Travel
The most popular travel use cases are:
- Book in advance scenarios, for example, use the promo by the end of month for a cruise next year.
- After-trip promotions, for example, send a promo 2 days after the trip.
- Gift card refunds.
Services
The most popular services use cases are:
- Booking a service during dead hours, for example, a taxi service between 10 AM and 2 PM.
- Sustainability promotions.
Customer experience (CX)
After defining your pilot campaign, the next step is deciding where and how to use the Voucherify API in your customer journey. Think about which customer touchpoints need to connect to Voucherify APIs to make your scenario happen.
Your integration can combine qualification, validation, and redemption mechanisms.
You can use the qualification mechanism to show customers relevant offers as recommendations at any point of their journey. For example, you can show vouchers that apply to the items in their cart.
You can also use validation on its own, without qualification, as the initial check for eligibility. Validation can show the discount amount, letting customers see the effect of an applied incentive.
Redemption is when the incentive is actually used. If an incentive can be applied, it's consumed. For single-use discount codes, this means they can't be used again.
You can even use redemption by itself, as it also checks a customer's eligibility.
Each incentive (redeemable
in the API) generated by Voucherify can be validated against validation rules. These rules determine if a customer's incentive is eligible for an offer and if it can lead to a successful validation or redemption.
Here are some popular ways to improve customer experience with Voucherify APIs:
- Various validation and redemption methods: You have several options for validating and using incentives, including API calls, e-commerce plugins, offline mobile app scanning, widgets, landing pages, and manual redemption.
- Strikethrough pricing: Use the qualification API to display product and SKU prices.
- Customer wallets: Use Voucherify's GET API requests to get important customer information, such as their assigned incentives, status, and other details. These can be used to build customer-facing tools like progress trackers or digital wallets.
- Discount stacking: Customers can redeem multiple incentives based on defined stacking rules. The Stackable discount API supports validation and redemption of all types of incentives with one endpoint for redeeming promo codes, applying loyalty points, counting successful referrals, or updating gift card balances.
- Dynamic discounts: Run dynamic promotions with different effects based on context. For example, a promo code might give all users 20% off, but loyalty members get an extra 10% off.
Voucherify handles the backend logic and maintenance of digital promotions. By using the headless approach, which separates the back- and frontend, you can achieve faster integration, have complete control over your offer's appearance, and reduce the risk of backend errors disrupting your frontend applications.
To make prototyping easier, you can use client-side APIs.
For inspiration on the frontend promotion experience, refer to Voucherify UX kits:
Your customer experience can be further improved with the way your integration is made with other tools.
Integration method
As a developer-first tool, Voucherify exposes several integration paths.
REST API
Voucherify provides granular REST APIs to deliver personalized incentives across any channel, device, or commerce solution. Your data remains secure in highly available environments, whether in a multi-tenant or dedicated cluster, located conveniently in a cluster close to you.
Learn more by exploring Voucherify's interactive API reference.
Webhooks
With Voucherify, you can set up webhooks to receive instant updates directly to your app or URL endpoints when specific events happen. This means you don't have to constantly check for new data; instead, you'll get notifications about critical campaign-related events as they occur.
Learn more about Voucherify's webhooks.
Event-bus – Kafka
Voucherify can work with event buses as producers and subscribers.
Integration with an ecommerce engine
Voucherify can be integrated with both headless and monolithic ecommerce solutions.
Frontend decoupled from order management logic
Headless commerce solutions allow decoupling the frontend from order management logic, so you can quickly integrate your platforms. Voucherify fits well in the composable commerce ecosystem and has been successfully deployed on a global scale, in both digital and physical stores. In addition, Voucherify provides numerous native accelerator plugins to the top ecommerce providers such as:
Monolithic commerce solution
An integrated frontend and backend setup may require additional effort to ensure bi-directional synchronization with Voucherify. Voucherify's professional services team, along with together with SI partners, has extensive experience in estimating total integration costs and is available to consult on your business case. Joint case studies with Voucherify's partners highlight successful integrations with various e-commerce platforms, from Shopify to SAP Hybris.
Integration with a marketing ecosystem
Next, define the promotion experience. Voucherify's team can suggest ways to improve how you implement customer-facing touchpoints, including offer placements and messages, depending on the CDP, CEP, CMS, and CRM platforms you use.
Voucherify scales effectively thanks to its integrations with CDP or CEPs and stream processing systems like Kafka. On the other hand, CMS integrations help us localize promotions and adapt their format to meet the specific requirements of your distribution channels.
CDP integrations
Voucherify integrates with popular Customer Data Platforms, such as:
CEP integrations
Voucherify provides ready connectors with Customer Engagement Platforms, such as:
- ActiveCampaign
- Airship
- Batch
- Bloomreach Engagement,
- Braze,
- CleverTap
- Intercom
- Iterable
- Klaviyo,
- MoEngage,
- Wyng ,
CMS integrations
Voucherify provides ready connectors with Customer Management Systems, such as:
Data modeling and handling
The data transfer between Voucherify and marketing technology platforms should be considered with respect to:
To achieve the desired scope of campaign flexibility and personalization, you have to send appropriate data to Voucherify.
That's why a data model is needed. Once it's created, you can move on to build a promotion experience on top of your user journey and lead customers to validate and redeem incentives.
Most Voucherify implementations are built on top of the following workflow.
Data model
A Voucherify integration requires a business-appropriate data model for customer traits, custom events, and even custom incentives.
With Voucherify's modular API, it's possible to run different types of incentives with any data. This means Voucherify supports brands across diverse industries and business models, including e-commerce, subscription-based brands, and those operating in B2C, B2B, or D2C sectors.
To ensure high flexibility, the Voucherify data model can be extended with custom fields and objects (metadata). Metadata allow you run fully custom campaigns with the support of arrays and nesting for deeper targeting.
You can also track custom events to run campaigns that are relevant to your business model and audience.
IDs in Voucherify
Voucherify operates on top of two types of identifiers:
- External master ID (
source_id
), provided by, for example, a Customer Data Platform, - Unique identifier assigned by Voucherify.
This approach lets you sync various pieces of information under a unified ID.
Modelling your data
To quickly map your data model, consider ready connectors with Segment and mParticle CDPs.
For the initial data migration, use different data import options, like Voucherify dashboard or asynchronous bulk API import endpoints.
For custom events, read the custom event documentation
See the table below to find examples of modelled data:
Ecommerce | Services | Travel | QSR & Food Delivery | |
---|---|---|---|---|
User traits | locale, currency, lifetime value, order count | device, app version, session duration, subscription group, notification preferences | traveler status, age range, destinations, travel companions, booking channel | order history, favorite items, delivery address, dietary preferences, favorite restaurants, delivery instructions |
Custom events | product_viewed, product_added, checkout_started, order_completed, cart_abandoned | account_set, user_login, searches, feature_usage | destination_search, car_rental, booking_type, booking_date | menu_item_view, app_rating, menu_search, order_tracking, delivery_completed |
Use synchronized data
In a successful integration, Voucherify needs access to any relevant information at the right time. That's why it's important to set up the data scope and sync policies.
The Voucherify API can ingest and egress data, like product information or customer attributes to and from other systems in real-time and at scale. This, together with a flexible schema editor and auto-complete inputs in the Dashboard, makes creating new promotion scenarios less error-prone. It'll help you ensure data integrity if you have many product-specific discounts or want to trigger incentives based on aggregated customer attributes.
The next step is to plan the frequency of data synchronization. Since Voucherify can work with real-time traffic, this may affect your subscription plan's monthly API call usage.
Data volume estimation
Voucherify works in a pay-as-you-grow pricing model: the price grows with the API usage. If you want to estimate the total cost of ownership in the long run, you may want to calculate API usage with assumptions about your growth.
Initial data migration might be an API-heavy operation. To reduce the impact on pricing, Voucherify provides bulk API endpoints.
Depending on your data volume or security policies, your account may require additional activities from the Voucherify team. One of them is setting up a dedicated cluster near your customers. This can impact the pricing significantly, so remember to provide this information to your Technical Account Manager.
API usage and availability
Besides API usage, you should define your minimum availability requirements. These will be included in a custom SLA.
Data privacy
For security reasons, you may not want to synchronize and maintain customer or product details in Voucherify. In this case, you can send the necessary business context with a validation request and Voucherify will calculate the discount. As a result, the "meaning" will be offloaded to the "source of truth" system.
Universal approach of Voucherify
Voucherify's API is universal. If you've already integrated the redemption or validation endpoints into your checkout for discount codes, you can easily run other campaign types, like gift cards or referrals. This requires no additional input from your tech team, significantly lowering the costs of extending Voucherify's use.
The same applies to various discount types and effects. Your technical team won't need to make any changes to the integration if you want to run new discount types, such as amount-based instead of percentage-based discounts.
Voucherify's API is universal. If you've already integrated the redemption or validation endpoints into your checkout for discount codes, you can easily run other campaign types, like gift cards or referrals. This doesn't need any additional effort from the technical team, which significantly lowers the costs associated with extending Voucherify usage.
The same applies to various discount types and effects. Your technical team won't need to make any changes to the integration if you want to run new discount types, such as amount-based instead of percentage-based discounts.
Voucherify partners
Voucherify partners with leading Solution Integrators that can help you build and maintain promotions and loyalty programs.
Updated 1 day ago