Skip to main content

Skio integration

Integrate Skio with Rivo to bring loyalty closer to subscriptions

Laurence Leech avatar
Written by Laurence Leech
Updated over 2 weeks 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 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.

Place An Order earning rule

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:

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'

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:

    • 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

  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 Payments section and click Configure

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

    Skio integration page
  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 discount code is applied directly to the subscription

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

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


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.

Did this answer your question?