How to Integrate Loop Returns with Loyalty: The Complete Setup Guide

When you integrate Loop Returns with loyalty in Mage, you move the most stressful part of the post-purchase journey to the one place shoppers already trust: their own customer account. No order-number hunting. No "where do I even start a return" email to support. A "Start a return" link simply appears on eligible orders, and one click hands the customer to Loop with everything pre-filled. This guide walks through exactly how that connection works, how to set it up, and why the account sidebar is the right home for returns.

Most brands treat returns as a separate destination, a standalone portal living off in its own corner of the site. That split is exactly what generates the confused emails. Mage closes the gap by surfacing returns inside the Shopify customer accounts sidebar your shoppers visit to check orders, reorder, and manage their details.

Key Takeaways

• Connecting Loop Returns to Mage puts a "Start a return" link on every eligible order directly inside the customer account sidebar.
• Selecting that link sends the customer into your existing Loop returns flow with their order details already filled in, so there are no lookups or separate email logins.
• After a return is underway, customers can see its current status and jump to the Loop status page from the same sidebar.
• Setup is two short steps: connect Loop with an API key on the Integrations page, then enable returns in your Account Sidebar settings. No code required.
• The Mage customer account sidebar is an Enterprise-tier feature, and this integration works with Mage Accounts, not the loyalty points engine.

Why returns belong inside the customer account

Here is the part most teams underestimate. The moment a shopper decides to return something, they are already a little frustrated, and the very next thing you ask them to do sets the tone for whether they ever buy again. Send them to a disconnected returns portal that demands an order number and an email, and you have added friction at the worst possible moment.

Returns are not an edge case. For a lot of apparel and footwear brands, a meaningful slice of every order eventually comes back, and each one of those journeys either rebuilds confidence or quietly erodes it. We think of the account sidebar as the natural front door for that journey because it is where the order already lives. The customer is logged in, the order history is right there, and the system already knows which items are eligible.

There is a retention angle too, not just a support one. A clean, self-serve returns experience is one of the strongest signals that a brand is easy to do business with, which is exactly the trust that underpins repeat purchases. We have written before about how loyalty mechanics and post-purchase experience together help reduce Shopify refund and return rates, and a frictionless returns flow is a core part of that same customer retention story. Returns handled well are a retention event, not a loss event.

A quick note on scope, because it matters for who this is for. The customer account sidebar is an Enterprise-tier capability in Mage, and this particular integration sits on the Mage Accounts side of the platform. It is not part of the loyalty points engine. You are not awarding points for a return or routing returns through VIP tiers here. You are giving shoppers a self-serve way to start and follow a return from inside the account they already use.

How the Mage and Loop Returns integration works

Once Loop is connected, the experience is almost invisible to the merchant and completely obvious to the shopper, which is the point. Three things happen on their own.

First, a "Start a return" link appears automatically on every eligible order in the account sidebar. You do not place it manually order by order. Mage checks eligibility and shows the link only where it belongs, on orders that still have items available to return. Orders with nothing left to return simply will not show it, so customers never chase a dead end.

Second, selecting that link sends the customer straight into your Loop returns flow with their order details already filled in. No order lookups. No re-entering an email to log in. The handoff carries the order context across, so the shopper lands on a page that already knows what they bought.

Third, once a return is underway, the same sidebar becomes the tracking surface. If a customer already has a return on an order, the sidebar shows its current status and links straight to the Loop status page so they can follow it. The account they used to start the return is the same account they use to watch it progress.

It is worth being precise about the division of labor here, because this integration does not change how returns actually work. Loop continues to handle the returns and exchanges process exactly as it does today. Mage is the doorway and the status window; Loop is the engine room.

Setting up the integration step by step

Setup happens in two phases. First you connect your Loop account to Mage, then you switch returns on inside your sidebar settings. Neither phase touches code.

Before you start

You will need two things in place: a Loop Returns account that is active on your Shopify store, and a Mage plan of Starter or above (with the customer account sidebar available on the Enterprise tier). Have access to both your Loop admin and your Mage admin handy, because you will move between them once.

Step one: connect Loop Returns

The connection is keyed to an API key you generate in Loop, so start there.

In your Loop admin, generate an API key. Go to Returns Management, then Tools and integrations, then Developer Tools. When you create the key, enable the Orders and Returns scopes. Those are the permissions Loop attaches to the key, and Mage needs both to read order eligibility and to surface return status. Copy the API key once it is created.

Now switch to Mage. In your Mage admin, go to the Integrations page, find the Loop Returns card, and click Manage. Paste your API key and click Connect Loop Returns. Mage checks the key with Loop, and once it confirms, the card shows as Connected along with the date you connected it. You can always find this alongside your other connections on the integrations page.

Step two: turn on returns in the sidebar

Connecting the account does not flip the link on by itself. You tell the sidebar where to send customers.

In your Mage admin, go to Account Sidebar, then Settings, then Orders. Turn on Enable returns. Under Returns destination, select Loop Returns. That option only becomes available once the integration is connected, so if it looks greyed out, the connection in step one has not gone through yet. Save your settings.

That is the whole job. Eligible orders in the account sidebar now show a "Start a return" link that opens your Loop returns flow, and you never touched a line of code. If you ever need to step back, you can disconnect from the same Loop Returns card on the Integrations page; just remember to point your Returns destination at another option (Shopify or a custom link) afterward so the sidebar still has somewhere to send people.

The payoff: fewer tickets, more retained revenue

Let me be blunt about where the value lands. The biggest immediate win is the support inbox. A huge share of returns-related tickets are not complaints at all; they are logistics. "How do I return this?" "What's my order number?" "Where's the returns page?" When the answer to all three is a link sitting on the order itself, those tickets mostly stop being written. Self-serve is not a downgrade in service here, it is a better experience that happens to cost you less to deliver.

The second win is quieter and arguably bigger. Loop Returns exists to turn returns into exchanges and keep revenue inside the business rather than refunding it back out. The smoother and faster the path into that flow, the more shoppers actually reach the moment where an exchange or store credit is on the table. Friction is the enemy of an exchange; every extra login or lookup is a chance for the customer to give up and just demand the refund. By starting the return one click from the order, you protect the part of the journey where revenue gets retained.

There is a compounding effect on top of that. A returns experience that feels effortless reinforces the broader relationship, which feeds directly into customer lifetime value and the retention loops a strong Shopify loyalty program is built to drive. The contrarian point we will stand behind: making returns easier does not increase your return rate in any way that hurts you, it increases the share of those returns you convert into exchanges and the share of those customers who come back. Hiding the returns process to suppress returns is a false economy; it just trades a few avoided returns for a lot of lost trust.

Best practices for a clean returns experience

A few habits keep the integration working the way it should.

Keep Loop as the single source of truth for the actual returns logic. Because the integration sends customers into your existing Loop flow unchanged, your eligibility windows, exchange options, and policies all stay governed in one place. Configure them in Loop, and the sidebar respects them.

Mind the scopes when you generate the API key. The Orders and Returns scopes are what let Mage check eligibility and read status. If the "Start a return" link or status display ever misbehaves, the key's permissions are the first thing to check.

Treat the sidebar settings as the on or off switch. If the Returns destination shows Loop Returns as greyed out, the integration is not connected yet; finish the Integrations-page connection first. And if you ever disconnect Loop, immediately set the Returns destination to another option so customers are never left without a path.

Finally, look at returns as part of your whole account experience, not a bolted-on utility. The same sidebar that surfaces returns is where shoppers reorder, track, and manage their profile, and the more coherent that surface feels, the more it carries weight in retention. If you want to see how it fits together end to end, the Loop Returns integration page lays out the full picture.

Frequently Asked Questions

How do I integrate Loop Returns with customer accounts in Mage?

To integrate Loop Returns with customer accounts, generate an API key in your Loop admin with Orders and Returns scopes, then paste it into the Loop Returns card on Mage's Integrations page and connect. Finally, go to Account Sidebar, Settings, Orders, enable returns, and choose Loop Returns as the destination.

Does Mage award loyalty points for returns through this integration?

No, this integration does not award loyalty points, VIP status, or rewards for returns. It works on the Mage Accounts side of the platform, not the loyalty points engine. Its job is to give shoppers a self-serve way to start and track a return from inside their account sidebar, sending them into your existing Loop flow.

Why does the "Start a return" link not appear on some orders?

The "Start a return" link only appears on orders that still have items eligible for return. Mage checks eligibility automatically and hides the link on orders with nothing left to return, so customers never click into a dead end. If a return already exists, the sidebar shows its status instead.

Where do customers track a return once it is started?

Customers track returns from the same account sidebar where they started them. If a customer already has a return on an order, the sidebar shows its current status and links straight to the Loop status page. The actual return is completed and managed inside your Loop returns flow.

Do I need a special Mage plan to use the customer account sidebar?

The customer account sidebar is an Enterprise-tier feature in Mage, while connecting Loop Returns itself requires a Starter plan or above. To surface the "Start a return" link and status inside the account sidebar specifically, you will need the sidebar, which is part of the Enterprise tier.

Does connecting Loop Returns change how my returns are processed?

No, connecting Loop Returns does not change how returns are processed. The integration simply sends customers into your existing Loop returns flow with their order details pre-filled. Loop continues to handle returns and exchanges exactly as it does today; Mage only provides the entry point and the status view.

TLDR

When you integrate Loop Returns with customer accounts in Mage, a "Start a return" link appears automatically on every eligible order in the account sidebar, sending shoppers into your existing Loop returns flow with their order details pre-filled and no lookups or extra logins, then showing the return's status in that same sidebar afterward. Setup is two no-code steps: connect Loop with an Orders-and-Returns-scoped API key on the Integrations page, then enable returns and pick Loop Returns under Account Sidebar settings. The result is fewer logistics support tickets, a self-serve post-purchase experience, and a smoother path into the exchanges that keep revenue in the business. Note that the account sidebar is an Enterprise-tier feature and this works with Mage Accounts, not the loyalty points engine, so it does not award points or VIP rewards for returns.