Recharge and Rivo integration explained

The Recharge and Rivo integration connects your loyalty program with your subscription business. This powerful combination allows you to offer rewards to subscription customers, auto-apply advocate discounts, and track points earned through subscriptions.

✨ Integration availability depends on your current Rivo plan. See pricing →

What does the integration do?

Create discounts in both Shopify Admin and Recharge, enhancing the subscription experience
Automatically apply advocate discounts to active subscriptions
Add points for new Recharge subscriptions using Shopify Flow
Sync discount codes between Rivo and Recharge

Importing Loyalty discounts to Recharge

Enable the Recharge integration with Rivo to create discounts in both your Shopify Admin and Recharge, enhancing the overall subscription experience for your valued customers.

💡 Pro Tip: Once connected and enabled, newly generated supported reward discount codes will automatically sync to Recharge.

From your Rivo Dashboard, go to Integrations
In the Subscriptions section, click on Recharge
Enter your private API key (Where to find my private API Key?)
Click Save
Optional: Activate the option to auto-apply advocate discounts to active subscriptions
Toggle the switch ON to enable the integration.

📝 Important Note: Rivo will automatically import all supported discounts to Recharge. As a merchant, you will be able to apply a discount to a subscription from the merchant portal and/or allow customers to add the discount to their subscription from the customer portal.

Supported discounts

Once imported to Recharge, each discount can be added to a recurring order via the customer portal or within the Recharge merchant portal.

Amount Discount
Percentage Off
Free Product
Free Shipping.

Important considerations

All Rivo rewards imported to Recharge will apply to one charge only
Most reward requirements, such as minimum cart requirement, apply-to, and expiration, are synced when the discount is imported
In Recharge, the minimum cart value (Minimum Cart Requirement in Rivo) refers to the subtotal before taxes and shipping are applied
If the Purchase Type is not set in your reward, discounts will be imported for one-time products. We recommend setting the purchase type to Both
All discounts imported will be applied on API, Checkout, Customer portal, Merchant portal
Discounts manually applied to recurring orders, through the merchant or customer portals, are not counted in the total number of uses
The Maximum Shipping Amount set for the Free Shipping reward won’t be synced

💡 Find out more: Read Recharge's complete guide on discounts here.

Auto-applying advocate discounts to active subscriptions

When advocates complete referrals and earn their rewards, Rivo can automatically apply these discounts to their active subscriptions without requiring any manual action. This leads to higher redemption rates and simplifies the subscription renewal process by eliminating the need for manual entry of discount codes.

📝 Note: You must have already connected your Recharge account to enable this feature.

From your Rivo Dashboard, go to Integrations > Recharge
Make sure you have already entered your private API key, then tick the checkbox option Auto-apply advocate discounts to active subscriptions
Click Save.
Once your advocates start earning rewards for referrals completed, you should be able to see the discount applied to their active subscriptions

Considerations

This feature is only available for advocate rewards within the Referrals program
The Purchase Type for your advocate reward must be set to Subscription or Both
Rivo applies the advocate discount to the customer’s next queued subscription charge when the customer has an active queued charge in Recharge
Your private API key needs to grant permission to Read and Write Access to Discounts & Orders
If no queued subscription charge is found, or the Recharge API request fails, the discount won’t be applied

Auto-add free product rewards to subscriptions

You can also enable automatic free product handling for subscription customers.

From your Rivo Dashboard, go to Integrations > Recharge
Tick Auto-add free product rewards to next subscription charge
Click Save

When enabled, redeemed free product rewards are added to the customer’s next queued subscription charge in Recharge.

Adding points for a new Recharge subscription

Enhance your subscription model and make every interaction a rewarding experience for your valued customers.

✨ Custom Action availability depends on your current Rivo plan. You also require Shopify Flow, which is available on supported Shopify plans.

1. Create a Custom Action

From your Rivo Dashboard, go to Programs > Points
Click Add Another Way to Earn
Select Custom Action in the Ways to Earn prompt
Fill in all the fields on the page
Click Save and continue with the workflow setup.

2. Create a workflow in Shopify Flow

💡 Time-saving tip: Click here to download our pre-made template to use. Just make sure to update the Custom Action Name.

From your Shopify Admin, go to Shopify Flow
Click the Create workflow button on the upper right side of the page
Click Select a trigger , and then select Order created under Shopify triggers
Click Then + to create a new step and click Condition. Make sure that the condition is set to If all conditions are met and click Add criteria
Under Shopify API, click Order > customer and select productSubscriberStatus
Make sure the Product subscriber status is set to Equal to ACTIVE
Click Then + on the condition box to create a new step and click Action
Under Installed App Actions, click Rivo: Loyalty & Referrals and select Add Points for a Custom Action
For Customer Identifier , enter ####{{order.customer.email}}
For Custom Action Name , enter the exact name of the Custom Action set in Rivo
Optional: Enter a new points amount in the Points Amount Override field if you want to override the points amount set in the app
Optional: Tick the Skip Email box if you want to skip the Rivo email Points Earned
Change the name of the workflow if preferred and once satisfied, click Turn on workflow to activate it.

📝 Note: Both the Custom Action and Shopify workflow must be enabled.

Finding your Recharge Private API Key

From your Recharge Admin Portal, go to Apps > API Tokens
Click Create an API Token or Create an Admin API Token
Fill out the token Details : Internal name and your preferred contact email
Under Permissions , make sure to select:
Tick the option I have read and agree with Recharge’s API Terms of Service
Click Save to generate the API key (sk_111111111...)

🗓️ Important: API keys can only be viewed once after creation. If you need to reconnect, you'll need to create a new API key.

Common questions

Is Rivo able to import historical discounts generated before implementing the Recharge integration?

No. Once you have enabled the integration for the first time, Rivo will start importing to Recharge the discounts dynamically generated within the Loyalty program.

Why was the advocate discount not applied to my customer’s subscription?

Here are some reasons for not adding the advocate discount to a subscription:

The customer doesn’t have any active subscriptions
Another discount was already applied to the subscription
The advocate incentive was not set to apply to either ‘Both’ or ‘Subscription’ purchase type
There was an issue with connecting to the Recharge API

What types of discounts are supported?

The integration supports multiple discount types: