Skip to main content

​
Overview

Our integration with Rivo makes it easy to reward customers for linking accounts and making retail purchases. We’ll show you how to set up your program with Rivo and make the most out of this integration.

​
Get your Rivo API key

Sign in to the Rivo app in Shopify admin and get your API key. Can’t find your API key? Click here Rivo -> Settings -> Developer Toolkit -> API Key rivo api key

​
Connect your Rivo account

Sign in to the Subtotal Dashboard and connect your Rivo account to enable the integration. Navigate to Integrations -> Rivo -> Connect. Click the Connect Rivo button. rivo inactive Provide your Rivo API Key then click Save Integration. set rivo api key You should now see an Active status on the Rivo integration page. subtotal rivo integration

​
Rewarding points for making purchases

Navigate to Rivo’s Loyalty Program page and click Add Another Way to Earn.

​
Add another way to earn

Click on Add Another Way to Earn then select Custom Action. rivo custom action

​
Configure the custom action

Set the action name to Make a Retail Purchase and number of points to 1 point
The action name must be exactly Make a Retail Purchase for the integration to work correctly.
Subtotal calculates the number of points for each purchase and overrides the 1 point placeholder value with 1 point per $1 spend. Contact Subtotal if you’d like to use a different number of points per $1 spend.
make a retail purchase

​
Rewarding points for linking accounts

Navigate to Rivo’s Loyalty Program page and click Add Another Way to Earn.

​
Add another way to earn

Click on Add Another Way to Earn then select Custom Action. rivo custom action

​
Configure the custom action

Set the action name to Link an Account and number of points to the amount you’d like to reward each time a customer links an account.
The action name must be exactly Link an Account for the integration to work correctly.
The default behavior is to allow customers to earn from this action one time per retailer. Linking and unlinking the same account repeatedly will not result in more points.
linked an account We use the value passed in the customer_id parameter to determine which customer should be awarded points for these custom action. Make sure you include the customer_id as a query parameter when you launch Subtotal Link. Check out these resources for more guidance on customer_id: