Connect your Loop Subscriptions account to Mage to reward your subscribers. This integration lets customers exchange points for discounts on their subscription renewals, and lets you award bonus points when subscribers hit renewal milestones.
Before you start
You need:
Loop Subscriptions installed and active on your Shopify store
A Mage Starter plan or above
Admin access to your Loop dashboard so you can generate an API token
1. Generate an API token in Loop
You'll create a token in Loop and paste it into Mage. The token tells Loop that Mage is allowed to read subscriptions and apply discounts on behalf of your customers.
Log in to your Loop Subscriptions dashboard.
Click Settings in the bottom-left menu.
Under the Admin section, click API Tokens.
Click Generate New Token.
Give it a name like Mage Loyalty.
Select the following scopes. This step is critical. Without these, the integration will not work:
Read customers, so Mage can see your subscribers.
Read subscription contracts, so Mage can list a customer's active subscriptions and check their completed order counts.
Write subscription contracts, so Mage can apply a customer's points discount to their subscription.
Read and write webhooks, so Mage gets notified when a subscription renews.
Click Generate Token.
Click Show Token and copy the value. You'll paste this into Mage in the next step.
Keep this token safe. Anyone with the token can access your Loop data, so don't share it.
2. Connect Loop to Mage
Go to the Integrations page in your Mage admin.
Find the Loop card and click Manage.
Paste your Loop API token into the field.
Click Connect Loop. Mage will check the token with Loop and save it once it's verified.
You should now see the Loop card showing as Connected. If you see an error, double-check that you copied the full token and that all four scopes are enabled in Loop.
3. Reward your Loop subscribers
With Loop connected, you can reward your subscribers in two ways: let them spend their points on a discount applied to a subscription renewal, and award them bonus points when they reach a renewal milestone you set.
Set up the Flexible Redemption block
The Loop integration powers the Apply to subscription button on the Flexible Redemption block. This lets customers exchange their points for a custom-value discount and apply it directly to one of their subscriptions, instead of using it as a one-time code at checkout.
Open the Flexible Redemption block in your theme editor or Mage admin.
Turn on "Show apply to subscription".
Check your flexible reward's purchase type. It must be set to Subscription or Both. A one-time reward cannot be applied to a subscription, so the Apply button will stay hidden if the reward is set to One-time only.
Save.
What customers see
When a signed-in customer with an active Loop subscription opens the Flexible Redemption block:
They use the slider to choose how many points to exchange.
They can click Redeem for a one-time discount code at checkout, or Apply to subscription to add the discount to a subscription renewal.
When they click Apply to subscription, a dialog opens showing their active Loop subscriptions. They pick one, confirm, and Mage applies the discount automatically to the next renewal.
If a customer doesn't have any active subscriptions, the dialog will let them know there's nothing to apply the discount to.
How the discount respects your reward settings
The discount that lands on the subscription follows everything you configured on the flexible reward. That includes:
Minimum spend
How many renewals the discount runs for, such as the next payment only, the next three, or all renewals
Product or collection restrictions
Discount combinations
So if you set your reward to "Limit discount to the first payment", customers who apply it to a subscription will only see the discount on their next renewal.
Reward subscription milestones
The subscription milestone earning rule awards bonus points when a customer reaches a chosen number of completed subscription orders. With Loop connected, the rule fires automatically the moment one of your Loop subscribers hits the threshold you configured.
Go to Earning Rules in your Mage admin.
Add or edit the Subscription Milestone rule.
Set the renewal threshold (for example, 3 completed orders) and the points to award.
Make sure the rule is Active and save.
How the count works. Mage uses Loop's own count of completed orders as the source of truth, so the threshold counts every successful subscription order the customer has had with Loop. The milestone fires on the exact renewal that brings the customer's count to your threshold. Customers who were already past the threshold when you turned the rule on will not be retro-awarded.
Disconnecting Loop
Go to the Integrations page.
Find the Loop card and click Manage.
Click Disconnect and confirm.
Discounts that have already been applied to subscriptions stay in place and Loop will keep honouring them at renewal. Future customer point exchanges to subscriptions and subscription milestone awards are blocked until you reconnect.