Rivo and Skio integration explained
The Rivo and Skio integration seamlessly connects your loyalty program with subscription orders, creating a unified customer experience. This powerful integration includes:
Points earning and spending - Customers automatically earn loyalty points on subscription orders and can redeem rewards toward future subscription purchases
Auto-apply advocate discounts - Referral rewards are automatically applied to active subscriptions without manual discount code entry
Auto-apply redeemed rewards - Discount and free product rewards are automatically applied to your customers’ active subscriptions when they redeem on the loyalty page
Subscription milestone rewards - Reward customers with points when they hit a subscription order milestone (e.g., their 3rd subscription order)
Subscription count rewards - Reward customers with points when they have a set number of active subscriptions at the same time
Custom loyalty data display - Show points balance, available rewards, and referral information directly in the Skio customer portal
This integration ensures your customers enjoy a consistent loyalty experience across both one-time and subscription purchases, maximizing engagement and retention.
✨ Integrations are available on paid plans with integration access. See pricing →
Getting Started with Skio Integration
Setting up the Rivo and Skio integration is straightforward and provides immediate benefits for your subscription customers. Follow these steps to get started:
Prerequisites
Active Rivo loyalty program on a plan with integration access
Skio subscription app installed and configured
Admin access to both Rivo and Skio dashboards
Basic Setup
Once Skio is installed, subscription orders can participate in your loyalty program automatically.
✅ Before you go live: Confirm your Order Settings include subscription channels, and set reward Purchase Type to include subscription orders where needed.
Earning points on Skio subscription orders
Customers automatically earn loyalty points for each subscription order placed through Skio, including both initial subscriptions and recurring renewals. This seamless integration ensures consistent point earning across all purchase types.
How Points Earning Works
Initial subscription orders - Points are awarded when the order matches your earning rule settings
Recurring subscription orders - Points are awarded on renewals when they match your earning rule settings
💡 Pro Tip: Always verify the channels that customers should be rewarded through in your Order Settings to ensure subscription orders are included in your earning rules.
Spending points on Skio subscription orders
Customers can redeem their loyalty points for rewards that apply to subscription purchases, creating additional value and encouraging subscription retention. This feature requires proper reward configuration to work seamlessly.
Setting Up Subscription Rewards
To enable point redemption for subscriptions, configure your rewards with the appropriate purchase types:
Navigate to your Rewards settings in Rivo
Edit existing rewards or create new ones
Set Purchase Type to Subscription or Both
Save your changes
How Customers Redeem Points
Once configured, customers can redeem points for subscription discounts through:
Rivo loyalty widget - Generate discount codes for subscription use
Skio customer portal - Apply discount codes directly to subscriptions
Loyalty emails - Find discount codes for rewards already redeemed
Using Rivo credits with Skio subscriptions
Rivo credits use a fixed amount discount reward. This is separate from earning or spending points, and it is also separate from the referral discount auto-apply flow.
Credits on a new subscription checkout
A new Skio subscription completes through checkout, so customers redeem credits through your usual Rivo redemption experience and apply the resulting discount to that order.
Before customers redeem, edit your Store Credit reward in Rivo and set Purchase Type to Subscription or Both. A Store Credit reward set to One-time Purchase cannot be used on a new subscription order.
Credits on recurring subscription orders
Recurring Skio orders process without another checkout. Customers therefore cannot enter a newly redeemed discount during renewal checkout. Connect Skio with a valid private API key, then choose one of these options under Integrations > Skio :
Auto-apply redeemed reward discount codes to next subscription order - After a customer redeems credits on your loyalty page, Rivo applies the fixed amount discount to their active Skio subscription automatically.
Show apply-to-subscription redemption button - Customers can choose to apply an eligible redemption to their upcoming subscription order from your loyalty page. Enter the Skio subscriber customer tag and add that Shopify customer tag to each customer who should see the button. This button is unavailable while auto-apply is enabled.
The recurring discount flow supports fixed amount, percentage, and free shipping rewards. Rivo credits use the fixed amount option. Free product rewards use the separate free product settings in the same Skio configuration.
These standard options do not require Rivo Support to enable them. Contact Rivo Support if the Skio settings are unavailable in your account or if you need a redemption experience beyond these options.
Show custom Loyalty data in your Skio account
Enhance your customers’ experience by integrating detailed Loyalty information into their Skio portal.
Custom blocks
🗓️ Note: The following steps require knowledge of custom code implementation
Use Skio’s custom embedded blocks to display relevant Loyalty custom data such as points balance and rewards, enhancing your loyalty program management.
From the Rivo Dashboard, go to Settings > Developer Toolkit
Switch the Rivo JavaScript API settings to
ONGo to your Skio Dashboard, and click Customer Portal > Portal Settings
Scroll down to Custom Block
Copy the example code snippets below and paste it into your embedded block settings
Click Save in your Skio portal settings.
We have 3 options for the Skio custom block
Rewards & Referrals Block
Rewards Block
Referrals Block
Get the code for each below!
📝 Note: You can change the Referrals heading copy directly in the HTML of these snippets when you're adding it, to replace the default text 'Refer a friend and get $10 off'
Code Snippets
#
Rewards & Referrals Block
This block features the user’s points balance, any available rewards, redeemable store rewards and their referral info.
Download code for this block
#
Rewards Block
This block contains the user’s points balance, available rewards and store rewards, redeemable on the page. The Referrals info is omitted in this block.
#
Referrals Block
This block contains the user’s referral info and omits the rewards elements
Custom Loyalty Data Display in Skio Portal
Enhance your Skio customer portal by displaying loyalty information directly within the subscription management interface. This feature allows customers to view their points balance, available rewards, and referral status without leaving the Skio portal.
Setting Up Custom Loyalty Blocks
Add custom HTML and CSS blocks to your Skio portal to display Rivo loyalty data:
Access your Skio dashboard and navigate to portal customization
Add custom HTML blocks using the provided code snippets
Choose from available block types:
Customize the styling to match your brand colors and fonts
Requirements for Loyalty Data Display
For loyalty blocks to function properly, ensure:
JavaScript API access - Your plan must include this feature, and it must be enabled in Rivo
Customer authentication - Customers must be logged into their Shopify account
Proper integration setup - Both Rivo and Skio apps must be properly configured
Troubleshooting
Not seeing your loyalty data displayed in the customer portal?
Rivo’s block uses our JavaScript API, which relies on the customer being logged into their Shopify account to display loyalty data. Since Skio uses a separate login system, logging into Skio alone won’t load loyalty data.
For non-Shopify Plus stores
The recommended login setup is:
Log into the store via the standard Shopify login page: /account/login
Then visit: /a/account/shopify-login
This will automatically log the customer into Skio using their existing Shopify session and redirect them to the subscription portal.
For Shopify Plus stores with Multipass
If your store is on Shopify Plus, uses legacy customer accounts, and has Multipass set up in Skio, customers who log in directly through Skio will also be recognized as logged into Shopify — so loyalty data will display without any additional steps.
Quick Setup: Add a Loyalty Page Button
For a simpler integration approach, use Skio’s custom button feature to add a direct link to your Rivo loyalty page. This provides customers with easy access to their full loyalty account without custom code blocks.
Setting Up the Loyalty Button
Navigate to your Skio portal settings
Add a custom button with your loyalty page URL
Customize the button text (e.g., “View Loyalty Rewards”, “Manage Points”)
Position the button prominently in your portal layout
💡 Pro Tip: This method is perfect for stores that want loyalty integration without custom coding. Customers can easily access their full loyalty dashboard while managing their subscriptions.
Auto-apply advocate discount to subscription orders
The auto-apply feature eliminates friction for your referral program by automatically applying advocate rewards to active subscriptions. When advocates complete referrals and unlock their rewards, the discount is seamlessly applied without requiring manual discount code entry.
Setting Up Auto-Apply Feature
This advanced feature requires API integration between Rivo and Skio. Follow these steps to enable it:
Navigate to Integrations in your Rivo dashboard
Select Skio in the Subscriptions section
Enter and save your Skio private API key
Enable Auto-apply advocate discounts to next subscription order
Click Save to activate the integration
How Auto-Apply Works
Once configured, the system works automatically:
Referral completion - When an advocate’s referral is completed, their reward is generated
Subscription detection - Rivo identifies the advocate’s active subscription with the earliest next billing date
Automatic application - The advocate discount code is sent to that subscription
✅ Seamless Experience: Advocates receive their rewards without any manual steps, improving satisfaction and reducing support inquiries.
Where to find my API key?
Your Skio API key enables secure communication between Rivo and Skio for the auto-apply feature. Follow these steps to generate and retrieve your key:
Log into your Skio dashboard
Navigate to API & Integrations > API
Enter a descriptive name for your API key (e.g., “Rivo Integration”)
Click Generate API Key
Click the chain/copy button to copy your new private key
Paste the key into the Rivo integration settings
🔐 Security Important: API keys can only be viewed once after generation. Copy and securely store your key immediately. If you lose it, you'll need to generate a new one.
💡 Pro Tip: Use a descriptive name for your API key to easily identify its purpose if you need to manage multiple keys later.
Auto-Apply requirements and behavior
Use this checklist to confirm auto-apply is configured correctly:
Enable auto-apply in your Rivo Skio integration settings
Add a valid Skio private API key
Make sure the advocate has an active subscription when their referral reward is unlocked
Make sure a referrer discount code is generated for that referral reward
When these requirements are met, Rivo applies the advocate discount to the customer’s active Skio subscription with the earliest next billing date.
Subscription Rewards and Earning Rules
Rivo gives you powerful tools to reward your subscription customers automatically — no discount code copy-pasting required. All of the features below require a valid Skio private API key saved in your Skio integration settings ( Integrations > Skio ). Enable auto-apply options in Skio settings and subscription earning rules individually. Your plan must include access to the earning rules you want to use.
⚠️ Important: Make sure your Skio private API key is entered before enabling any of the toggles below. Save your key to reveal the auto-apply settings. If the key is invalid, rewards cannot be applied to subscriptions.
Auto-add free product rewards to next subscription order
When a customer redeems a free product reward on your loyalty page, Rivo adds the product at no charge to their next subscription order. The free product is added for that order only and does not repeat on future renewals.
How to enable
Navigate to Integrations in your Rivo dashboard
Select Skio in the Subscriptions section
Enter and save your Skio private API key
Enable Auto-add free product rewards to next subscription order
Click Save
📝 Note: Free product rewards are added directly to the subscription. Customers do not need to apply a discount code for the free product.
Auto-apply redeemed reward discount codes to next subscription order
When a customer redeems a discount reward (fixed amount off, percentage off, or free shipping) on your loyalty page, Rivo automatically applies the discount code to their active Skio subscription. The discount will be applied to their next subscription order — customers no longer need to copy and paste a code at checkout.
Supported reward types: Fixed amount off, Percentage off, Free shipping
Use the reward’s Recurring Payment Options to control how many subscription orders receive the discount. Free product rewards are added to the next order only.
How to enable
Navigate to Integrations in your Rivo dashboard
Select Skio in the Subscriptions section
Enter and save your Skio private API key
Enable Auto-apply redeemed reward discount codes to next subscription order
Click Save
✅ Seamless Experience: When this is enabled, consider adding a note to your redemption confirmation like "Your reward will be automatically applied to your next subscription order." so customers know it's taken care of.
Things to know about auto-apply
The setting applies store-wide. Auto-apply covers every subscriber with an eligible reward and active subscription. There is no per-customer option to turn it off.
Remove applied discounts in Skio. Once a redeemed discount has been applied to a subscription, removing or refunding the reward in Rivo does not remove it from that subscription. Expiring or deactivating the code in Shopify also leaves the subscription discount in place. Remove the discount from the subscription in Skio.
Points are not automatically returned by default. After removing a discount, check the customer’s points activity in Rivo. If the points have not been returned and a refund is needed, manually add them back from the customer’s profile.
⚠️ Heads up: After Rivo applies a redeemed discount to Skio, its Shopify code is expired to prevent reuse. The discount remains on the Skio subscription until it is removed or its recurring payment limit is reached. Review your Skio cancellation settings if a customer cancels before the next order.
Subscription Milestone earning rule (Skio)
Reward customers with points when they reach a milestone number of subscription orders. This is a great retention tool — for example: “Earn 500 points when you complete your 3rd subscription order.”
Each customer can only earn a given subscription milestone once, even if more than one earning rule uses the same milestone.
How to set up
Navigate to Loyalty
Click Add Another Way to Earn and select Subscription Milestone
Set the number of subscription orders required to trigger the reward
Set the points amount to award
Enable the One-click integration enabled checkbox on the earning rule
Save the rule
Requirements:
Skio must be connected with a valid private API key
The One-click integration enabled checkbox must be enabled on the rule itself
💡 Use case: Reduce churn by rewarding long-term subscribers. Use a milestone at order 3 or 6 to give subscribers a reason to stick around and keep renewing.
Subscription Count earning rule (Skio)
Reward customers with points when they have a set number of active subscriptions at the same time. For example: “Earn 100 points when you have 2 active subscriptions.”
This rule fires when a new order comes in and the customer currently has at least the configured number of active Skio subscriptions. Each customer can only earn this reward once per earning rule.
How to set up
Navigate to Loyalty
Click Add Another Way to Earn and select Subscription Count Goal
Set the number of active subscriptions required to trigger the reward
Set the points amount to award
Enable the One-click integration enabled checkbox on the earning rule
Save the rule
Requirements:
Skio must be connected with a valid private API key
The One-click integration enabled checkbox must be enabled on the rule itself
💡 Use case: Encourage customers to expand their subscriptions. Reward customers who subscribe to multiple products to drive cross-sell and increase subscription revenue.
📝 Subscription Milestone vs. Subscription Count: Subscription Milestone counts the total number of subscription orders a customer has placed over time (great for retention). Subscription Count measures how many subscriptions a customer has active right now (great for expansion and cross-sell).
Resources
Not using Skio yet? Book a demo.
Frequently Asked Questions
Why wasn’t the advocate discount applied to my customer’s subscription?
Several factors can prevent automatic discount application:
Auto-apply is disabled in your Rivo Skio integration settings
Skio private API key is missing or invalid
No active subscription for the advocate when their referral reward is completed
No advocate discount code was generated for the referral
Temporary API connectivity issues between Rivo and Skio
Customers see errors when logging in with Multipass enabled. Why?
Confirm that your store uses Shopify Plus with legacy customer accounts, then review your Skio Multipass setup. Contact Skio Support if login errors continue.
Why is there a delay in points appearing for subscription orders?
Points processing can be delayed when:
The order is still processing in Shopify/Skio
Order data arrives later than expected due to temporary sync or webhook delays
Points are awarded after the order is available and meets your earning rule conditions. Also check any earning delay, payment or fulfillment requirements, and eligible order channels in your Rivo settings.
Can I customize the appearance of loyalty blocks in Skio?
Yes! The provided code snippets can be modified to match your brand:
CSS styling - Customize colors, fonts, and layout in the CSS files
Content text - Edit headings and labels directly in the HTML
Block selection - Choose from Rewards & Referrals, Rewards Only, or Referrals Only blocks
How does auto-apply work with customers who have multiple subscriptions?
Redeemed rewards normally apply to the active subscription with the earliest next billing date. If a redemption is made for a specific subscription, it applies there instead. Advocate referral discounts also apply to the active subscription with the earliest next billing date.
How can I monitor the health of my Skio integration?
Monitor integration performance through:
Rivo dashboard - Check integration status in Integrations
Customer feedback - Monitor support inquiries about missing points or discounts
Skio analytics - Review discount usage and subscription metrics
Regular testing - Periodically test the customer experience end-to-end
I have feedback about the integration
We’d love to hear from you! Please reach out to [email protected] with any feedback, suggestions, or feature requests.








