Loop Returns + Rivo Integration Guide
There are two ways Rivo integrates with Loop Returns: Store Credit Sync (automatic) and Accounts Widget (returns portal redirect). These can be used independently or together.
Integration 1: Shared Shopify Store Credit Ledger (Automatic)
How it works
When a merchant uses Shopify native store credit as their ledger type in Rivo, any store credit issued by Loop Returns is automatically reflected in Rivo. No setup required beyond enabling the same ledger type.
Both Rivo and Loop write to the same Shopify store credit ledger via Shopify's GraphQL API. Rivo's service queries Shopify for all store credit accounts and transactions regardless of which app issued them. This means:
A customer returns an item through Loop and receives $14.03 in store credit + $2.59 bonus credit
Shopify records both as store credit transactions on the customer's account
Rivo automatically picks up these balances during its next sync cycle
The customer sees their full, accurate store credit balance in both the Rivo widget and at checkout
Setup
In Loop: toggle on "Allow Native Store Credit." This enables the store credit option in the Loop store admin under General > Store Credit > Enable Shopify Store Credit.
In Rivo: Ensure the shop's
credits_ledger_typeis set toshopify_store_credit. Rivo will sync balances from Shopify automatically.
What gets synced
Store credit refunds from returns
Bonus credit from Loop
Both are tagged on the customer in Shopify and appear as separate transactions in the store credit ledger
Because Shopify is the source of truth, the balance is always consistent. Whether a customer earned credit through Rivo rewards, Loop returns, or manual admin adjustments, it all lives in one place.
Integration 2: Rivo Accounts Widget with Loop Returns Portal
How it works
The Rivo Accounts widget can display a "Start a Return" button on each order, linking directly to the merchant's Loop Returns portal. Customers initiate returns without leaving the account experience.
Setup
In the Rivo admin, go to Accounts > Orders Settings
Enable Returns
Set Order Returns Partner to Loop Returns
Enter the merchant's Loop subdomain (e.g.
brandnameforbrandname.loopreturns.com)
Rivo automatically constructs the Loop Returns URL using the order name and shipping ZIP code, so the customer lands directly on their return flow.
Additional Options
Reach out to the Rivo team if you want these additional options configured.
Setting | Description |
| Only show the return button on fulfilled orders |
| Customize button text (default: "Start a Return") |
| Show a separate button for international returns |
| URL for the international returns portal |
| Route specific tagged orders to a different return URL |
| The alternate URL (supports |
Alternative Returns Use Case
If a merchant uses Loop for domestic returns but a different provider (e.g. Refundid) for international or currency-specific returns, the alternative_returns_order_tag setting lets them tag orders (e.g. EU-ORDER) and route those to a different returns URL automatically.
Recommended Setup
For the best experience, enable both integrations:
Store Credit Ledger ensures balances stay in sync across Loop and Rivo without any manual work
Accounts Widget gives customers a seamless way to initiate returns from their account page
The customer journey: open account widget > view order > click "Start a Return" > complete return in Loop > receive store credit > see updated balance in Rivo widget and at checkout. All automatic.