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 three main components:
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
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 the Purchase Type to include “Subscription orders”
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
Email campaigns - Use discount codes from loyalty emails
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 Publish on your Skio portal.
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 enabled - Rivo’s JavaScript API must be active on your store
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 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
Find Skio in the Subscriptions section and click Configure
Enable the checkbox Auto-apply advocate discounts to active subscriptions
Enter your Skio private API key (Where to find my API Key?)
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 most recent active subscription
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 Account > 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 most recent active Skio subscription.
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?
This typically occurs when the Login redirect URL is configured to point to the Skio customer portal. To resolve:
Leave the redirect URL empty to use Skio’s default portal redirect
Or configure a custom redirect URL that properly handles the authentication flow
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.
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?
The system automatically applies discounts to the customer’s most recent active subscription. If you need different behavior, customers can manually apply discount codes to specific subscriptions through the Skio portal.
How can I monitor the health of my Skio integration?
Monitor integration performance through:
Rivo dashboard - Check integration status in Settings > 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.








