OAuth Permission Issues
Troubleshoot common OAuth and permission problems with Shopify connections.
This guide helps you resolve OAuth and permission issues when connecting ReturnMate to Shopify.
Common Issues
"Permission Denied" Error
Symptom: Error message when trying to access ReturnMate features.
Causes:
- Missing required Shopify scopes
- OAuth token expired
- Store permissions changed
Solution:
- Go to Settings → Connections → Shopify
- Click Reconnect
- Grant all requested permissions
- Test the connection
"App Not Installed" Message
Symptom: ReturnMate shows as not installed in Shopify admin.
Solution:
- Go to Shopify Admin → Apps
- Find ReturnMate
- If not listed, reinstall from App Store
- Grant permissions when prompted
Token Expired
Symptom: Features stop working; errors mention authentication.
Solution:
- Go to Settings → Connections
- Check connection status
- Click Refresh Token or Reconnect
Required Permissions
ReturnMate needs these Shopify scopes:
| Permission | Purpose |
|---|---|
| read_orders | Access order data |
| write_orders | Update order status |
| read_products | Product information |
| read_customers | Customer details |
| read_fulfillments | Shipping information |
| read_inventory | Stock levels |
If you revoke permissions in Shopify, ReturnMate will stop working. Reconnect if this happens.
Troubleshooting Steps
Check Connection Status
Go to Settings → Connections → Shopify and verify status shows "Connected".
Verify in Shopify
In Shopify Admin → Apps → ReturnMate, confirm the app is installed.
Reconnect if Needed
Click Reconnect and grant all permissions again.
Test Functionality
Try creating an RMA to verify the connection works.
Prevention
- Don't modify app permissions in Shopify directly
- Keep Shopify account active
- Monitor for expiry notifications
- Reconnect promptly if issues arise
Getting Help
If issues persist:
- Note any error messages
- Check the error log in Settings
- Contact support@returnmate.io with details