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):
membershipofgeneric(toont ledengegevens met duidelijke niveaulabels en vervaldatums in de koptekst). -
Catalogus-demoblauwdrukken:
gym-membershipenhotel-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.
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(ofPUT /api/v1/passes/by-external-id/:externalId) op basis vanexternalId(customerId+externalIdunieke beperking binnen actieve, niet-verwijderde passen). -
Passinstance maakt de pas aan (
action: "CREATED") als geen actieve pas overeenkomt metexternalId, of voegt bijgewerkteattributes,expirationDateenstatus: "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) ofPassProject, 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 bijexpirationDatetelkens 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 ofstatus === ACTIVEis 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: truein 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.
