Overview
Fitness clubs, sports associations, private social clubs, coworking spaces, and non-profit organizations replace costly plastic membership cards with live digital passes inside Apple Wallet and Google Wallet. Cards reflect active membership tier standing, automatically update renewal dates upon payment, and enforce daily check-in validation at front desks.
Backend Architecture & Pass Types
In the Passinstance backend, subscription credentials leverage dedicated membership layouts:
-
Pass Type (pass type):
membershiporgeneric(displays member credentials with clear tier badges and expiration date headers). -
Catalog Demo Blueprints:
gym-membershipandhotel-membership. -
Mechanic Type (mechanic type):
RENEW_EXPIRATION. -
Core Membership Schema:
- primaryFields: Member Full Name ({fullName}). - secondaryFields: Membership Tier ({membershipTier}) and Standing ({status}). - auxiliaryFields: Member ID ({memberNumber}) and Member Since ({memberSince}). - headerFields: Expiration Date ({expirationDate}) formatted via ISO 8601 with localized formatting.
Automated Expiration Extension & Renewal Sync
Passinstance offers two distinct renewal workflows:
1. Webhook-Driven CRM & Billing Integration
When a member renews their recurring subscription through Stripe, Recurly, or custom billing software:
-
The external billing system dispatches an idempotent request to
POST /api/v1/passes/upsert-by-external-id(orPUT /api/v1/passes/by-external-id/:externalId) keyed byexternalId(customerId+externalIdunique constraint across live non-deleted passes). -
Passinstance creates the card (
action: "CREATED") if no live pass matchesexternalId, or merges updatedattributes,expirationDate, andstatus: "ACTIVE"(action: "UPDATED"), returning{ success: true, data: { pass, action: "CREATED" | "UPDATED" } }. -
A silent background push refreshes the card in Apple Wallet and Google Wallet, displaying a native lock-screen alert when fields define
%@change messages. -
For household or family plans, link member cards under a shared
bundleId(/api/v1/bundles) orPassProjectso all member passes install together.
2. Check-In Driven Expiration (RENEW_EXPIRATION)
For punch-based or visit-extended subscriptions:
-
The
RENEW_EXPIRATIONmechanic automatically adds a configured interval (e.g.+30 days) toexpirationDateeach time the pass is successfully scanned at an entry turnstile.
Security Controls & Anti-Sharing Invariants
To protect recurring membership revenue, Passinstance implements hardware-level sharing restrictions:
-
Apple Wallet AirDrop Restriction (
sharingProhibited: true): Suppresses the native iOS pass sharing and AirDrop icons, binding the membership card strictly to the member's verified iCloud account and registered devices. -
Controlled Self-Service Edits (
allowUserEdits: true): Allows members to update authorized personal details (such as contact phone or email) through a secure web portal while locking critical fields (expirationDate,membershipTier,memberNumber) behind administrative role gates. -
Reception Turnstile Guardrails (
CHECK_IN scan mode): The Passinstance Scanner app verifiesstatus === ACTIVEand confirms the pass is not expired or flagged for payment failure.
Member Self-Service & Bulk Issuance
-
New Member Intake: Onboard members seamlessly using public PassFlow enrollment forms with integrated credit card payments or SMS OTP verification.
-
Existing Member Roster Sync: Import thousands of existing members in minutes using the Batch Operations CSV Worker (
POST /api/v1/batch-processing), with zero manual data entry.
Important: Setting
sharingProhibited: truein your template settings prevents gym and club members from texting or AirDropping their active membership pass to non-paying guests.
Learn more on Membership Cards, Fitness Centers & Clubs, and Non-profit Memberships.
