Skip to content
Guide du centre d'aide
4 min de lectureVérifié 2026-11-16

Cartes de membre & abonnement

Remplacez les cartes plastique de clubs, salles de sport et associations par des cartes mises à jour au renouvellement.

Dans ce guide

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) : membership ou generic (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-membership et hotel-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é.

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
FLUX D'ARCHITECTURE SYSTÈME : CYCLE DE RENOUVELLEMENT D'ABONNEMENT
ACTEURS SYSTÈME PARTICIPANTS
P1 Webhook Stripe / CRM
P2 API Centrale Passinstance
P3 Base Passinstance database
P4 Wallet Appareil Membre
ÉTAPE CTX CONTEXTE customer.subscription.updated
ÉTAPE 1 REQUÊTE / ACTION POST/api/v1/passes/upsert-by-external-id
ÉTAPE 2 REQUÊTE / ACTION Prolonger validité
›
expirationDate: "2027-12-31 23:59")
›
(MàJ fiche passe
›
& lever suspension)
ÉTAPE 3 REQUÊTE / ACTION Push APNs silencieux
ÉTAPE 4 RÉPONSE 200 OK ({ data: { pass, action } })
›
& PATCH REST Google | (Alerte verrouillage :
›
"Adhésion renouvelée")

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 (ou PUT /api/v1/passes/by-external-id/:externalId) indexée par externalId (contrainte d'unicité customerId + externalId sur les passes actifs non supprimés).
  • Passinstance crée la carte (action: "CREATED") si aucun passe actif ne correspond à externalId, ou fusionne les champs attributes mis à jour, expirationDate et status: "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 changeMessage avec %@.
  • Pour les abonnements foyer ou famille, reliez les cartes des membres sous un même bundleId (/api/v1/bundles) ou PassProject afin 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_EXPIRATION ajoute 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 que status === ACTIVE et 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: true dans 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.

Documentation produit et développeur associée

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.