Multi-Currency Loyalty & Referrals Setup on a Custom or Generic eCommerce Platform
- DarkLight
Multi-Currency Loyalty & Referrals Setup on a Custom or Generic eCommerce Platform
- DarkLight
Article summary
Did you find this summary helpful?
Thank you for your feedback
Our multi-currency feature allows shoppers to fully experience your shop and loyalty program in their local or preferred currency.
Before you start
- Make sure Yotpo Loyalty & Referrals is fully integrated with your eCommerce platform.
- Make sure to implement redemption by API for real-time coupon creation and have one set of coupons that support all the relevant currencies.
Please note:
When sending order and refund data, it’s important to make sure the data is set in the shopper’s chosen currency.
Multiple loyalty admins
If you have several stores, each with its own currency and loyalty admin, simply go to the Settings tab of your Loyalty & Referrals admin and choose the currency relevant to you.
This will affect all the campaigns, rewards, on-site modules, and Loyalty & Referrals Dashboards.
Single admin
Setting a loyalty exchange rate
To get started with a single admin setup, you’ll need to establish the loyalty exchange rate between your default currency and all the other currencies available in your shop.We recommend setting a “round” and stable exchange rate that will translate better across currencies to display the loyalty program in a more consistent manner.
For example:If the Yotpo admin default currency is set to USD and the shop has both EUR and MEX, you can establish the following loyalty exchange rate:
- $1 = 1 EUR.
- $1 = 20 MEX.
Once the exchange rate has been established for all the relevant currencies, please contact your Yotpo representative and share this list with them.
Please note:
We recommended not to change these exchange rates too often so as not to create an incoherent experience for shoppers who frequently visit your shop
Earning points
Yotpo Loyalty & Referrals will use the exchange rate you provide to first convert the sum to the default currency set in your loyalty admin, and then calculate how many points are earned with each purchase.
Example:
- Default admin currency: USD.
- Loyalty exchange rate for EUR is 1 (i.e. 1 USD = 20 MEX).
- The Points for Purchases campaign is set to a 1 point per 1 USD ratio.
Yotpo receives an order in the amount of 800 MEX, which is then converted to 40 USD. This means that the shopper will be awarded 40 points for the purchase.
Redeeming points
Discounts will be created in the currency used by the shopper. Merchants can choose to reward shoppers with fixed amount rewards or variable redemption.
Example:
- Default admin currency: USD.
- Loyalty exchange rate for MEX is 20 (i.e. 1 USD = 20 MEX).
- The variable redemption ratio is set to 10 points = 1 USD off.
A customer wants to redeem 50 points (worth $5 off), so we create a discount of 5x20= 100 MEX on the platform.
Refunds
When a refund is created in the platform, we calculate the number of points to deduct using the same loyalty exchange rate that applied when the purchase was made, even if the exchange rate has since been changed.
Every exchange rate you set will be saved and used retroactively in case of refunds.Example:
- An 800 MEX purchase is to receive a partial refund of 200 MEX.
- The points ratio was set to a 1 point per 1 USD ratio at the time of purchase. This means that the shopper was awarded 40 points for the purchase.
The currency loyalty exchange rate may have changed from 20 MEX to 22 MEX per 1 USD, however, the loyalty exchange that will be used to calculate the point deduction will remain 20 MEX.
This means that the shopper will receive a 10 USD refund (200:20=10) and a deduction of 10 loyalty points.
Multi-currency placeholders
To display the different currencies to your shoppers, placeholders must be added to the following elements of your Loyalty & Referrals admin:
- Campaigns and coupons.
- On-site modules.
These placeholders will dynamically convert the default currency set in your Loyalty admin into the shopper’s local currency on your site, in webhook events, and within your Loyalty admin.
Customer page view
The placeholders allow for the shopper information in the customers’ section of your admin to display in accordance with the currency chosen by them. If a purchase or redemption occurred in euros, it will also be displayed in euros on their profile page.
The Total Spend amount for the customer, however, will be displayed in the default currency set within your Yotpo admin.
The page now includes a LoyaltyExchange Rate column to make it easier to understand why a shopper earned a specific amount of points.
You can add placeholders in campaigns and coupon text fields to dynamically display the texts in the shopper currency on-site, in the customer history, and in events sent to your ESP.
Please note:
Yotpo Loyalty and Referral’s triggered emails do not support multi-currency.
Campaigns
Let’s go over the relevant campaigns and their related placeholders.
Points for purchases campaign
Use the {{local_currency_spend}} placeholder to dynamically display the changing currency.
This means that instead of showing “Earn 1 point for every $1 you spend in our store”, the description will dynamically change in accordance with the currency the shopper is viewing and in relation to the exchange rate you have set.
Goal spend campaign
Use the {{local_currency_goal_spend}} placeholder to dynamically display the relevant currency in the campaign.
This means that instead of showing “Spend Over $100 ”, the placeholder will use the number you have set in the Gold Spend field and the description will dynamically change in accordance with the currency the shopper is viewing.
The conversion will be made according to the exchange rate you set. 
Use the {{local_currency_friend_reward}} and {{local_currency_reward}} placeholder in the Title filed to dynamically display the relevant currency in the campaign.
This means that instead of showing “Give $10, Get $10”, the placeholders will use the rewards you have set in Reward the referred customer with and Reward the referrer with fields of your Referral campaign settings.
The conversion will be made according to the loyalty exchange rate you set.
Referral campaign
Use the {{local_currency_friend_reward}} and {{local_currency_reward}} placeholder in the Title filed to dynamically display the relevant currency in the campaign.
This means that instead of showing “Give $10, Get $10”, the placeholders will use the rewards you have set in Reward the referred customer with and Reward the referrer with fields of your Referral campaign settings.
The conversion will be made according to the loyalty exchange rate you set. 
Coupons
The multi-currency feature can be used in the following coupons:
- Generic Fixed Amount.
- Generic Variable.
Add the {{local_currency_reward}} in the Name field the coupon to dynamically display the currency used by the shopper.
This means the placeholder will use the amount you have set in the Discount Amount field and convert it in accordance with the currency the shopper is viewing. 
You will also see the discount amount reflected in the coupon name within the coupons page of your Loyalty admin.
Make sure to add the placeholder to all relevant coupons.
On-site modules
Implementing a data div with the data-cart-currency attribute is required for the modules to identify the selected currency on-site in real-time. Add this following div above the module code, on every page where it is implemented.
<div
id="yotpo-loyalty-cart-data"
data-free-product-points="100"
data-cart-currency=”USD”
data-applied-coupon-points="100"
data-cart-id="12345"
data-has-paid-product="false"
data-has-free-product="true">
</div>
You must implement the data div so that the currency attribute will dynamically change according to the currency used by the shopper.
To see a full list of placeholders and how to apply them within all the different modules, click here.
Was this article helpful?
