Skip to content
Hilfecenter-Anleitung
3 Min. LesezeitGeprüft 2026-11-16

Mitglieds- & Abo-Karten

Ersetzen Sie Plastikkarten in Vereinen, Studios und Clubs durch digitale Ausweise mit dynamischen Verlängerungsdaten.

In dieser Anleitung

Ü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): membership oder generic (zeigt Mitgliedsdaten mit klaren Status-Badges und Ablaufdatum im Kopfbereich an).
  • Katalog-Demo-Vorlagen: gym-membership und hotel-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.

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
ABO-VERLÄNGERUNGS-LEBENSZYKLUS
BETEILIGTE SYSTEMKOMPONENTEN
P1 Stripe / CRM-Webhook
P2 Passinstance Core API
P3 Passinstance database-Datenbank
P4 Wallet des Mitglieds
SCHRITT CTX KONTEXT customer.subscription.updated
SCHRITT 1 ANFRAGE / AKTION POST/api/v1/passes/upsert-by-external-id
SCHRITT 2 ANFRAGE / AKTION Laufzeit verlängern
›
expirationDate: "2027-12-31 23:59")
›
(Pass aktualisieren
›
& Sperren aufheben)
SCHRITT 3 ANFRAGE / AKTION Stiller APNs-Push
SCHRITT 4 ANTWORT 200 OK ({ data: { pass, action } })
›
& Google REST PATCH | (Sperrbildschirm:
›
"Mitgliedschaft
›
erlängert")

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 (oder PUT /api/v1/passes/by-external-id/:externalId) anhand von externalId (customerId + externalId als eindeutige Bedingung über aktive, nicht gelöschte Pässe).
  • Passinstance erstellt die Karte (action: "CREATED"), falls kein aktiver Pass zu externalId existiert, oder führt aktualisierte attributes, expirationDate sowie status: "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) oder PassProject, sodass sich alle Karten zusammen installieren lassen.

2. Check-in-gesteuerte Verlängerung (RENEW_EXPIRATION)

Für besuchs- oder punktbasierte Mitgliedschaften:

  • Die Mechanik RENEW_EXPIRATION verlängert expirationDate automatisch 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üft status === ACTIVE und 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: true aktivieren, 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.

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.