Recharge and Rivo integration explained
The Recharge and Rivo integration connects your loyalty program with your subscription business. With it, you can reward subscription customers, auto-apply discount codes (advocate, redeemed reward, and free product) to upcoming charges, and award points for subscription activity.
✨ Integration availability depends on your current Rivo plan. See pricing →
What does the integration do?
Imports supported Rivo discount codes into Recharge so they can be applied to subscription charges
Automatically applies advocate discounts to active subscriptions
Automatically adds redeemed free product rewards to a customer's next subscription charge
Automatically applies redeemed reward discount codes to a customer's next subscription charge (beta)
Awards points for Recharge subscription activity, either via native subscription earning rules or via Shopify Flow.
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 grant Read and Write access to Discounts, Orders, Customers, Charges, and Addresses
Tick the checkbox I have read and agree with Recharge's API Terms of Service
Click Save to generate the API key (
sk_111111111...).
📝 Important note: API keys can only be viewed once after creation. If you need to reconnect, you'll need to create a new API key.
Importing Rivo 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. Once connected and enabled, newly generated supported reward discount codes will automatically sync to Recharge.
Setup steps
From your Rivo Dashboard, go to Integrations
In the Subscriptions section, click on Recharge
Enter your private API key
Click Save
Optional: Enable the auto-apply settings described in the sections below
Toggle the switch ON to enable the integration
📝 Important Note: Rivo will automatically import all supported discounts to Recharge. As a merchant, you'll 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 (either manually or automatically).
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 (minimum cart requirement, apply-to, expiration) are synced when the discount is imported
In Recharge, the minimum cart value 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, and 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.
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 any manual action. This leads to higher redemption rates and removes the need for manual discount code entry.
Pre-requisites
You must have already connected your Recharge account
Your private API key needs Read and Write access to Discounts and Orders.
Setup steps
From your Rivo Dashboard, go to Integrations > Recharge
Make sure you have already entered your private API key, then tick the checkbox Auto-apply advocate discounts to active subscriptions
Click Save
Once your advocates start earning rewards for completed referrals, the discount will be applied to their active subscriptions.
Important 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
If no queued subscription charge is found, or the Recharge API request fails, the discount won't be applied.
Auto-adding free product rewards to subscriptions
Rivo can automatically add a redeemed free product reward to a customer's next queued Recharge subscription charge, so the subscriber doesn't have to apply the reward manually.
💡 Learn more: For full walkthrough, eligibility, and troubleshooting, please see the dedicated article: Auto-add free product rewards to Recharge renewals.
Auto-applying redeemed reward discount codes to subscriptions
When a Recharge subscriber redeems a reward, Rivo can automatically apply the generated discount code to their next queued Recharge charge. This removes the need for subscribers to copy and paste discounts into their subscriptions.
📝 Note: This is separate from the advocate discount setting above as it covers reward redemptions from the Loyalty program.
How it works
Applies to Amount Discount, Percentage Off, and Free Shipping rewards. Free Product rewards are handled by the separate "Auto-add free product rewards to next subscription charge setting"
When a customer redeems an eligible reward, Rivo finds their earliest upcoming queued Recharge charge and applies the discount code to it
Once applied, the reward is marked as "Used" in Rivo.
Pre-requisites
You must have already connected your Recharge account
Your Recharge API key must have Read and Write access to Customers, Charges, and Addresses
As this feature is still in beta, please consult with your CSM before enabling.
Setup steps
From your Rivo Dashboard, go to Integrations > Recharge
Tick the checkbox Auto-apply redeemed reward discount codes to next subscription charge
Click Save.
Important considerations
Only one discount can apply to a Recharge charge. If the customer's next queued charge already has a discount code applied, Rivo won't overwrite it. The customer must apply the discount manually
The reward applies to the next queued charge only, not future renewals
The customer must be linked across Rivo and Recharge (same external customer ID).
Earning Points on Recharge Subscriptions
Rivo offers two ways to award points for subscription activity.
1. Native Recharge subscription earning rules (recommended)
Powered by Rivo's direct Recharge integration.
Ways to Earn available
Subscription milestone – Award a one-time bonus when a customer completes a configured number of successful Recharge charges (for example, "500 points after their 3rd subscription renewal")
Subscription count – Award points based on a subscription count threshold.
Pre-requisites
Your Recharge integration must be connected.
Setup steps
From your Rivo Dashboard, go to Programs > Points > Add Another Way to Earn
Select the relevant subscription-earning rule (Subscription milestone or Subscription count)
Configure the points amount and the milestone/threshold
Click Save.
📝 Note: Points are awarded from successful Recharge subscription charges.
2. Shopify Flow + Custom Action (legacy)
Still supported for merchants who want fully custom logic, or whose use case isn't covered by the native rules. Custom Action availability depends on your current Rivo plan, and you'll also need Shopify Flow.
Setup steps
Create a Custom Action:
From your Rivo Dashboard, go to Programs > Points
Click Add Another Way to Earn
Select Custom Action in the Add Ways to Earn modal
Fill in all the fields on the page
Click Save and continue with the workflow setup.
Create a workflow in Shopify Flow:
From your Shopify Admin, go to the Flow app
Click Create workflow on the upper right side of the page
Click Select a trigger, then select Order created under the "Shopify" triggers
Click the + button on the trigger box to create a new step, and click Condition
Click Add variable
In the modal, click order > customer > productSubscriberStatus
Make sure the status is set to Equal to ACTIVE
Click the + button on the "True" condition to create a new step, and click Action
Click Rivo Loyalty Rewards Referrals > 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 checkbox if you want to skip Rivo's native Points Earned email notification
Rename the workflow if preferred. Once satisfied, click Turn on workflow to activate it.
📝 Important note: Both the Custom Action and the Shopify Flow workflow must be enabled.
💡 Time-saving tip: Click here to download our pre-made template to use. Just make sure to update the Custom Action Name.
Common questions
Is Rivo able to import historical discounts generated before implementing the Recharge integration?
No. Once you've enabled the integration for the first time, Rivo will start importing the discounts dynamically generated within the Loyalty and Referrals programs from that point onward.
Why was the advocate discount not applied to my customer's subscription?
A few common reasons:
The customer doesn't have any active subscriptions
Another discount was already applied to the upcoming charge
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.
Why wasn't a redeemed reward discount code applied to my customer's subscription?
A few common reasons:
The customer's next queued Recharge charge already has a discount code applied. Rivo won't overwrite it
The customer has no upcoming queued Recharge charge
The reward isn't an eligible type (Amount Discount, Percentage Off, or Free Shipping). Free Product rewards are handled by the dedicated free-product setting
Your Recharge API key doesn't have the required permissions on Customers, Charges, and Addresses.
What's the difference between "next queued charge" vs "future renewals"?
In Recharge, every active subscription has a queue of upcoming scheduled charges:
Next queued charge – The single upcoming Recharge charge that's already scheduled and sitting at the top of the queue. This is the one that will actually process on the customer's next billing date
Future renewals – Every recurring charge scheduled after the next queued charge (e.g. the ongoing subscription billing cycles further out).
The auto-apply settings (advocate discounts, redeemed reward codes, free product rewards) only attach the discount/product to the next queued charge (one charge only). Subsequent renewals are charged at the regular subscription price unless another discount is applied.