Introduction
Piing gives your customers a branded wallet pass for Apple Wallet or Google Wallet that they can show when they visit your store. With Rivo connected, the pass shows the customer's points balance and VIP tier from Rivo, so your team knows who they're talking to before checkout. Rivo still runs your loyalty program and keeps every points transaction.
✨ This integration requires Developer Toolkit access
What does the integration do?
Show each customer's current Rivo points balance and VIP tier on their Piing pass.
Recognise loyalty members when they arrive in store by scanning the QR code on their pass.
Award Rivo points for in-store activity, like checking in or adding the pass to their wallet.
Prerequisites
Piing and Rivo installed on the same Shopify store.
A Rivo plan that includes Developer Toolkit access.
A Piing install with at least one recorded check-in to test against (see Install the Shopify app on Shopify).
Integration setup
From Rivo, go to Settings > Developer Toolkit.
Under REST API Keys, copy your current API key or create one.
Go to the Piing app > Integrations.
Under Loyalty platforms, find the Rivo card, then click "Connect."
Once the integration details are expanded, please fill out the fields:
Set Status to Active and Dispatch mode to Direct API.
Choose Shopify Customer ID as the customer identity.
Paste your Rivo API key into the API key field.
Click"Save" and expect the success message "Provider settings saved."
Recommended: Click "Test connection" to validate your API key.
Reviewing your wallet pass settings
From Piing, go to Wallet Studio > Design.
Under Programme, choose Points from my loyalty app.
Set Balance on the card to Loyalty points, and click "Save programme." Make sure that Rivo is recognized.
Under Designer, click the Layout tab.
Set Header right to Points (Loyalty).
Click "Save."
📝 Important note: Your Rivo account manages one REST API key. If you regenerate it, the old key stops working, so update it in Piing and in every other integration that uses it. More on this in Manage API keys.
Awarding Rivo points from Piing
Piing wallet passes show the points balance and VIP tier by default, but you can also reward customers for in-store activity.
From Piing, go to Integrations > Loyalty platforms > Rivo.
Under Award points in Rivo, enable Let Piing award points in Rivo.
Enable the triggers that you want to use for rewarding your wallet pass holders, making sure you input the preferred points value correctly.
Click "Save."
💡 Pro tip: Start with Piing's Test mode on, then turn it off for one live test before launch.
Piing triggers available
Customer checks in – An accepted Piing check-in by QR, linked physical card or supported Apple NFC.
First-time customer identified – The first time Piing ever recognises this customer (a welcome bonus).
Purchase after check-in – A customer buys within the attribution window after checking in.
Visit milestone reach – A customer reaches a visit milestone (5th, 10th, 25th visit and so on).
New store visited – A customer checks in at a store they have never visited before.
Customer adds wallet pass – A customer installs their Apple or Google wallet pass. One time only.
How Piing sends points to Rivo
Topic | How it works |
Who sets the amount | The amount on the Piing trigger |
Setup in Rivo | None |
What the customer sees in points history | A manual points adjustment with a custom note based on the trigger |
Frequency limits | Piing's limits are the only safeguard |
Expiry settings | Rivo's expiry settings apply to the points earned |
Notifications | Piing wallet messages are configured in Piing. Rivo's points-earned email may also send. |
Troubleshooting
Test connection fails with an authorization error → The key is incorrect. From the Rivo app, go to Settings > Developer Toolkit and copy the REST API key again.
Test connection fails, and you cannot find the Developer Toolkit section in the Rivo app → Your Rivo plan does not include access to a REST API key. Please upgrade or reach out to your CSM.
Member is not recognized, or points balance shows as zero → Piing looks the customer up by Shopify customer ID first, then by email address. Please confirm that: (a) both the Shopify profile and Rivo profile use the same email address; (b) the customer is a member rather than a guest.
Piing pass not scanning → Confirm the customer installed a Piing-issued pass for your store, then scan its Piing QR code. Their Rivo points and VIP tier appear through the connected loyalty program, and they won't need a separate Rivo pass.
Points not awarded → Check that points awarding is enabled in Piing and that the trigger you expect is enabled.
Points balance and VIP tier stop updating during a busy spell → Rivo allows 15 requests per second per API key and returns an error above that. Piing will back off and retry.
Common questions
Do customers need a Piing pass if they already have a Rivo wallet pass?
Yes. For this integration, customers use the Piing pass. Staff shouldn't scan a Rivo wallet pass in Piing.
Which points balance shows on the pass?
The customer's current Rivo points balance. A balance of 0 is normal for new members. Shopify store credit is a separate balance and doesn't show as points.
Where can I edit the points logs displayed to my customers?
Piing automatically sends both an internal and an external note for the activity completed. The text is not customizable for now.
How quickly does the pass update?
The pass updates when Piing refreshes the customer's data, for example, when they check in in-store. It isn't instant, and Apple and Google decide whether a pass update also shows a notification.
What happens if I don't use the VIP Program?
The value falls back to the customer's loyalty status (e.g. "Member").
Where do customers redeem rewards?
Piing doesn't show the Rivo rewards available to redeem, so customers might still need to redeem in-store through the Shopify POS extension, or online.
Will Piing import my past loyalty data?
No. Piing reads each customer's balance and tier from Rivo. It doesn't import your full customer or points history.
A customer's balance or tier is missing on their pass. What should I check?
Please make sure the customer exists in both Rivo and Shopify with the same email. Piing looks up the customer by their Shopify customer ID first, then by email.
What happens if I disconnect Piing?
Your customers and their points history stay in Rivo. Turn off Piing's point awards first, and note that passes will stop showing current Rivo balances.
How do I get support for the integration from Piing?
Please contact the Piing team. Include the store, customer reference, and test time.