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 Essential 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 Subscriptions 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 start a subscription or 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, it 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 Mage admin: click Loyalty Pages, open Landing Page, then click Flexible Redemption.
Turn on "Show 'Apply to subscription' button".
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.
Apply other rewards from the Ways to Redeem block
The Apply to subscription button is also available on the Ways to Redeem block, for fixed amount, percentage and free shipping rewards.
In your Mage admin, click Loyalty Pages, open Landing Page, then click Ways to Redeem.
Turn on "Show 'Apply to subscription' button" and save.
Check each reward's purchase type. It must be set to Subscription or Both.
When a signed-in customer redeems one of these rewards, they can click Apply to subscription, pick one of their active Loop subscriptions and confirm. The discount follows the same reward settings listed above. If your program runs on store credit, customers redeem through the flexible reward only, so the Flexible Redemption block is the one to use.
Reward subscription milestones
The subscription milestone earning rule awards bonus points when a customer starts a subscription or when their subscription has renewed a chosen number of times. With Loop connected, the rule fires automatically the moment one of your Loop subscribers reaches the milestone you set.
Click Loyalty in your Mage admin.
Click Add Earning Rule and choose Subscription Milestone, or open the Subscription Milestone rule you already have.
Choose the Milestone. Pick When a subscription starts to reward the order that starts the subscription, or After a number of renewals and enter the number in Renewals. For example, 2 renewals rewards the customer's third subscription order. Then set the Amount 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, which includes the order that started the subscription. The milestone fires on the exact order that brings the subscription to your milestone. Subscriptions that were already past the milestone when you turned the rule on will not be retro-awarded. The start reward is given for subscriptions created at your checkout, so subscriptions imported or migrated into Loop do not earn it.
Disconnecting Loop
Go to the Integrations page.
Find the Loop Subscriptions 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.