Descripción general
Gimnasios, asociaciones deportivas, clubes privados, espacios de coworking y organizaciones sin ánimo de lucro sustituyen las costosas tarjetas plásticas de socio por pases digitales en vivo dentro de Apple Wallet y Google Wallet. Las tarjetas reflejan el nivel de membresía activo, actualizan automáticamente las fechas de renovación tras el pago y aplican validaciones de acceso diario en recepción.
Arquitectura del backend y tipos de pase
En el backend de Passinstance, las credenciales de suscripción emplean diseños específicos de membresía:
-
Tipo de pase (pass type):
membershipogeneric(muestra credenciales de socio con insignias de nivel claras y fechas de vencimiento en cabecera). -
Plantillas de demostración del catálogo:
gym-membershipyhotel-membership. -
Tipo de mecánica (mechanic type):
RENEW_EXPIRATION. -
Esquema principal de membresía:
- primaryFields: Nombre completo del socio ({fullName}). - secondaryFields: Nivel de membresía ({membershipTier}) y estado ({status}). - auxiliaryFields: Número de socio ({memberNumber}) y fecha de alta ({memberSince}). - headerFields: Fecha de vencimiento ({expirationDate}) formateada mediante ISO 8601 con formato localizado.
Extensión automática de vigencia y sincronización de renovaciones
Passinstance ofrece dos flujos diferenciados para gestionar renovaciones:
1. Integración con CRM y facturación controlada por webhooks
Cuando un socio renueva su suscripción recurrente a través de Stripe, Recurly o software propio de facturación:
-
El sistema externo de facturación envía una solicitud idempotente a
POST /api/v1/passes/upsert-by-external-id(oPUT /api/v1/passes/by-external-id/:externalId) indexada porexternalId(restricción únicacustomerId+externalIdsobre pases activos no eliminados). -
Passinstance crea la tarjeta (
action: "CREATED") si no existe ningún pase activo coincidente conexternalId, o fusiona los valores actualizados deattributes,expirationDateystatus: "ACTIVE"(action: "UPDATED"), devolviendo{ success: true, data: { pass, action: "CREATED" | "UPDATED" } }. -
Una notificación push silenciosa en segundo plano actualiza la tarjeta en Apple Wallet y Google Wallet, mostrando una alerta nativa en la pantalla de bloqueo cuando los campos definen mensajes de cambio con
%@. -
Para planes familiares o de hogar, vincule las tarjetas de los miembros bajo un mismo
bundleId(/api/v1/bundles) oPassProjectpara que todos los pases se instalen juntos.
2. Expiración basada en accesos (RENEW_EXPIRATION)
Para suscripciones por sesiones o ampliables por visita:
-
La mecánica
RENEW_EXPIRATIONsuma automáticamente un intervalo configurado (por ejemplo,+30 días) aexpirationDatecada vez que el pase se escanea con éxito en un torno de acceso.
Controles de seguridad e invariantes contra uso compartido
Para proteger los ingresos recurrentes de las membresías, Passinstance aplica restricciones de intercambio a nivel de dispositivo:
-
Restricción de AirDrop en Apple Wallet (
sharingProhibited: true): Oculta los iconos nativos de compartir y AirDrop en iOS, vinculando la tarjeta de socio estrictamente a la cuenta verificada de iCloud del titular y a sus dispositivos registrados. -
Ediciones de autoservicio controladas (
allowUserEdits: true): Permite a los socios actualizar datos personales autorizados (como teléfono de contacto o correo electrónico) mediante un portal web seguro mientras bloquea los campos críticos (expirationDate,membershipTier,memberNumber) tras controles administrativos de acceso. -
Validaciones en tornos de recepción (
CHECK_IN scan mode): La aplicación Passinstance Scanner verificastatus === ACTIVEy confirma que el pase no está caducado ni marcado por impago.
Autoservicio para socios y emisión masiva
-
Captación de nuevos socios: Registre miembros fácilmente usando formularios públicos PassFlow con pagos integrados con tarjeta o verificación OTP por SMS.
-
Sincronización del censo actual de socios: Importe miles de socios existentes en cuestión de minutos usando el Worker CSV de operaciones por lotes (
POST /api/v1/batch-processing), sin introducir datos manualmente.
Importante: Activar
sharingProhibited: trueen los ajustes de su plantilla impide que los socios de gimnasios y clubes reenvíen por mensaje o AirDrop su pase activo de membresía a invitados sin suscripción.
Obtenga más información en Tarjetas de membresía, Gimnasios y clubes y Membresías para ONG y asociaciones.
