Skip to main content

Shopify

Integration​

Shopify

Integrate TrueBeep into your Shopify store to reward customers with loyalty points and seamless digital wallet passes. This guide walks you through installing the app, configuring settings, setting up a loyalty program, and enabling Apple Wallet/Google Wallet integration. Follow the steps below to manage customer wallet points during checkout in a user-friendly way.

Installation​

  1. Go to the Shopify App Store and search for "TrueBeep".
  2. Click on the "Add app" button to install the TrueBeep app.
  3. Follow the on-screen instructions to complete the installation.

No coding is required for basic setup, the app provides a built-in interface to manage loyalty points and wallet integration. After installation, proceed to configure your API connection and loyalty settings as described below.

Connect TrueBeep to Shopify​

To connect TrueBeep to your Shopify store, add the API URL and API Key in the TrueBeep settings.

  • Use https://api.truebeep.com/v1 as the API URL.
  • Enter your API Key generated from the TrueBeep dashboard.

Add Wallet Pass​

To add a wallet pass for your customers, navigate to the TrueBeep dashboard and follow these steps:

  1. Navigate to the Wallet Pass section.
  2. Copy wallet pass ID.
  3. Paste the wallet pass ID into the Wallet Template ID field in the TrueBeep settings.
tip

Learn more about Wallet Passes.

Loyalty Settings​

  • Open Loyalty Program settings: In the TrueBeepify app, go to the Loyalty Program tab. Here you’ll see options for redemption methods, coupons, point conversion rates, and tiers.

  • Choose a redemption mode: Under Ways to redeem, select either Dynamic Coupon or Coupon as the method for customers to redeem points:

  • Dynamic Coupon: Customers can enter any amount of points to redeem. The app will generate a one-time discount code on the fly, matching the points to a discount value automatically.

  • Coupon: Customers redeem points for preset coupon values. You will create fixed-value coupons (e.g. $5 off, $10 off) that customers can claim using their points.

  • Define coupon rewards (if using Coupon mode): If you chose Coupon as the redemption mode, set up your list of coupon rewards.

  • Set point earning and redemption values: Configure how points correspond to purchase amounts:

    • Earning Value: Enter how many loyalty points a customer earns per $1 spent. For instance, setting “Order Amount to Points Conversion” to 1 means a customer earns 1 point for every $1.00 they spend.
    • Redeeming Value: Enter how much discount (in $) a customer gets per point when redeeming. For example, if you set “Points to Amount Conversion” to 0.01, then 100 points would equate to $1.00 discount. (A setting of 1 would mean 1 point = $1 discount, which is a very high reward rate – adjust these values to balance your program.)

  • Allow or disallow points on discounted orders: Decide whether customers earn points on orders where they redeemed points. Toggle Earn Points on Redeemed Orders based on your preference:

    • If enabled (checkbox ticked), customers will still earn loyalty points on an order even if they used a coupon/points to get a discount on that order.
    • If disabled, orders where points are redeemed will not generate new points (commonly used to prevent “double-dipping” on rewards).

  • Configure loyalty tiers (optional): Set up tiered reward levels to encourage more engagement. Tiers like Bronze, Silver, Gold, Platinum or any name you like:

    • You can Add new tiers or edit existing ones. For each tier, define criteria for reaching that tier (such as total points earned or total spending) and the benefits. For example, higher tiers might earn points at a faster rate (e.g. Silver members earn 1.5 points per $1) or get better redemption rates.
    • Each tier can have its own point earning multiplier or special perks. Ensure the tiers progress logically (Bronze being entry-level, Silver for more loyal customers, etc.).

App Embed​

To embed the TrueBeep app in your Shopify theme, follow these steps:

  1. Go to your Shopify admin panel.
  2. Navigate to Online Store > Themes.
  3. Click Customization on your active theme.
  4. In the customization panel, look for the App Embed section.(probably at the bottom of the left sidebar)
  5. Enable TrueBeep Floating Button and save your changes.

After saving, a floating button will appear on your store, allowing customers to access their loyalty points and wallet passes easily.

App Blocks​

You can also add the TrueBeep App Blocks to your Shopify store to display loyalty points and wallet passes in specific locations. To do this:

  1. Go to your Shopify admin panel.
  2. Navigate to Online Store > Themes.
  3. Click Customization on your active theme.
  4. On the top bar, click on Home Page then select Checkout and customer accounts.
  5. Look for the App section (at the bottom of the left sidebar).
  6. Click the add button next to TrueBeep App Block and select the block you want to add.