When you enable a loyalty integration in your Tapcart app, a dedicated rewards section becomes available on the My Account page. This guide covers how loyalty appears on the account page, how to configure it, and how to troubleshoot common issues.
For a general overview of loyalty integrations and setup instructions, see Leveraging a Loyalty Integration.
Supported Loyalty Providers
The following loyalty providers display on the My Account page when connected:
Note: You can only have one loyalty integration enabled at a time.
How Loyalty Appears on the Account Page
Once a loyalty integration is connected, customers who are signed in will see:
Points Balance: Their current loyalty point total
Ways to Earn: Available actions to earn more points
Rewards History: A log of earned and redeemed rewards
Redeem Options: Available rewards they can claim with their points
The loyalty block on the account page can be customized in App Studio. Go to App Studio → Screens → My Account to adjust the block's position and visibility.
Requirement: Customers must be signed in to their account to view and interact with loyalty features. The loyalty section will not appear for guest users.
Configuring Loyalty on the Account Page
Ensure your loyalty provider is connected in the Tapcart dashboard under Integrations
Navigate to App Studio → Screens → My Account
Confirm the Loyalty block is enabled and positioned where you want it
You can customize which "Ways to Earn" cards are visible and their display order through the block's manifest settings
Troubleshooting Common Issues
Loyalty section says "loading" and never displays
This usually indicates a connection issue between Tapcart and your loyalty provider.
Confirm the loyalty integration is active in your Tapcart dashboard
Verify the customer is signed in (loyalty does not display for guests)
Check that your loyalty provider's API credentials are still valid
If the issue persists, contact support with your app name and the loyalty provider you're using
Points balance doesn't match gift card balance
The loyalty points displayed in the app are pulled from your loyalty provider's API, while gift card balances come from Shopify. If a customer redeems points for a gift card, there may be a sync delay between the two systems.
Check the customer's account directly in your loyalty provider's dashboard to confirm the actual point balance
If balances are consistently out of sync, review the sync settings between your loyalty provider and Shopify
Discount codes not visible in Rewards History
When customers redeem points for a discount code, the code should appear in their Rewards History. If codes are not showing:
This may be a display limitation of the current integration version
Customers can find their active discount codes in the Cart view, where redeemed rewards are automatically applied
If using Rivo, check the "Unclaimed" section for rewards that have been redeemed but not yet used
Customer gets stuck after tapping "Log In" in Rewards
Some customers report that after tapping "Log In" within the loyalty rewards section, they cannot navigate back, no back button appears and swipe-back doesn't work.
This is a known navigation issue with certain loyalty webviews
As a workaround, customers can use the bottom navigation bar to switch to another tab and then return to Account
If this is a recurring issue for your customers, contact support so the team can investigate the specific integration
FAQs
Can I use loyalty with New Customer Accounts?
Loyalty integrations work with both Classic and New Customer Accounts. However, if you're using a custom account screen for NCA, make sure the loyalty block is added to your custom screen layout.
Why can't my customer see their rewards?
The most common reason is the customer isn't signed in. Loyalty features require authentication. Have them sign in and check again.
Do subscription products (ReCharge) work with loyalty?
Subscription products added through ReCharge will not work with loyalty programs in-app. This is a known limitation.