Introduction

​

Overview

Our integration with Rivo makes it easy to reward customers for linking accounts and making retail purchases. Subtotal awards points in Rivo by posting events to Rivo’s Custom Action API. Each action you configure in Subtotal maps to a matching Custom Action you’ve created in Rivo — so Rivo can apply its earning rule and display the reward in the customer’s activity feed.

​

Get your Rivo API key

Sign in to the Rivo app in your Shopify admin and navigate to Settings → Developer Toolkit → API Keys. Copy the REST API key — you’ll need it to connect the integration. Can’t find your API key? Rivo’s help article has a walkthrough.

​

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. Paste your Rivo API key, then click Save Integration. You should now see an Active status on the Rivo integration page.

​

Configure actions

After connecting, configure the actions Subtotal should send to Rivo. Each action maps a Subtotal event (an account being linked, a purchase being made) to a Custom Action you’ve set up in Rivo. The Action name in Subtotal must match the Custom Action name in Rivo exactly — that’s how Rivo applies the matching earning rule. To add an action, click Add action and choose an event: See Rewarding linked accounts and Rewarding purchases for setting up each action end-to-end in Rivo and Subtotal.

​

Customer identification

The value Subtotal sends in the customer_identifier field depends on the Customer identifier type you’ve configured: How this field gets captured depends on your setup:

• Shopify app — the customer’s email is captured automatically from their Shopify profile. For Customer ID or Mobile, you’ll need to pass the value explicitly when launching Subtotal Link.
• API integration — include the appropriate field (email, customer_id, or phone_number) when creating a connection via POST /connections.
• Subtotal Link query parameter — pass customer_id (or the appropriate field) as a query parameter when launching Subtotal Link. See Link URLs and Link accounts to your Shopify store.