Überblick
Fitnessstudios, Sportvereine, private Mitgliederclubs, Co-Working-Spaces und gemeinnützige Organisationen ersetzen teure Plastik-Mitgliedsausweise durch dynamische digitale Pässe in Apple Wallet und Google Wallet. Die Karten spiegeln den aktuellen Mitgliedschaftsstatus wider, verlängern Ablaufdaten bei Zahlungseingang automatisch und setzen am Empfang tägliche Check-in-Prüfungen durch.
Backend-Architektur & Pass-Typen
Im Passinstance-Backend nutzen Abo-Ausweise spezialisierte Mitgliedschaftslayouts:
-
Pass-Typ (pass type):
membershipodergeneric(zeigt Mitgliedsdaten mit klaren Status-Badges und Ablaufdatum im Kopfbereich an). -
Katalog-Demo-Vorlagen:
gym-membershipundhotel-membership. -
Mechanik-Typ (mechanic type):
RENEW_EXPIRATION. -
Zentrales Mitgliedschaftsschema:
- primaryFields: Vollständiger Name ({fullName}). - secondaryFields: Mitgliedschaftsstufe ({membershipTier}) und Status ({status}). - auxiliaryFields: Mitgliedsnummer ({memberNumber}) und Mitglied seit ({memberSince}). - headerFields: Ablaufdatum ({expirationDate}), formatiert nach ISO 8601 mit lokalisierter Anzeige.
Automatisierte Laufzeitverlängerung & Verlängerungs-Sync
Passinstance unterstützt zwei unterschiedliche Verlängerungs-Workflows:
1. Webhook-gesteuerte CRM- & Abrechnungsintegration
Wenn ein Mitglied ein wiederkehrendes Abonnement über Stripe, Recurly oder ein eigenes Abrechnungssystem verlängert:
-
Das externe Abrechnungssystem sendet eine idempotente Anfrage an
POST /api/v1/passes/upsert-by-external-id(oderPUT /api/v1/passes/by-external-id/:externalId) anhand vonexternalId(customerId+externalIdals eindeutige Bedingung über aktive, nicht gelöschte Pässe). -
Passinstance erstellt die Karte (
action: "CREATED"), falls kein aktiver Pass zuexternalIdexistiert, oder führt aktualisierteattributes,expirationDatesowiestatus: "ACTIVE"zusammen (action: "UPDATED") und gibt{ success: true, data: { pass, action: "CREATED" | "UPDATED" } }zurück. -
Ein stiller Hintergrund-Push aktualisiert die Karte in Apple Wallet und Google Wallet und zeigt auf dem Sperrbildschirm eine native Meldung an, sofern Felder
%@-Änderungshinweise definieren. -
Für Haushalts- oder Familientarife verknüpfen Sie Mitgliedskarten über eine gemeinsame
bundleId(/api/v1/bundles) oderPassProject, sodass sich alle Karten zusammen installieren lassen.
2. Check-in-gesteuerte Verlängerung (RENEW_EXPIRATION)
Für besuchs- oder punktbasierte Mitgliedschaften:
-
Die Mechanik
RENEW_EXPIRATIONverlängertexpirationDateautomatisch um ein konfiguriertes Intervall (z. B.+30 days), sobald der Pass erfolgreich an einem Eingangsdrehkreuz gescannt wird.
Sicherheitskontrollen & Schutz vor Weitergabe
Zum Schutz wiederkehrender Mitgliedsbeiträge bietet Passinstance systemnahe Weitergabebeschränkungen:
-
Apple Wallet AirDrop-Sperre (
sharingProhibited: true): Deaktiviert die nativen iOS-Symbole zum Teilen und für AirDrop und bindet die Mitgliedskarte strikt an den verifizierten iCloud-Account und die registrierten Geräte des Mitglieds. -
Kontrollierte Selbstbearbeitung (
allowUserEdits: true): Erlaubt Mitgliedern, freigegebene Kontaktdaten (z. B. Telefonnummer oder E-Mail-Adresse) über ein sicheres Webportal selbst zu aktualisieren, während kritische Felder (expirationDate,membershipTier,memberNumber) administrativen Rechten vorbehalten bleiben. -
Drehkreuz-Prüfregeln am Empfang (
CHECK_IN scan mode): Die App Passinstance Scanner prüftstatus === ACTIVEund verifiziert, dass der Pass weder abgelaufen noch wegen Zahlungsausfall gesperrt ist.
Selbstbedienung für Mitglieder & Massenausgabe
-
Aufnahme neuer Mitglieder: Gewinnen Sie neue Mitglieder nahtlos über öffentliche PassFlow-Registrierungsformulare mit integrierter Kartenzahlung oder SMS-OTP-Verifizierung.
-
Synchronisierung bestehender Mitgliederlisten: Importieren Sie tausende Bestandsmitglieder in wenigen Minuten mit dem Batch Operations CSV Worker (
POST /api/v1/batch-processing) — ganz ohne manuelle Dateneingabe.
Wichtig: Wenn Sie in Ihren Vorlageneinstellungen
sharingProhibited: trueaktivieren, verhindern Sie effektiv, dass Club- oder Studiomitglieder ihre aktive Mitgliedskarte per Messenger oder AirDrop an nicht zahlende Gäste weitergeben.
Erfahren Sie mehr über Mitgliedskarten, Fitnessstudios & Clubs sowie Mitgliedschaften für gemeinnützige Organisationen.
