Skip to main content

Shopify POS Guide

Use Mage Loyalty inside Shopify POS to see a customer's points or store credit, redeem it at the till, apply rewards and adjust balances.

Written by Amelia Hanes

Getting Started

Mage Loyalty works inside the Shopify POS app, so your staff can see a customer's points or store credit, redeem it, and manage their account without leaving the checkout.

Once Mage Loyalty is installed, you'll see a Mage Loyalty tile on your POS home screen. Add a customer to the cart and the tile shows their balance. Tap it to open their loyalty details, where you'll see:

  • Available points (or Available credit): what they can use right now

  • Redeemed: how much they have spent so far

  • Pending: points or store credit earned recently that becomes usable soon

  • Don't see the tile? Head to POS Settings > Home Screen > Add Tile and look for Mage Loyalty.

  • Customer profiles. You can also see a customer's balance and VIP tier when you open their profile in POS.

  • Staff access. Each staff member who uses Mage Loyalty in POS needs access to the Mage Loyalty app in their Shopify staff permissions. If a staff member sees "Failed to load loyalty data", check their app access first.


Redeeming Store Credit or Points at the Till

If your customers choose how much to redeem (store credit, or a points redemption where they pick the amount), your staff can turn their balance into a discount and add it to the current sale in a few taps.

To redeem store credit or points:

  1. Build the sale. Add the items and the customer to the cart.

  2. Open Mage Loyalty. Tap the Mage Loyalty tile on the home screen.

  3. Start the redemption. For store credit, tap Redeem Store Credit. For points, tap Redeem Reward, then Choose an amount.

  4. Check the amount. It's filled in for you with the most the customer can use on this sale. You can change it to anything between your minimum and maximum. For points, you'll see the discount it gives as you type.

  5. Confirm. Tap Redeem and apply.

The discount is added to the cart straight away and you're taken back to the sale. Take payment as normal.

Good to know:

  • Existing discounts. If your reward can't be combined with other discounts and the cart already has one, you'll be asked to remove it first. Nothing is taken from the customer's balance.

  • Amounts above the cart total. You'll see a warning if the amount is more than the cart subtotal. Anything above the subtotal isn't used, so lower the amount to save the rest for next time.

  • If the discount doesn't add to the cart. The discount code is shown on screen with a Try again button. It's also saved under Customer Rewards, so you can apply it later.

  • Customers who already redeemed online. If a customer redeemed their store credit or points on your website, find the code under Customer Rewards and tap it to add it to the sale.


Redeeming Rewards

If your program uses points, you can redeem any of your set rewards on behalf of a customer, such as a $10 off reward or free shipping. Store credit programs use Redeem Store Credit above instead.

To redeem a reward:

  1. Build the sale. Add the items and the customer to the cart.

  2. Open Mage Loyalty. Tap the Mage Loyalty tile, then tap Redeem Reward.

  3. Choose a reward. Tap Redeem next to the reward. You'll see your regular rewards, plus any VIP tier rewards if you have VIP tiers turned on. Each reward shows its cost, and whether the customer has enough points.

  4. Review the summary. Check the customer's current balance, the reward cost, and their balance afterwards.

  5. Confirm. Tap Redeem and apply.

The discount is added to the cart straight away and you're taken back to the sale.

  • Just want the code? Turn off Apply to this sale before you confirm, then tap Create code. The code is shown on screen to give to the customer, and it's saved under Customer Rewards so it can be used later.

  • Giving a reward for free. To issue a reward without taking any points, turn on Give reward for free before you confirm.

  • Not enough points? You'll see a message letting you know. You can still go ahead by turning on Give reward for free.

  • Existing discounts. If the reward can't be combined with a discount already on the cart, you'll be asked to remove it first. No points are taken.


Viewing Customer Rewards

Customer Rewards shows the rewards a customer has redeemed, online or in store, with the ones they can use right now at the top.

To use a reward:

  1. Build the sale. Add the items and the customer to the cart.

  2. Open their rewards. Tap the Mage Loyalty tile, then Customer Rewards.

  3. Tap the reward. Under Ready to use, tap the reward you want. The discount is added to the cart and the reward shows In cart.

Each reward shows its name (for example "$15.00 off your order"), the discount code and when it expires. Rewards expiring within a week say so, for example "Expires in 3 days".

Used and expired rewards are tucked away underneath. Tap Show used or expired to see them, with the date each one was used or expired. Rewards a customer has applied to a subscription aren't shown here, because they're used on the subscription.


Points and Store Credit History

The history screen shows everything that has changed a customer's balance, both what they earned and what they spent, newest first, with their current balance at the top.

To view history:

  1. Open Mage Loyalty. Tap the Mage Loyalty tile.

  2. Open the history. Tap Points History (or Credit History if you use store credit).

Each entry shows what it was for, the amount and the date:

  • Earned: purchases, sign ups, drops and other ways to earn, shown with a plus sign

  • Redeemed: rewards the customer redeemed online or in store, shown with a minus sign

  • Added by staff or Removed by staff: manual adjustments, with any note your staff left

  • Pending: points or store credit that isn't usable yet, with the date it becomes available

  • Expired, Refunded or Rejected: points or store credit that no longer counts towards the balance

If a bonus campaign was running when the customer earned, you'll also see the campaign name and its multiplier (for example "2x").


Adjusting Points or Store Credit

You can add or remove points or store credit by hand, for example to fix a mistake or thank a customer for something that happened in store.

To adjust a balance:

  1. Open Mage Loyalty. Tap the Mage Loyalty tile.

  2. Start the adjustment. Tap Adjust Points (or Adjust Credit).

  3. Choose add or deduct. Select Add Points or Deduct Points (Add credit or Deduct credit for store credit).

  4. Enter the amount. Type a number of points, or an amount of money for store credit. As you type, you'll see their current balance, the change, and their new balance.

  5. Add a note (optional). Explain the reason. It appears in their history.

  6. Confirm. Tap the button to save.

The customer's balance updates straight away, and the adjustment counts towards their lifetime total. If you deduct more than they have, you'll see a warning and only their balance is taken. If you added points or store credit and your points earned email is turned on, the customer also receives an email letting them know.

Every redemption and adjustment made in POS is recorded in the customer's activity log and marked as a POS action, so you always have a clear record.

Did this answer your question?