Programa de Fidelización

El programa de fidelización te permite recompensar a los estudiantes con puntos por asistir a clases, realizar compras y referir amigos. Los estudiantes acumulan puntos y los canjean por recompensas que tú defines — descuentos, clases gratuitas, crédito en cuenta o premios personalizados.

Activar el programa

Ve a Configuración → Fidelización y activa Habilitar Programa de Fidelización.

Configurar reglas de puntos

Configuración	Descripción	Predeterminado
Puntos por dólar gastado	Puntos otorgados por cada $1 pagado en reservas de clases y compras de paquetes	1
Puntos por check-in	Puntos otorgados cada vez que un estudiante registra su asistencia a una clase	10
Puntos por referido	Puntos otorgados cuando un estudiante referido realiza su primera reserva	50
Expiración de puntos (meses)	Cuántos meses antes de que los puntos no utilizados expiren. Déjalo en blanco para que no expiren.	Sin expiración

Haz clic en Guardar Configuración para aplicar los cambios. El programa comienza a otorgar puntos inmediatamente al activarse.

Crear recompensas

En la sección Catálogo de Recompensas, haz clic en Agregar Recompensa y completa:

Campo	Descripción
Nombre	El nombre de la recompensa que verán los estudiantes, ej. "Clase Gratuita" o "10% de Descuento"
Descripción	Detalles opcionales sobre la recompensa
Puntos requeridos	Cuántos puntos debe gastar el estudiante para canjear
Tipo de recompensa	Una de: % Descuento, Descuento Fijo, Clase Gratuita, Crédito en Cuenta, Recompensa Personalizada
Valor	Para descuentos: el porcentaje o monto en dólares. Para crédito: el monto agregado al saldo del estudiante. No se usa para Clase Gratuita ni Personalizada.
Máximo de canjes	Límite opcional del total de canjes. Déjalo en blanco para ilimitado.

Tipos de recompensa explicados

• % Descuento — Otorga al estudiante un porcentaje de descuento en su próxima compra (ej. 10% de descuento).
• Descuento Fijo — Otorga un monto fijo de descuento (ej. $5 de descuento).
• Clase Gratuita — Da derecho al estudiante a asistir a una clase sin costo.
• Crédito en Cuenta — Agrega un monto en dólares al saldo de crédito del estudiante, que se aplica automáticamente a su próxima reserva.
• Recompensa Personalizada — Una recompensa que cumples manualmente (ej. mercancía del estudio, una sesión privada). Rastrea los canjes en el panel y cumple fuera de línea.

Puedes desactivar una recompensa en cualquier momento cambiando su estado Activo. Las recompensas desactivadas ya no se pueden canjear, pero las recompensas previamente canjeadas siguen siendo válidas.

Cómo los estudiantes ganan puntos

Los puntos se otorgan automáticamente:

Acción	Cuándo se otorgan los puntos
Check-in de clase	Cuando el personal del estudio registra la asistencia del estudiante a una clase
Pago	Cuando se completa un pago (reserva de clase o compra de paquete)
Referido	Cuando un estudiante referido por este estudiante completa su primera reserva

Los puntos se registran en un libro mayor. Cada entrada muestra los puntos ganados, el motivo y el saldo acumulado. Los puntos del mismo evento nunca se otorgan dos veces (idempotente).

Otorgamiento manual

Los propietarios y administradores del estudio pueden otorgar puntos manualmente a cualquier estudiante a través de la API (POST /api/loyalty/points). Esto es útil para promociones especiales, premios de concursos o corrección de errores.

Cómo los estudiantes canjean recompensas

Los estudiantes ven su saldo de puntos y las recompensas disponibles en su panel. Para canjear:

1. El estudiante selecciona una recompensa del catálogo disponible.
2. Si tiene suficientes puntos, el canje se procesa instantáneamente.
3. Los puntos se deducen de su saldo.
4. Para recompensas de Crédito en Cuenta, el crédito se agrega automáticamente a su saldo.
5. Para otros tipos de recompensa, el canje se marca como Pendiente hasta que se utilice.

Expiración de puntos

Si configuras un período de expiración de puntos, los puntos que tengan más antigüedad que el número de meses configurado expirarán. Los puntos expirados se deducen del saldo del estudiante automáticamente.

tip

Establecer una expiración de puntos (ej. 12 meses) motiva a los estudiantes a mantenerse activos y canjear sus recompensas regularmente.

Ver datos de fidelización

Como propietario del estudio

• Configuración → Fidelización — Configura las reglas de puntos y gestiona el catálogo de recompensas.
• Perfil del estudiante — Ve los saldos de puntos individuales y el historial de transacciones.

Como estudiante

• Panel — Ve tu saldo actual de puntos y las recompensas disponibles.
• Canjear — Explora las recompensas y canjea directamente desde el panel.

Referencia de API

Endpoint	Método	Descripción
/api/loyalty/config	GET	Obtener configuración de fidelización
/api/loyalty/config	PUT	Actualizar configuración de fidelización (propietario/admin)
/api/loyalty/rewards	GET	Listar todas las recompensas
/api/loyalty/rewards	POST	Crear una recompensa (propietario/admin)
/api/loyalty/rewards/:id	PATCH	Actualizar una recompensa (propietario/admin)
/api/loyalty/rewards/:id	DELETE	Eliminar una recompensa (propietario/admin)
/api/loyalty/points	GET	Obtener saldo de puntos e historial del usuario actual
/api/loyalty/points	POST	Otorgar puntos manualmente (propietario/admin)
/api/loyalty/redeem	GET	Obtener historial de canjes del usuario actual
/api/loyalty/redeem	POST	Canjear una recompensa