📱 Overview
✅ All-in-One Solution! PassLoop includes a complete validation and redemption system built directly into the platform. No need for separate scanner apps or third-party integrations.
Key Features
- Web-Based Scanner - Works on any device with a camera (phone, tablet, laptop)
- No App Required - Access directly through your browser
- QR Code Validation - Automatic validation tokens for each pass
- Offline Capable - Progressive Web App (PWA) works without internet
- Redemption Tracking - Complete history and analytics
- Multi-User Support - Multiple staff members can scan simultaneously
- Configurable Limits - Set redemption counts and expiry dates
How It Works
- Customer receives pass - Your customer gets a digital pass in Apple/Google Wallet
- Pass includes QR code - Each pass has a unique validation token QR code
- Staff scans QR code - Using PassLoop scanner in the dashboard
- System validates - Checks if pass is valid, not expired, and within redemption limits
- Redemption processed - Updates customer balance, records transaction
🔧 Setup Guide
Step 1: Create Validation Tokens
When you create a pass, PassLoop automatically generates a validation token. You can customize:
- Expiration Date - Set when the pass can no longer be redeemed
- Max Redemptions - Limit how many times the pass can be used (e.g., single-use coupons)
- Redemption Type - Full redemption, partial balance deduction, or points-based
💡 Pro Tip: For loyalty cards with points/stamps, validation tokens persist across multiple redemptions until the maximum is reached.
Step 2: Configure Scanner Access
- Log in to your PassLoop dashboard
- Navigate to Dashboard → Validate
- Grant camera permissions when prompted
- For staff members, create user accounts with scanner access
Step 3: Test the System
- Create a test pass for yourself
- Add it to your phone's wallet
- Open the scanner on another device (or computer)
- Scan the QR code from your wallet pass
- Verify the validation works correctly
📸 Using the Scanner
Scanner Interface
The PassLoop scanner provides a simple, intuitive interface:
1. Access the Scanner
- Go to Dashboard → Validate
- The camera will activate automatically (permission required)
- Point camera at the QR code on customer's pass
2. Scan QR Code
- Hold device steady, centered on QR code
- System automatically detects and reads code
- Validation happens in real-time
3. Review Pass Details
After scanning, you'll see:
- Customer name (if provided)
- Pass type (loyalty card, coupon, ticket, etc.)
- Current balance/points/stamps
- Redemption history
- Expiration status
4. Process Redemption
Choose redemption action:
- Full Redemption - Use entire pass value (coupons, tickets)
- Add Stamps/Points - Credit loyalty program activity
- Redeem Reward - Deduct stamps/points for reward claim
- Partial Balance - Deduct from gift card balance
Mobile Scanning Best Practices
- Use in well-lit areas for faster scanning
- Keep camera lens clean
- Hold device 4-8 inches from QR code
- Ensure entire QR code is visible in frame
- For poor lighting, tap to enable device flashlight
PWA Installation (Optional)
For faster access, install PassLoop as a mobile app:
- Open PassLoop in mobile browser (Safari/Chrome)
- Tap browser menu (⋯ or Share icon)
- Select "Add to Home Screen"
- Confirm installation
- Launch from home screen like a native app
🎫 Redemption Types
1. Single-Use Passes
Use Case: Coupons, event tickets, single-entry passes
- Set
max_redemptions = 1 - After scanning once, pass becomes invalid
- Perfect for discount codes and admission tickets
2. Multi-Use Loyalty Cards
Use Case: Stamp cards, points programs
- No redemption limit (or high limit)
- Each scan adds stamps/points
- Customer redeems accumulated rewards
- Pass remains active for continuous use
3. Balance-Based Cards
Use Case: Gift cards, prepaid cards
- Track current balance
- Each redemption deducts from balance
- Pass expires when balance reaches zero
- Supports partial redemptions
4. Time-Limited Passes
Use Case: Seasonal memberships, temporary access
- Set expiration date
- Unlimited use until expiry
- Automatically becomes invalid after date
📊 Analytics & Tracking
Redemption Dashboard
View comprehensive statistics:
- Total Redemptions - All-time count
- Active Passes - Currently valid passes
- Redemption Rate - Percentage of distributed passes redeemed
- Popular Pass Types - Most redeemed categories
- Redemption Timeline - Daily/weekly/monthly trends
Redemption History
For each redemption, track:
- Date and time
- Customer identifier
- Pass type and details
- Redemption value (points, balance, etc.)
- Staff member who processed
- Location (if applicable)
- Notes/comments
Export & Reporting
Download redemption data:
- CSV export for Excel/Google Sheets
- Date range filtering
- Pass type filtering
- Custom report generation
🔧 Troubleshooting
Common Issues
"Camera not accessible"
Solutions:
- Grant camera permissions in browser settings
- Check device privacy settings
- Ensure HTTPS connection (required for camera access)
- Try a different browser (Chrome recommended)
"QR code not scanning"
Solutions:
- Improve lighting conditions
- Increase screen brightness on customer's phone
- Clean camera lens
- Hold device steadier
- Try different angle or distance
"Pass already redeemed"
Explanation:
- Single-use passes can only be scanned once
- Check redemption history to verify
- For multi-use passes, verify if redemption limit reached
- Check pass expiration date
"Invalid validation token"
Solutions:
- Verify QR code is from a PassLoop pass
- Check if pass was deleted or deactivated
- Ensure customer hasn't received outdated pass version
- Confirm customer account is still active
"Scanner running slowly"
Solutions:
- Close other browser tabs
- Clear browser cache
- Update browser to latest version
- Use device with better camera hardware
- Reduce screen brightness to improve detection
Browser Compatibility
Scanner works best on:
- Mobile: Chrome (Android), Safari (iOS)
- Desktop: Chrome, Edge, Safari
- Not supported: Internet Explorer
Offline Mode
When internet connection is lost:
- PWA allows basic scanning functionality
- Redemptions are queued locally
- Data syncs automatically when connection restored
- For critical operations, ensure stable connection
🚀 Advanced Features
API Integration
Integrate validation into your own systems:
POST /api/scanner/validate/{token}
Authorization: Bearer YOUR_TOKEN
Response:
{
"valid": true,
"pass_details": {...},
"redemptions_remaining": 5,
"customer_name": "John Doe"
}Webhook Notifications
Receive real-time notifications when passes are redeemed:
- Configure webhook URL in dashboard
- Receive POST requests for each redemption
- Integrate with POS systems, CRM, or custom software
Location-Based Tracking
For multi-location businesses:
- Assign passes to specific locations
- Track redemption by store/branch
- Generate per-location reports
- Restrict redemptions to authorized locations
Staff Permissions
Control who can scan and redeem:
- Create staff user accounts
- Assign scanner-only permissions
- Track redemptions by staff member
- Audit trail for accountability