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 the Scale and Plus plans. 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 Scale or Plus plan
Skio subscription app installed and configured
Admin access to both Rivo and Skio dashboards
Basic Setup
The core integration (points earning and spending) works automatically once both apps are installed. No additional configuration is required for basic functionality.
β Automatic Setup: Points earning on subscription orders is enabled by default - your customers will start earning points immediately on their subscription renewals.
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 customers first subscribe
Recurring subscription orders - Points are automatically earned on each renewal
Subscription modifications - Points are earned when customers upgrade or modify their subscriptions
π‘ 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
π‘ Learn More: Complete guide to setting up rewards for subscription orders
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
ON
Go 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'
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:
Rewards & Referrals - Complete loyalty overview with points, rewards, and referral information
Rewards Only - Focus on points balance and available rewards
Referrals Only - Display referral program status and sharing options
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 Payments 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 discount code is applied directly to the subscription
Confirmation - The applied discount appears in the customer's Skio account
β 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 Feature Considerations
Understanding how the auto-apply feature works helps you set proper expectations and avoid common issues:
Discount Application Behavior
Timing - Discounts are applied to the customer's most recent active subscription immediately after the referral reward is issued
Subscription targeting - The system automatically identifies and applies discounts to the advocate's active subscription
One-time application - Advocate discounts apply to the next subscription billing cycle only, then are automatically removed
Discount Stacking Rules
Advocate discount limits - Only one advocate discount can be active on a subscription at a time
Other discount compatibility - Advocate discounts can combine with other discount types if discount stacking is enabled in both Rivo and Skio
Discount usage tracking - Skio marks advocate discounts as "used" once applied, even if later removed
Subscription Lifecycle Impact
Renewal behavior - Advocate discounts are automatically removed after the discounted billing cycle
Manual removal - If you manually remove a discount before renewal, update the discount's maximum usage count to allow future use
Subscription changes - Discounts remain applied through subscription modifications (upgrades, downgrades)
π‘ Pro Tip: Enable Skio's 'Surprise & Delight - Discount (Email)' feature to automatically notify customers when advocate rewards are applied to their subscriptions, improving transparency and satisfaction.
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:
Existing advocate discount - Only one advocate discount can be active per subscription
Conflicting discounts - Other discounts may block application if discount stacking isn't enabled
No active subscription - The advocate must have an active subscription at the time of reward generation
API connectivity issues - Temporary connection problems between Rivo and Skio
Invalid discount code - The generated discount code may have expired or reached usage limits
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 may be delayed due to:
Order processing time - Skio needs to fully process the subscription order first
Webhook delays - Communication between Skio and Shopify may have slight delays
System processing - Rivo processes points in batches for optimal performance
Points typically appear within 15-30 minutes of order completion.
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.