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

Membership & Subscription Cards

Replace plastic member cards for clubs, gyms, and associations with live renewal dates and daily check-in rules.

In This Guide

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): membership or generic (displays member credentials with clear tier badges and expiration date headers).
  • Catalog Demo Blueprints: gym-membership and hotel-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.

SYSTEM ARCHITECTURE FLOW
INTERACTIVE ARCHITECTURE
SUBSCRIPTION RENEWAL LIFECYCLE
PARTICIPATING SYSTEM ACTORS
P1 Stripe / CRM Webhook
P2 Passinstance Core API
P3 Passinstance Database
P4 Member Device Wallet
STEP CTX CONTEXT customer.subscription.updated
STEP 1 REQUEST / ACTION POST/api/v1/passes/upsert-by-external-id
STEP 2 REQUEST / ACTION Extend Validity
›
expirationDate: "2027-12-31 23:59")
›
(Update Pass Record
›
& clear suspensions)
STEP 3 REQUEST / ACTION Silent APNs Push
STEP 4 RESPONSE 200 OK ({ data: { pass, action } })
›
& Google REST PATCH | (Lock-Screen Alert
›
"Membership renewed")

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 (or PUT /api/v1/passes/by-external-id/:externalId) keyed by externalId (customerId + externalId unique constraint across live non-deleted passes).
  • Passinstance creates the card (action: "CREATED") if no live pass matches externalId, or merges updated attributes, expirationDate, and status: "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) or PassProject so all member passes install together.

2. Check-In Driven Expiration (RENEW_EXPIRATION)

For punch-based or visit-extended subscriptions:

  • The RENEW_EXPIRATION mechanic automatically adds a configured interval (e.g. +30 days) to expirationDate each 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 verifies status === ACTIVE and 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: true in 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.

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.