Vue d'ensemble
Les clubs de fitness, associations sportives, cercles privés, espaces de coworking et organismes à but non lucratif remplacent leurs coûteuses cartes plastique d'adhérent par des passes numériques en direct dans Apple Wallet et Google Wallet. Les cartes reflètent le niveau d'adhésion actif, actualisent automatiquement les dates de renouvellement lors du paiement et appliquent un contrôle d'entrée quotidien à l'accueil.
Architecture backend & types de passes
Dans le backend Passinstance, les cartes d'abonnement utilisent des mises en page dédiées aux adhésions :
-
Type de passe (pass type) :
membershipougeneric(affiche les informations du membre avec des badges de niveau lisibles et la date d'expiration en en-tête). -
Modèles de démonstration du catalogue :
gym-membershipethotel-membership. -
Type de mécanique (mechanic type) :
RENEW_EXPIRATION. -
Schéma type d'adhésion :
- primaryFields : nom complet du membre ({fullName}). - secondaryFields : formule d'adhésion ({membershipTier}) et statut ({status}). - auxiliaryFields : numéro de membre ({memberNumber}) et date d'inscription ({memberSince}). - headerFields : date d'expiration ({expirationDate}) formatée selon ISO 8601 avec affichage localisé.
Prolongation automatisée d'expiration & synchronisation des renouvellements
Passinstance propose deux workflows distincts de renouvellement :
1. Intégration CRM & facturation pilotée par webhooks
Lorsqu'un membre renouvelle son abonnement récurrent via Stripe, Recurly ou un logiciel de facturation interne :
-
Le système de facturation externe envoie une requête idempotente vers
POST /api/v1/passes/upsert-by-external-id(ouPUT /api/v1/passes/by-external-id/:externalId) indexée parexternalId(contrainte d'unicitécustomerId+externalIdsur les passes actifs non supprimés). -
Passinstance crée la carte (
action: "CREATED") si aucun passe actif ne correspond àexternalId, ou fusionne les champsattributesmis à jour,expirationDateetstatus: "ACTIVE"(action: "UPDATED"), en retournant{ success: true, data: { pass, action: "CREATED" | "UPDATED" } }. -
Un push silencieux en arrière-plan rafraîchit la carte dans Apple Wallet et Google Wallet, affichant une notification native sur l'écran verrouillé lorsque les champs définissent un
changeMessageavec%@. -
Pour les abonnements foyer ou famille, reliez les cartes des membres sous un même
bundleId(/api/v1/bundles) ouPassProjectafin que tous les passes s'installent ensemble.
2. Expiration prolongée par passage (RENEW_EXPIRATION)
Pour les abonnements à la séance ou prolongés à chaque passage :
-
La mécanique
RENEW_EXPIRATIONajoute automatiquement une durée configurée (ex.+30 jours) àexpirationDateà chaque scan validé au portique d'entrée.
Contrôles de sécurité & prévention du partage
Pour protéger les revenus récurrents des abonnements, Passinstance intègre des restrictions de partage au niveau du matériel :
-
Restriction AirDrop Apple Wallet (
sharingProhibited: true) : supprime les boutons natifs iOS de partage et d'envoi par AirDrop du passe, rattachant strictement la carte d'adhérent au compte iCloud vérifié et aux appareils enregistrés du membre. -
Modifications contrôlées en libre-service (
allowUserEdits: true) : permet aux adhérents de mettre à jour leurs informations personnelles autorisées (comme leur téléphone ou adresse e-mail) via un portail web sécurisé tout en verrouillant les champs critiques (expirationDate,membershipTier,memberNumber) derrière les droits d'administration. -
Garde-fous au portique d'accueil (
CHECK_IN scan mode) : l'application Passinstance Scanner vérifie questatus === ACTIVEet confirme que l'abonnement n'est ni expiré ni suspendu pour défaut de paiement.
Auto-inscription des membres & émission en masse
-
Accueil des nouveaux adhérents : intégrez vos membres en toute fluidité grâce aux formulaires publics PassFlow dotés du paiement par carte bancaire intégré ou de la vérification par OTP SMS.
-
Synchronisation des listes existantes : importez des milliers de membres existants en quelques minutes grâce au Worker CSV des opérations en lot (
POST /api/v1/batch-processing), sans aucune saisie manuelle.
Important : Activer
sharingProhibited: truedans les paramètres du modèle empêche les membres d'une salle ou d'un club d'envoyer par message ou AirDrop leur carte d'abonnement active à des personnes non abonnées.
En savoir plus sur les Cartes de membre, les Centres de fitness & clubs et les Adhésions associatives.
