Connect your Stay AI subscriptions account to Mage to reward your subscribers. This integration lets customers exchange their points for discounts on their subscription renewals, and lets you award bonus points when subscribers reach renewal milestones.
Before you start
You need:
Stay AI installed and active on your Shopify store with Admin access to the dashboard.
A Mage Essential plan or above
1. Create an API key in Stay AI
Log in to your Stay AI dashboard.
Go to Account, then API Tokens.
Click New API Key.
Give it a name like Mage Loyalty.
Select the following permissions. This step is important. Without them, the integration will not work: Read Subscriptions, Write Subscriptions, Read Webhooks, Update Webhooks, and Delete Webhooks.
Create the key and copy it. You will paste this into Mage in the next step.
2. Connect Stay AI to Mage
Go to the Integrations page in your Mage admin.
Find the Stay card and click Manage.
Paste your Stay API key into the field.
Click Connect Stay. Mage will validate the key and save it once it is verified.
You should now see the Stay card showing as Connected. If you see an error, double-check that you copied the full key and that the permissions above are enabled in Stay.
3. Reward your Stay AI subscribers
With Stay connected, you can reward your subscribers in two ways:
Spend their points on a discount applied to a subscription renewal with flexible redemptions.
Award them bonus points when they reach a subscription renewal milestone you set.
Set up the Flexible Redemption block
The Stay 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 Stay 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 Stay subscriptions. They pick one, confirm, and Mage applies the discount automatically to the next renewal.
If a customer does not have any active subscriptions, the dialog will let them know there is 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 Stay 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's subscription has renewed a chosen number of times. With Stay connected, the rule fires automatically the moment one of your Stay 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.
Under Milestone, choose 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. The milestone fires on the exact renewal that brings the subscription to your milestone, and subscriptions that were already past the milestone when you turned the rule on are not retro-awarded.
Disconnecting Stay AI
Go to the Integrations page.
Find the Stay card and click Manage.
Click Disconnect and confirm.
Discounts that have already been applied to subscriptions stay in place and Stay will keep honouring them at renewal. Future customer point exchanges to subscriptions and subscription milestone awards are blocked until you reconnect.
Frequently asked questions
Which subscriptions can my customers apply discounts to?
Any of their active Stay subscriptions. When a signed-in customer chooses Apply to subscription, Mage shows their active subscriptions and they pick the one to discount.
Do subscription milestones count orders from before I turned the rule on?
No. The milestone fires on the renewal that brings a subscription to your exact milestone. Subscriptions that were already past the milestone when you switched the rule on are not awarded retroactively. New subscribers, and existing subscribers who have not yet reached the milestone, are awarded when they reach it.
Why do my customers not see the "Apply to subscription" button?
Check that the Stay card shows as Connected, that "Show 'Apply to subscription' button" is turned on for the block (Flexible Redemption or Ways to Redeem), that the reward's purchase type is Subscription or Both (not One-time), and that the customer is signed in and has an active Stay subscription.
What plan do I need?
A Mage Essential plan or above.
What happens to existing discounts if I disconnect Stay?
Discounts already applied to subscriptions stay in place and Stay keeps honouring them at renewal. Disconnecting only stops new point-to-subscription discounts and new milestone awards until you reconnect.