Yotpo Loyalty & Referrals Settings Section Guide
    • Dark
      Light

    Yotpo Loyalty & Referrals Settings Section Guide

    • Dark
      Light

    Article summary

    Products


    Loyalty & Referrals

    Supported plans

    Free, Pro, Premium, Enterprise

    eCommerce Platform

    N/A

    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 status

    • Process 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 means

    • When 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 statuses

    • Process 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:

    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:

    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:

    1. Log in to your Loyalty & Referrals admin.

    2. 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.


    Was this article helpful?