Skip to main content

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.

Connect your Rivo account

Before you start, sign in to the Rivo app in your Shopify admin in the same browser. Rivo uses that session to know which store you’re connecting. Sign in to the Subtotal Dashboard and navigate to Apps → Rivo. Click Connect Rivo. rivo inactive You’ll be taken to Rivo to approve the connection. Rivo shows the store you’re authorizing and the access Subtotal is requesting. Check that it’s the right store, then click Authorize. Rivo returns you to the Subtotal Dashboard, and the integration shows an Active status. rivo active
No API key is required. Subtotal holds a token that it refreshes automatically, so you never need to rotate a credential by hand. If Rivo ever stops accepting it (for example, you remove Subtotal’s access in Rivo), the Rivo page shows a Reconnect Rivo banner. Reconnecting keeps your configured actions.

Connect with an API key instead

If you’d rather use a Rivo API key, click Connect with an API key instead below the Connect Rivo button. On the page that opens, click Connect Rivo to open the API key dialog. In the Rivo app, navigate to Settings → Developer Toolkit → API Keys and copy the REST API key. Rivo’s help article has a walkthrough. rivo api key Paste the key, then click Save Integration. set rivo api key Integrations already connected with an API key keep working. To switch one to the authorized connection, uninstall it and connect again with Connect Rivo.
Uninstalling can remove your configured actions. Note them before you switch so you can add them again if needed.

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 shared with your brand) 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. rivo integration settings To add an action, click Add action and choose a trigger: 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.
  • Customer Link token — send customer_id, email, and optional mobile in the authenticated token-creation body.
Without the configured identifier field set on the connection, Subtotal won’t be able to identify the customer in Rivo and the action will be skipped.