Skip to content
Helpcentrum-gids
3 min leestijdGecontroleerd 2026-11-16

Lidmaatschaps- & abonnementspassen

Vervang plastic club-, sportschool- en verenigingspassen door live vernieuwbare Wallet-kaarten.

In deze gids

Overzicht

Fitnessclubs, sportverenigingen, besloten verenigingen, co-workinglocaties en non-profitorganisaties vervangen dure plastic ledenpassen door actuele digitale passen in Apple Wallet en Google Wallet. Passen tonen de actuele lidmaatschapsstatus en het niveau, werken verlengingsdatums automatisch bij na betaling en dwingen dagelijkse incheckvalidatie af bij de receptie.

Backendarchitectuur & pastypen

In de Passinstance-backend maken abonnementspassen gebruik van speciale lidmaatschapslay-outs:

  • Pastype (pass type): membership of generic (toont ledengegevens met duidelijke niveaulabels en vervaldatums in de koptekst).
  • Catalogus-demoblauwdrukken: gym-membership en hotel-membership.
  • Mechaniektype (mechanic type): RENEW_EXPIRATION.
  • Kernschema voor lidmaatschappen:

- primaryFields: Volledige naam van het lid ({fullName}). - secondaryFields: Lidmaatschapsniveau ({membershipTier}) en status ({status}). - auxiliaryFields: Lidnummer ({memberNumber}) en lid sinds ({memberSince}). - headerFields: Vervaldatum ({expirationDate}) geformatteerd volgens ISO 8601 met gelokaliseerde weergave.

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
ABONNEMENTSVERLENGING
DEELNEMENDE SYSTEEMACTOREN
P1 Stripe / CRM-webhook
P2 Passinstance Core API
P3 Passinstance database-database
P4 Wallet van lidapparaat
STAP CTX KONTEXT customer.subscription.updated
STAP 1 VERZOEK / ACTIE POST/api/v1/passes/upsert-by-external-id
STAP 2 VERZOEK / ACTIE Verleng geldigheid
›
expirationDate: "2027-12-31 23:59")
›
(Werk pasrecord bij
›
& hef blokkades op)
STAP 3 VERZOEK / ACTIE Stille APNs-push
STAP 4 ANTWOORD 200 OK ({ data: { pass, action } })
›
& Google REST PATCH | (Melding op scherm:
›
"Lidmaatschap verlengd")

Geautomatiseerde verlenging van de geldigheid & vernieuwingssync

Passinstance biedt twee afzonderlijke verlengingsworkflows:

1. Webhookgestuurde CRM- & facturatie-integratie

Wanneer een lid een terugkerend abonnement verlengt via Stripe, Recurly of eigen facturatiesoftware:

  • Stuurt het externe facturatiesysteem een idempotent verzoek naar POST /api/v1/passes/upsert-by-external-id (of PUT /api/v1/passes/by-external-id/:externalId) op basis van externalId (customerId + externalId unieke beperking binnen actieve, niet-verwijderde passen).
  • Passinstance maakt de pas aan (action: "CREATED") als geen actieve pas overeenkomt met externalId, of voegt bijgewerkte attributes, expirationDate en status: "ACTIVE" samen (action: "UPDATED"), en retourneert { success: true, data: { pass, action: "CREATED" | "UPDATED" } }.
  • Een stille achtergrondpush ververst de pas in Apple Wallet en Google Wallet en toont een native melding op het toegangsscherm wanneer velden %@-wijzigingsberichten definiëren.
  • Voor gezins- of familieabonnementen koppelt u ledenpassen onder een gedeelde bundleId (/api/v1/bundles) of PassProject, zodat alle ledenpassen samen worden geïnstalleerd.

2. Verlenging op basis van check-in (RENEW_EXPIRATION)

Voor rittenkaarten of abonnementen die per bezoek worden verlengd:

  • Het RENEW_EXPIRATION-mechaniek telt automatisch een ingesteld interval (bijv. +30 dagen) op bij expirationDate telkens wanneer de pas succesvol wordt gescand bij een toegangstourniquet.

Beveiligingsmaatregelen & voorkoming van delen

Om terugkerende abonnementsinkomsten te beschermen, past Passinstance deelbeperkingen op hardwareniveau toe:

  • Apple Wallet AirDrop-beperking (sharingProhibited: true): Verbergt de native iOS-pictogrammen voor het delen van passen en AirDrop, waardoor de ledenpas strikt gekoppeld blijft aan het geverifieerde iCloud-account en de geregistreerde apparaten van het lid.
  • Gecontroleerde selfservicebewerkingen (allowUserEdits: true): Laat leden toegestane persoonlijke gegevens (zoals telefoonnummer of e-mailadres) bijwerken via een beveiligd webportaal, terwijl kritieke velden (expirationDate, membershipTier, memberNumber) vergrendeld blijven achter beheerdersrollen.
  • Receptietourniquet-waarborgen (CHECK_IN scan mode): De Passinstance Scanner-app controleert of status === ACTIVE is en bevestigt dat de pas niet verlopen of geblokkeerd is wegens een mislukte betaling.

Selfservice voor leden & bulkuitgifte

  • Intake van nieuwe leden: Laat nieuwe leden moeiteloos inschrijven via openbare PassFlow-inschrijfformulieren met geïntegreerde creditcardbetalingen of sms-OTP-verificatie.
  • Synchronisatie van bestaand ledenbestand: Importeer duizenden bestaande leden binnen enkele minuten met de Batch Operations CSV-worker (POST /api/v1/batch-processing), zonder handmatige gegevensinvoer.

Belangrijk: Door sharingProhibited: true in uw sjablooninstellingen in te schakelen voorkomt u dat leden van sportscholen en clubs hun actieve ledenpas via berichtenapps of AirDrop doorsturen naar niet-betalende gasten.

Lees meer over Lidmaatschapspassen, Fitnesscentra & clubs en Lidmaatschappen voor non-profits.

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.