Voucherify App is an application that allows you to manage loyalty campaigns using the Voucherify platform. The app integrates with the Voucherify dashboard, allowing users to manage their loyalty points, vouchers and rewards in one place.
Voucherify App offers several main views that allow users to use different functionalities:
- Home: The main view where users can track their loyalty points balance, select rewards based on the number of promotional points, view vouchers they have, and join the Voucherify plan to earn additional rewards.
- Deals: A section where users can view and manage their vouchers that have been awarded automatically.
- Rewards: In this view, users can view and manage the rewards they have earned on the home page through collected promotional points.
- Card: A section that allows users to scan their vouchers and rewards using a barcode.
- Burn: In this view, we can select available rewards from the 'Loyalty Program - earn and burn' program, a view visible only to this loyalty program.
The Voucherify app is intended to demonstrate basic functionality in conjunction with the Voucherify POS (Point of sales) app, such as purchasing products, receiving discounts and rewards, and generating promotions.
Important
Please note that this configuration applies to a specific scenario, specific campaigns and the specific Voucherify account that is connected to the application. Otherwise, the application's behavior may be unpredictable.
The application currently supports two loyalty programs:
- Loyalty Program
- Loyalty program - earn and burn
The application checks which campaign is currently active and supports it. If two campaigns are active, the user is informed about this fact and must select one of the two (in the dashboard or POS application) for the application to start working properly. The concepts of each of the two loyalty campaigns are described below.
The configuration consists of two campaigns, the purpose of which is to accrue points depending on the products purchased in the second application - POS Voucherify.
- Main Campaign: For every 150 points earned in this campaign, the user receives 1 promotional point.
- Promotional campaign: Promotional points can be redeemed for prizes in the Voucherify app. 1 point equals one prize. The "Choose reward" button informs the user about the availability of a reward that he can generate by receiving a voucher available in the Rewards tab. The reward can then be redeemed by scanning the barcode in the POS Voucherify app.
Voucherify Plan is an optional plan available to application users that allows you to automatically burn loyalty points for rewards using the "Auto redeem" functionality.
The mechanism is implemented by interacting with the API of the Voucherify platform. The application communicates with Voucherify endpoints to download data about the user's points and the history of his activity.
"Auto redeem" allows users to automatically redeem loyalty points for rewards. Once a user reaches a minimum of 300 points in the main loyalty campaign, their points will automatically be burned down to zero and the reward will be awarded. This process is handled asynchronously and automatically, without the need for user interaction. The main assumption of this functionality is that the user does not have any promotional points on his account.
- Checking the status of points: After each point update, a webhook is sent to the front layer via WebSockets, and then the points are recalculated.
- Checking the user's activity history: After confirming a sufficient number of points in the main campaign (300), we query the List customer activity endpoint to determine whether the last event was the assignment of a reward to a customer. If so, Auto redeem is performed automatically.
The configuration consists of one main loyalty campaign and several additional ones for awarding rewards. In the main campaign, we calculate points in a similar way to the 'Loyalty program', but here we do not use the 'Auto redeem' functionality. We use promotional points for prizes in a separate 'Burn' view, where if you have points, the appropriate prizes will be displayed.
- Checking the status of points: After each point update, a webhook is sent to the front layer via WebSockets, and then the points are recalculated.
Important
Remember to check if a webhook endpoint is active. If not - please activate him again to properly work the application.
Segment is a tool that we integrate with our application to effectively manage user data and the purchasing process. Thanks to the Segment, we can send data from the Voucherify and POS applications to one central place, where they are processed and further transferred to the Voucherify platform. One of many events is user verification.
When a user logs in or registers, identification data is sent to Segment, which then creates a user in the Voucherify platform. Then we query the Get customer endpoint to check whether the user already exists in the system and log in or register the user.
Braze is a tool we use to communicate with users through the Voucherify app. It allows you to send personalized messages informing users about rewards won and other important events.
When a user achieves a specific event, such as winning an award, the Voucherify app sends the appropriate information to Braze. Then, configured campaigns or canvases in Braze manage this information, sending personalized messages to users through the app.
- Segment https://segment.com/docs/connections/find-writekey/
- Braze
- Voucherify https://docs.voucherify.io/docs/authentication
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=x1x2x3
Segment
SEGMENTIO_SOURCE_WRITE_KEY=
Braze
NEXT_PUBLIC_BRAZE_API_KEY=
NEXT_PUBLIC_BRAZE_SDK_ENDPOINT=
Voucherify
VOUCHERIFY_API_URL=
VOUCHERIFY_APPLICATION_ID=
VOUCHERIFY_SECRET_KEY=
git clone https://github.com/voucherifyio/voucherify-pot-mobile.gitnpm installnpm run dev