This page contains ready-to-use Connected Content scripts for common Voucherify use cases. Copy a script, replace the placeholder values, and add it to your Braze message template.The examples use the default API address https://api.voucherify.io. If your project is in a different region, change the endpoint accordingly.
All publication examples below use Voucherify publication source_id and Braze cache and retry parameters to limit API calls invoked by a Braze campaign.As a result:
A customer can’t receive different codes within the same Braze campaign.
If your Voucherify campaign uses the Customers can join campaign only once setting, remove source_id from the connected content body as described in Optimize your Connected Content scripts.
This script calls the Voucherify API to publish a unique code and send it in a Braze message. Each Braze user receives only one unique code.Use this snippet to distribute codes in the following scenarios:
Abandoned cart recovery
Braze user performs a custom event – reward for an achievement
Invite referrers to a referral program
Sending the same through multiple channels (for example, email and push)
This script generates a coupon with a custom prefix based on a customer attribute (for example, phone number or email) and then publishes it. The two-step process first creates the voucher, then assigns it to the customer.Use this snippet to distribute personalized codes in the following scenarios:
VIP welcome offers with recognizable, branded codes
Phone-number-based coupons for SMS campaigns where the code doubles as an identifier
Personalized codes for partner or co-branded promotions
Event-specific codes tied to customer attributes for easy tracking
This script retrieves all unredeemed discount coupons assigned to a Braze user (lines 15-19). It loops through the customer’s vouchers and displays only the ones that haven’t been used.Use this snippet to remind customers about available codes in the following scenarios:
Weekly or monthly “wallet” digest emails listing available coupons
Re-engagement campaigns reminding inactive users they have unused discounts
Post-purchase follow-ups nudging customers to use remaining codes
If you want to display unused codes from one campaign, add {% assign voucherify_campaign_id = "camp_XXXXXXXXXXXXXXXXXXXXXXXX" %}.Then, edit the URL to https://api.voucherify.io/v1/vouchers?customer={{customer_id}}&campaign_id={{voucherify_campaign_id}}&c={{source_id}} to display only the vouchers from this campaign.
Display unused coupon details: Snippets
Use this snippet to show additional details like the discount value for each voucher:
Display coupon with discount
Code: {{voucher.code}} — Discount: {{voucher.discount.percent_off}}% off
Use this snippet to display the expiration date for urgency:
List all codes and publish a new one if there are none
This script checks if a customer already has an available code from a specific campaign. If the customer has no codes, or if their most recent code was already redeemed, it publishes a new one. This ensures every message contains a valid, usable code.Use this snippet to guarantee a valid code in the following scenarios:
Always-on promotional campaigns where customers should always have an active code
Recurring campaigns where a new code is needed after each redemption
Win-back flows that check for an existing offer before generating a new one
Multi-touch nurture sequences where you want one active code per customer at all times
The script retrieves the vouchers from the campaign assigned to a customer (lines 1-14), then verifies if the customer has a voucher from the campaign or if a voucher was already redeemed (lines 16-34).
Prerequisite: Store incentive codes as custom attributesFor this script to work, you need to first assign a discount coupon, gift card, or referral code to a Braze user and save the code and expiration date as custom attributes.Read Distribute to Braze custom attributes to learn how to send Voucherify data as Braze custom attributes.
This script fetches an existing incentive code from the customer’s custom attributes and checks its status. If the code hasn’t been redeemed, the message reminds the customer to use it. If the code has been redeemed, the message acknowledges it. Build a customer segment based on the expiration date and target this message at that segment.Use this snippet to resend existing codes in the following scenarios:
Expiration reminder emails sent a few days before a code expires
Re-engagement campaigns for customers who received but never used a code
Multi-channel reminders (for example, push notification after an email)
Post-purchase follow-ups reminding customers about their remaining gift card or referral code
Resend codes
{% assign campaign_id = {{campaign.${dispatch_id}}} %}{% assign customer_id = {{${user_id}}} %}{% assign source_id = campaign_id | append: customer_id %}{% connected_content https://api.voucherify.io/v1/vouchers/{{custom_attribute.${incentive_name}}}?c={{source_id}} :method GET :headers { "X-App-Id": "12345678-90QW-ERTY-UIOP-asdfghjklzxc", "X-App-Token": "MNBVCXZL-KJHG-FDSA-POIU-ytrewq098765" } :save incentive%}{% if incentive.__http_status_code__ != 200 %} {% abort_message("Voucher does not exist") %}{% endif %}{% if incentive.redemption.redeemed_quantity == 0 %}You can still use the voucher {{incentive.code}} up until {{incentive.expiration_date}}{% else %}Your voucher {{incentive.code}} has been used.{% endif %}
Display resent code details: Snippets
To display the incentive code:
Incentive code snippet
{{incentive.code}}
To show the expiration date to create urgency:
Display expiration date
Your code {{incentive.code}} expires on {{incentive.expiration_date}} — use it before it's gone!
To display different messages based on redemption status:
Conditional redemption status
{% if incentive.redemption.redeemed_quantity == 0 %}You still have an unused code: {{incentive.code}}{% else %}Thanks for using your code!{% endif %}
Read the documentation of GET Get voucher endpoint to learn more about the response data.
Prerequisite: Send loyalty card code as a custom attributeFor this script to work, you need to store the loyalty card code as a custom attribute in Braze user’s profile.Read Distribute to Braze custom attributes to learn how to send Voucherify data as Braze custom attributes.
This script fetches the current loyalty balance from a loyalty card code stored as a custom attribute in Braze.Use this snippet in the following scenarios:
If you use pending points, display the number of points that are in the pending state:
Display loyalty card point pending points
{{member.loyalty_card.pending_points}}
If you send emails to remind users about their point balance, you can use the following template:
Remind users about their balance
Hi {{${first_name}}},You currently have {{member.loyalty_card.balance}} loyalty points!{% if member.loyalty_card.balance >= 500 %} You have enough points to redeem a reward. Visit your account to browse available rewards.{% else %} You're only {{500 | minus: member.loyalty_card.balance}} points away from your next reward!{% endif %}
Use the following template to message users about their progress in achieving loyalty tiers:
Tier-based messaging with conditional logic
{% if member.loyalty_card.balance >= 1000 %} As a Gold member with {{member.loyalty_card.balance}} points, you get early access to our seasonal sale!{% elsif member.loyalty_card.balance >= 500 %} You have {{member.loyalty_card.balance}} points — earn {{1000 | minus: member.loyalty_card.balance}} more to unlock Gold status!{% else %} Start collecting points today. Your current balance: {{member.loyalty_card.balance}}.{% endif %}
Read the documentation of GET Member endpoint to learn more about the response data.
Add loyalty points with a custom event earning rule
This script sends a custom event (lines 5-12) to Voucherify when a Braze message is delivered. The event triggers an earning rule in your loyalty campaign, which awards points to the customer. Different segments can receive different point amounts based on the earning rule configuration.Use this snippet to award loyalty points in the following scenarios:
Reward customers for opening or engaging with a campaign message
Award bonus points during double-points promotional periods
Grant points for completing a profile, survey, or onboarding step
Trigger milestone rewards when a customer reaches a segment threshold
The script sends a custom event to Voucherify with the customer’s source_id. Voucherify evaluates the event against your earning rules and awards points accordingly.To set this up:
Create a custom event schema in Voucherify under Project settings > Custom events.
Create an earning rule in your loyalty campaign that listens for this event.
Replace "Event Name" in the script with your custom event name.
Different earning rules can award different point amounts per segment, so you can run tiered loyalty campaigns from a single Braze message.
Read the documentation of POST Track custom event endpoint to learn more about the request and response data. Also, read Custom events to learn more about defining them.
Prerequisite: Send the gift card code as a custom attributeFor this script to work, you need to store the gift card code as a custom attribute in Braze user’s profile.Read Distribute to Braze custom attributes to learn how to send Voucherify data as Braze custom attributes.
This script adds credits to a customer’s gift card (lines 5-9). The gift card code is retrieved from a Braze custom attribute, and the specified amount is added to the card balance.Use this snippet to top up gift cards in the following scenarios:
Birthday or anniversary bonus credits
Compensation credits for a negative customer experience
Seasonal top-ups during holiday campaigns
Reward credits for completing a purchase or hitting a spending milestone
The "amount": 1000 is a value in the smallest currency units (for example, cents for USD or EUR).
This snippet can be also used for adding loyalty points to an existing loyalty card that’s assigned as a custom attribute to a user profile in Braze.
After adding credits, you can confirm the top-up in the message. The :no_cache attribute ensures the balance reflects the latest update.To notify the customer about the added credits:
Display added amount
We've added credits to your gift card: {{ balances.amount | divided_by: 100.0 }}Your current balance is: {{ balances.balance | divided_by: 100.0 }}.
Read the documentation of Adjust voucher balance endpoint to learn more about the request and response data.
date and time adjusted to the time zone: {{ voucher.expiration_date | time_zone: 'Europe/Warsaw' | date: "%d.%m.%Y %H:%M" }}
Adjust decimals
If you fetch a gift card balance or discount amount, Voucherify returns the value multiplied by 100. Divide by 100.0 to display the correct currency amount.For example {{ voucher.gift.balance | divided_by: 100.0 }} renders "balance": 10000 as 100.0If your country uses a comma (,) as a decimal separator, append replace: '.', ',' to the snippet:
Display added amount
We've added credits to your gift card: {{ balances.amount | divided_by: 100.0 | replace: '.', ',' }}Your current balance is: {{ balances.balance | divided_by: 100.0 | replace: '.', ',' }}.
