Skip to main content

Wallet Cards

Understand how digital wallet passes work in the ClubVIP system.

What are Wallet Cards?​

Wallet cards are digital passes stored in Apple Wallet (iOS) or Google Pay (Android) that serve as VIP membership cards. They contain:

  • Customer's name and membership details
  • Card tier and discount information
  • Scannable barcode for entry
  • Real-time updates for offers and perks

How Wallet Cards Work​

Card Issuance Flow​

  1. Customer enrolls via QR code or promo desk
  2. System generates digital wallet pass
  3. Customer receives download link via email/SMS
  4. Customer adds pass to Apple Wallet or Google Pay
  5. Pass updates automatically with offers and changes

What's On the Wallet Pass?​

Front of card:

  • Customer name
  • Card tier (Silver/Gold/Platinum)
  • Membership number
  • Card status
  • Current perks

Back of card:

  • Barcode/QR code for scanning
  • Terms and conditions link
  • Support contact information
  • Help documentation link

Real-Time Updates​

Wallet passes update automatically when:

  • New offers are published
  • Perk rules change
  • Card tier is upgraded/downgraded
  • Card status changes (active/suspended)

Update delivery:

  • Push notification to device
  • Pass content refreshes
  • No action required from customer

Card Lifecycle​

1. Enrollment & Issuance​

Customer enrolls:

  • Scans QR code at venue
  • Provides name and contact info
  • Accepts terms and age verification
  • Selects card tier (if options available)

System issues card:

  • Creates customer record
  • Generates wallet pass
  • Sends download link
  • Pass available in 30-60 seconds

2. Active Use​

Customer uses card:

  • Shows pass at door for entry
  • Receives ticket for bar redemption
  • Gets push notifications for offers
  • Accumulates visit history

3. Card Updates​

Automatic updates when:

  • Tier upgraded (more perks)
  • New offers published
  • Contact information changed
  • Terms updated

4. Card Suspension​

Reasons for suspension:

  • Payment issues (if applicable)
  • Rule violations
  • Temporary account freeze

Customer impact:

  • Card shows "SUSPENDED" status
  • Cannot be scanned at door
  • No new tickets issued
  • Can be reactivated when resolved

5. Card Expiration​

Inactivity expiration:

  • Cards expire after 6 months of no use
  • Status changes to "EXPIRED_INACTIVITY"
  • Customer must re-enroll
  • Previous visit history retained

Wallet Pass Templates​

Template Management​

Tenant Admins can customize:

  • Card background color
  • Logo and branding
  • Text colors and fonts
  • Field layouts
  • Barcode format

Template Hierarchy​

Templates can be configured at multiple levels:

  1. Tenant level: Default for all locations
  2. Brand level: Specific brand identity
  3. Location level: Location-specific designs
  4. Card tier level: Different colors per tier (Silver/Gold/Platinum)

Design Best Practices​

Visual clarity:

  • High contrast between text and background
  • Logo clearly visible
  • Card tier immediately recognizable

Scannability:

  • Barcode must have sufficient contrast
  • Adequate white space around barcode
  • Test scanning in various lighting conditions

Branding consistency:

  • Match venue branding
  • Professional appearance
  • Recognizable by staff

Multi-Platform Support​

Apple Wallet (iOS)​

Features:

  • Rich notifications
  • Location-based suggestions
  • Automatic time-based display
  • Dynamic updates

Requirements:

  • iOS 9 or later
  • Apple Pass signing certificate
  • HTTPS endpoint for updates

Google Pay (Android)​

Features:

  • Push notifications
  • Google Pay integration
  • Live card updates
  • QR code/barcode display

Requirements:

  • Android 5.0 or later
  • Google Wallet API credentials
  • Issuer account setup

Cross-Platform Consistency​

Same functionality:

  • Both platforms support all core features
  • Identical perk and offer delivery
  • Same barcode format
  • Consistent user experience

Platform differences:

  • Visual layout slight variations
  • Notification behavior differs
  • OS-specific limitations respected

Barcode Scanning​

Barcode Formats​

Supported formats:

  • QR Code (primary)
  • PDF417 (backup)
  • Code 128 (alternate)

Best practices:

  • QR codes work best in low light
  • Larger barcodes scan more reliably
  • Include both QR code and alternate format

Scan Reliability​

Factors affecting scanning:

  • Screen brightness (customer should maximize)
  • Scanner quality
  • Barcode contrast
  • Ambient lighting
  • Screen condition (cracks, protectors)

Troubleshooting scan failures:

  1. Increase screen brightness
  2. Clean scanner lens
  3. Adjust angle/distance
  4. Use manual code entry if scan fails

Wallet Pass Security​

Security Features​

Built-in protections:

  • Unique pass identifiers
  • Cryptographic signing
  • Secure credential codes
  • Server-side validation

Fraud prevention:

  • One pass per customer per tenant
  • Cannot duplicate or transfer passes
  • Revoked passes stop working immediately
  • Audit log of all pass usage

Lost or Stolen Passes​

If customer reports loss:

  1. Suspend card immediately
  2. Issue new card with new credentials
  3. Old pass becomes invalid
  4. Customer downloads new pass

Cannot be misused:

  • Suspended pass won't scan
  • All scan attempts logged
  • Staff alerted to suspended status

Troubleshooting Wallet Issues​

Customer Can't Download Pass​

Common causes:

  1. Email went to spam folder
  2. Download link expired (24 hours)
  3. Incorrect email address provided
  4. Device compatibility issue

Solutions:

  • Resend download link from system
  • Verify email address
  • Check device requirements
  • Try alternate download method (SMS)

Pass Not Updating​

Customer sees old information:

  • Wallet passes cache for up to 24 hours
  • Customer can manually refresh:
    • iOS: Swipe down on pass
    • Android: Open pass, check for updates
  • System re-pushes updates every 6 hours

Barcode Won't Scan​

Troubleshooting steps:

  1. Customer: Maximize screen brightness
  2. Staff: Clean scanner lens
  3. Customer: Remove screen protector if scanning fails
  4. Staff: Use manual code entry (displayed below barcode)
  5. Fallback: Look up customer and process entry manually

Pass Deleted Accidentally​

Customer can re-download:

  • Access original enrollment email
  • Click download link again
  • Or staff can resend link from customer record
  • Same pass, same credentials
  • Visit history preserved

Wrong Information on Pass​

If customer details incorrect:

  1. Update customer record in system
  2. System regenerates pass automatically
  3. Push update sent to customer device
  4. Pass reflects changes in 1-2 hours

Wallet Pass Analytics​

Metrics Available​

Installation metrics:

  • Total passes issued
  • Active passes (in wallets)
  • Deleted passes
  • Installation rate by platform (iOS vs Android)

Usage metrics:

  • Pass opens (customer viewed pass)
  • Scan frequency
  • Average time between visits
  • Offer redemption rate from pass

Engagement metrics:

  • Push notification delivery rate
  • Pass update success rate
  • Customer actions from notifications

Reports​

Access reports:

  1. Go to Reports → Wallet Analytics
  2. Select date range
  3. Filter by location or tier
  4. Export to CSV/Excel