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. ClickConnect Rivo.

Authorize.
Rivo returns you to the Subtotal Dashboard, and the integration shows an Active status.

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, clickConnect 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.

Save Integration.

Connect Rivo.
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.
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 thecustomer_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 IDorMobile, you’ll need to pass the value explicitly when launching Subtotal Link. - API integration — include the appropriate field (
email,customer_id, orphone_number) when creating a connection viaPOST /connections. - Customer Link token — send
customer_id,email, and optionalmobilein 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.