- DarkLight
Yotpo Loyalty & Referrals Settings Section Guide
- DarkLight
This is an overview of all the settings available in your Yotpo Loyalty & Referrals account.
Access these settings:
In the Yotpo Loyalty & Referrals main menu go to Settings.
General settings
Account
Contact email
This is the email address that will receive all relevant email notifications and reports.
Default Currency
This is your account's base currency - all the rewards and discounts will be shown using this currency. It will also be used to reflect cost and revenue across your Loyalty & Referral dashboards.
Timezone
This affects the timezone of the Campaign Scheduling settings.
Program
Membership opt-in strategy
Choose how customers get opted into your Loyalty program. Customers must be opted-in to earn points, enter VIP Tiers, or redeem rewards. Learn more about Loyalty Opt-in.
If you update your opt-in rule, your existing customers will not be affected. The new rule will only be applied to customers who join after the rule is changed.
Please note:
We recommend reaching out to your CSM or to customer support to get expert advice and assistance before changing your opt-in rule.
Referring customers are automatically opted into loyalty
This setting will not appear if you choose "all customers are opted in" as your loyalty opt-in rule.
If your loyalty opt-in rule is "all customers are members" or "API/SDK only", then the default is Yes.
Read more about Loyalty Opt-in
Platform-specific settings
Shopify & Shopify Plus
Include shipping and taxes in order total - Decide if you want to award points for the taxes and shipping costs or only the cost of the products before taxes and shipping.
Award points when order is marked as - This means orders will not be shown on your admin until they meet the order status you choose here. This tells Yotpo both when to “pull” the order and when to award points for that purchase.
Shopify discount combinations - Allow customers to combine discounts. Read more about Creating Discount Combinations
Settings available only on Premium and Enterprise plans:
Exclude product IDs from earning rewards (comma-separated list) - The amount of money spent on excluded products won't be processed. Read more about Product Exclusions on Shopify
Exclude collection IDs from earning rewards (comma-separated list) - IDs entered here will be excluded from all campaigns. Read more about Collection ID Exclusions on Shopify
Exclude or include specific customer tags - If you want to only include specific customers in your loyalty program, or exclude specific customers from your loyalty program - you can use the customer tags field. A customer who is excluded from the loyalty program will be opted out of loyalty. An example of this might be if you want to exclude employees from campaigns. Read more about how to include/exclude specific customers
Adobe Commerce 1 & 2
Order paid state (regex) (Default: Processing|complete)
You can fill in the order status that gets pulled into Yotpo and triggers the points to be awarded to the end user.Order paid status (regex) (Default: -*)
Click to read on Magento's site the difference between order state and order statusProcess order with state (regex) (Default: Processing|complete)
Any delayed point deduction redemption option will be applied when this order status is processed.Process order with status (regex) (Default: -*)
Click to read on Adobe commerce site what order processing meansWhen calculating order total use... (Default: "Total after discounts including shipping and tax")
Decide if you want to award points for the taxes and shipping costs or only the cost of the products before taxes and shipping.Refunds (non configurable)
Points refunds are calculated based on the total amount paid for the order, including taxes and shipping costs, regardless of the "When calculating order total use" setting.
BigCommerce
Award Points When Order Status Matches... (Default: Any PAID)
Status Merchants can choose the order status that gets pulled into Yotpo and triggers the points to be awarded to the end-user. Read more about BigCommerce's order statusesProcess checkout discounts when order status matches... ("awaiting shipment")
Any Delayed Point Deduction redemption option will be applied when this order status is pulled. Read more about BigCommerce's order processing flow
When calculating order total use (Default: total after discounts excluding tax)
Decide if you want to award points for the taxes and shipping costs, or only the cost of the products before taxes and shipping.
Settings available only on Premium and Enterprise plans:
Exclude or include specific customer groups (Default: only exclude customers in group IDs listed below) Read more about inclusions/exclusions by platform.
SFCC
Award Points when order status matches... (Default: NEW)
This means orders will not be shown on your admin until they meet the order status you choose here. This tells Yotpo both when to “pull” the order and when to award points for that purchase.
Settings available only on Premium and Enterprise plans:
Exclude product IDs from earning rewards (comma-separated list)
Exclude or include specific customer groups (Default: only exclude customers in groups listed below). Make sure your customer group does not include the following characters: [ ]"/
Read more about customer groups on SFCC
Generic
Account registration URL
This is the link to your "sign up" page where users should be re-directed when they click on a create account/register link
Account Login URL
This is the link to your "log in" page where users should be re-directed when they click on a link to log into their account.
Order paid status (regex)
Read more about order statuses on generic platforms
We recommend using paid, as this is when we will remove the points used for the discount at checkout.Process order with status (regex)
We recommend you use awarded, as this is when we will process the purchase through the active campaigns.
Points expiration period
Available for:
Yotpo Loyalty & Referrals Pro, Premium, and Enterprise plans.
Choose if you want your customer's points to expire after:
A certain amount of time since they were last active
Or
A certain amount of time after the date on which the points were earned
To learn more about points expiration, see Setting up Points Expiration
Program analytics
The Program ROI and Loyalty Performance dashboards show program performance and participation data.
You can choose how to define a redeeming customer:
Customers who made a purchase using a loyalty reward: A customer is considered a redeemer if they made at least one purchase that includes a loyalty discount code in the order details.
Customers who made a purchase within 24 hours of redeeming a loyalty reward: A customer is considered a redeemer if they complete a purchase within 24 hours of making a redemption. We recommend choosing this option if you are using a POS loyalty interface. To learn more about POS, go to Omnichannel: Store Associate Managed Loyalty (POS loyalty interface).
Please note:
If you switch from one redeemer definition to another, it will take up to 24 hours for the performance dashboards to update the displayed data.
Integrations
API Key and GUID
When installing Yotpo Loyalty & Referrals on your eCommerce platform or integrating with a third-party application, your Loyalty & Referrals API Key and Global Unique Identifier, or GUID are required to properly sync your account and data.
Webhook URL
Available for:
Yotpo Loyalty & Referrals Premium and Enterprise plans.
This is the URL where Yotpo Loyalty & Referrals events will be sent. These events can trigger transactional emails, supplement customer data in your CRM, or anything else you could imagine.
Once a URL is provided, Yotpo will send all event notifications to this webhook URL. If you wish to continue receiving notifications for specific events, a 200 response must be sent in return to the relevant event.
For example – a "points reminder" event can be sent to the webhook which, in turn, can be sent out a generically integrated ESP.
Please note:
You can add multiple webhooks and separate them with a semicolon (;)
This field only supports https:// type URL
Webhook Authentication
Available for:
Yotpo Loyalty & Referrals Premium and Enterprise plans.
You can choose to create an authentication key that will be checked and verified whenever events are sent to the URL defined in the Webhook URL field. This is aimed at providing an additional level of security for the webhook interactions between your store and Yotpo.
The key can be up to 255 characters long and does not include any character limitations.
You can also choose to leave this field blank - this will not harm webhook activity in any way.
Fraud prevention settings
To access your settings related to fraud prevention, do the following:
Log in to your Loyalty & Referrals admin.
Click Settings > Fraud Prevention.
There are several security settings you can choose to enable. For full details about security settings, please reach out to your CSM or customer support.