Skip to content
Guía del Centro de ayuda
4 min de lecturaVerificado 2026-11-16

Tarjetas de socio y suscripción

Sustituye los carnés plásticos en clubes, gimnasios y asociaciones con fechas de renovación actualizadas al instante.

En esta guía

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): membership o generic (muestra credenciales de socio con insignias de nivel claras y fechas de vencimiento en cabecera).
  • Plantillas de demostración del catálogo: gym-membership y hotel-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.

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
CICLO DE VIDA DE RENOVACIÓN DE SUSCRIPCIÓN
ACTORES DEL SISTEMA
P1 Webhook Stripe / CRM
P2 API Central Passinstance
P3 Base Passinstance database
P4 Wallet del dispositivo
PASO CTX CONTEXTO customer.subscription.updated
PASO 1 SOLICITUD / ACCIÓN POST/api/v1/passes/upsert-by-external-id
PASO 2 SOLICITUD / ACCIÓN Ampliar validez
›
expirationDate: "2027-12-31 23:59")
›
(Actualizar pase y
›
limpiar suspensiones)
PASO 3 SOLICITUD / ACCIÓN Push APNs silencioso
PASO 4 RESPUESTA 200 OK ({ data: { pass, action } })
›
y PATCH REST Google| (Alerta en pantalla:
›
"Membresía renovada")

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 (o PUT /api/v1/passes/by-external-id/:externalId) indexada por externalId (restricción única customerId + externalId sobre pases activos no eliminados).
  • Passinstance crea la tarjeta (action: "CREATED") si no existe ningún pase activo coincidente con externalId, o fusiona los valores actualizados de attributes, expirationDate y status: "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) o PassProject para 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_EXPIRATION suma automáticamente un intervalo configurado (por ejemplo, +30 días) a expirationDate cada 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 verifica status === ACTIVE y 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: true en 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.

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.