Troubleshooting Guide: Common Issues and Solutions

Introduction

Even with the best preparation, you may encounter issues while managing products. This troubleshooting guide provides solutions to common problems and helps you resolve them quickly.

Order and Payment Issues

Issue: Orders not showing in customer list

Solution: Refresh your dashboard and check if payment was completed. Verify the order status in your orders section.
Prevention: Always confirm payment completion before considering orders final.

Issue: Duplicate orders

Solution: Check order history for duplicate orders. Issue a refund for one of the duplicates if needed.
Prevention: System prevents duplicate purchases automatically, but verify orders if customers report issues.

Issue: Payment processing errors

Solution: Check payment gateway status and settings. Verify your payment methods are properly configured.
Prevention: Test payment processing before products go live. Keep payment gateway credentials updated.

Check-in Problems

Issue: QR codes not scanning

Solution: Ensure good lighting and camera focus. Try manual check-in using customer name or email.
Prevention: Test QR scanning before products. Have backup manual check-in procedures ready.

Issue: Customer already checked in (duplicate)

Solution: System prevents duplicates automatically. Verify identity if order was transferred. Check check-in records.
Prevention: Monitor check-in in real-time. Educate staff on handling transfers.

Issue: Check-in app not working offline

Solution: Ensure app is updated to latest version. Check if offline mode is enabled in settings.
Prevention: Test offline functionality before products. Sync data when connectivity is available.

Technical Issues

Issue: Dashboard not loading or slow

Solution: Clear browser cache and cookies. Try a different browser or device. Check internet connection.
Prevention: Use supported browsers. Keep browser updated. Have backup devices ready.

Issue: Email notifications not sending

Solution: Check email settings and templates. Verify recipient email addresses are valid.
Prevention: Test email notifications before products. Monitor notification delivery in dashboard.

Issue: Unable to export data

Solution: Try different export formats (CSV, PDF). Check if data is available for export. Refresh and try again.
Prevention: Export data regularly. Don't wait until the last minute.

Business management Issues

Issue: Unable to edit product details

Solution: Check if product is published and if you have edit permissions. Try saving drafts first.
Prevention: Review all details before publishing. Use draft mode for major changes.

Issue: Variants not updating

Solution: Refresh the page. Check if orders have already been placed (variants with sales may have restricted edits).
Prevention: Finalize variant structure before going live. Make changes carefully.

Issue: Analytics not showing correct data

Solution: Wait a few minutes for data to sync. Refresh the analytics page. Check date filters.
Prevention: Analytics update in real-time but may have slight delays. Export data for verification.

Customer Communication Issues

Issue: Emails not reaching customers

Solution: Check spam folders. Verify email addresses are correct. Test with a small group first.
Prevention: Use clear subject lines. Avoid spam trigger words. Maintain good sender reputation.

Issue: Mass messaging not sending

Solution: Check recipient limits. Verify all email addresses are valid. Send in smaller batches if needed.
Prevention: Segment large lists. Test with small groups first.

Financial Issues

Issue: Payout not processing

Solution: Verify bank account information is correct. Check payout status in dashboard. Contact support if needed.
Prevention: Verify bank details before requesting payouts. Keep account information updated.

Issue: Revenue calculations incorrect

Solution: Check date filters. Verify all products are included. Export detailed reports for verification.
Prevention: Review financial data regularly. Compare to individual product reports.

General Troubleshooting Steps

When encountering any issue:

Refresh: Refresh the page or restart the app
Verify: Check your settings and configuration
Test: Try the action on a different device or browser
Check: Review recent changes that might have caused the issue
Document: Note the steps to reproduce the problem
Contact: Reach out to support with details if needed

When to Contact Support

Contact Ordafy support if:

Issues persist after trying troubleshooting steps
You encounter payment or financial discrepancies
Data appears to be lost or corrupted
Security concerns arise
You need assistance with advanced features

preventive Best Practices

Test all features before products go live
Keep software and apps updated
Have backup plans for critical functions
Document procedures for your team
Regularly backup important data
Monitor systems and dashboards regularly

Conclusion

Most issues can be resolved quickly with the right troubleshooting steps. When in doubt, document the issue and contact support. Being prepared and having backup plans minimizes the impact of unexpected problems.