Skip to content
Help Center Guide
3 min readVerified 2026-11-16

VIP & Customer Privilege Cards

Deliver exclusive tier credentials with personalized member perks, gated PassFlow enrollment, and concierge updates.

In This Guide

Overview

Hospitality groups, boutique hotels, luxury retail maisons, private clubs, and premium wellness spas issue VIP & Customer Privilege Cards to high-net-worth clientele. These digital credentials deliver priority counter service, exclusive lounge access, personal concierge messaging, and companion passes directly inside Apple Wallet and Google Wallet.

Backend Architecture & VIP Visual Aesthetics

VIP passes reflect luxury brand guidelines with dark-mode color palettes and specialized Apple Wallet extensions:

  • Pass Type (pass type): storeCard or generic.
  • Catalog Demo Blueprint: vip-membership.
  • Mechanic Type (mechanic type): LOYALTY_PROGRAM (configured for high-tier privileges).
  • Styling Architecture (theme preference.DARK): Applies an obsidian, platinum, or brushed-gold dark aesthetic compliant with Apple Wallet dark mode contrast standards.
SYSTEM ARCHITECTURE FLOW
INTERACTIVE ARCHITECTURE
VIP CONCIERGE & MULTI-PASS BUNDLE
STAGE 01 WALLET EXPERIENCE CONTAINER (PassProject)
Generates Apple Wallet Pass Bundle (.pkpasses)
STAGE 02 Primary Card | Secondary Companion Pass
PRIMARY VIP CREDENTIAL
theme preference.DARK
Apple Business Chat Identifier
Dedicated loungeURL entry portal
PRIVATE LOUNGE & VALET PASS
Fast-track security QR code
Single-day access rules
Auto-expires at midnight

Specialized Apple Wallet Extensions

Passinstance exposes specialized metadata fields tailored for luxury hospitality and private clubs:

  • businessChatIdentifier: Integrates with Apple Messages for Business. A "Message Concierge" button appears natively on the back of the Apple Wallet pass, connecting the cardholder directly to personal concierge staff via iMessage.
  • loungeURL: Encodes a secure HTTPS deep-link to private lounge reservation systems or digital key unlocking web portals.
  • associatedStoreIdentifiers: Associates the digital pass with official Apple App Store applications, prompting app installation or opening native booking flows.
  • Geofenced Relevancy: Proximity coordinates around flagship boutiques or private clubhouse entrances display the VIP card on the phone's lock screen upon arrival.

Gated Issuance & Anti-Leak Safeguards

Because VIP perks carry significant monetary and brand value, distribution must be strictly controlled:

  1. 1
    Invite-Only Distribution: Disable public PassFlow registration. Issue credentials exclusively via programmatic API calls (POST /api/v1/passes) or encrypted CSV batch imports.
  2. 2
    Access PIN Verification: Require the recipient to input a private PIN delivered via personal concierge SMS before the pass download link unlocks.
  3. 3
    Hardware Link Lock (limitToOneActivePerPass: true): Once installed on the cardholder's personal smartphone, the download token expires immediately, preventing link forwarding to unauthorized third parties.
  4. 4
    Anti-Screenshot Dynamic Animations (addSecurityAnimation: true): Barcodes render with an active anti-counterfeit animated perimeter that optical scanners verify, rendering static screenshots useless at access turnstiles.

Multi-Pass Bundling in Wallet Experiences

Through Wallet Experiences (/wallet-experiences or /pass-projects), administrators can bundle related VIP privileges into a single download action:

  • Project Template Roles (PassProjectTemplateRole): Pair the primary mainTemplateId (PRIMARY) with companion templates using LINKED, VIP, PRIVACY_MODE, CUSTOM, or INACTIVE roles.
  • Pass Bundling Engine (Pass.bundleId / /api/v1/bundles): Groups up to 10 passes (primary VIP card, executive lounge access voucher, gala ticket) under a shared bundleId (bundle grouping mode: AUTO or MANUAL) to deliver an Apple Wallet Pass Bundle (.pkpasses) alongside multi-card Android claim views.
  • CRM Lookup (externalId): Map each VIP pass to your CRM client ID via externalId so concierge staff or automation flows can update companion entitlements without duplicating passes.

Important: Apple Messages for Business integration requires a registered Apple Business ID. Once configured, VIP cardholders can tap the concierge button on the back of their digital card to launch an encrypted customer service chat.

Explore specialized workflows in Hotels & Hospitality and Beauty & Spas.

Related Product & Developer Documentation

Ready to launch your first pass program?

Create your workspace, configure your pass template, and test a real pass in Apple Wallet and Google Wallet before you scale.