Skip to main content

Skio integration

Integrate Skio with Rivo to bring loyalty closer to subscriptions

Written by Laurence Leech
Updated over a week ago

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.

Place An Order earning rule


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:

Purchase Type setting
  1. Navigate to your Rewards settings in Rivo

  2. Edit existing rewards or create new ones

  3. Set the Purchase Type to include “Subscription orders”

  4. 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.

  1. From the Rivo Dashboard, go to Settings > Developer Toolkit

  2. Switch the Rivo JavaScript API settings to ON

  3. Go to your Skio Dashboard, and click Customer Portal > Portal Settings

  4. Scroll down to Custom Block

  5. Copy the example code snippets below and paste it into your embedded block settings

  6. 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:

  1. Access your Skio dashboard and navigate to portal customization

  2. Add custom HTML blocks using the provided code snippets

  3. Choose from available block types:

  4. 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:

  1. Log into the store via the standard Shopify login page: /account/login

  2. 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

  1. Navigate to your Skio portal settings

  2. Add a custom button with your loyalty page URL

  3. Customize the button text (e.g., “View Loyalty Rewards”, “Manage Points”)

  4. Position the button prominently in your portal layout

Rivo and Skio Integration

💡 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:

  1. Navigate to Integrations in your Rivo dashboard

  2. Find Skio in the Subscriptions section and click Configure

  3. Enable the checkbox Auto-apply advocate discounts to active subscriptions

  4. Enter your Skio private API key (Where to find my API Key?)

  5. Click Save to activate the integration


How Auto-Apply Works

Once configured, the system works automatically:

  1. Referral completion - When an advocate’s referral is completed, their reward is generated

  2. Subscription detection - Rivo identifies the advocate’s most recent active subscription

  3. 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:

  1. Log into your Skio dashboard

  2. Navigate to Account > API

  3. Enter a descriptive name for your API key (e.g., “Rivo Integration”)

  4. Click Generate API Key

  5. Click the chain/copy button to copy your new private key

  6. 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




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.

Did this answer your question?