Documentación — Guía de pases digitales

Forja te permite crear programas de fidelización digital que tus clientes guardan directamente en Apple Wallet y Google Wallet. Sin app, sin plástico, sin fricción.

Forja ofrece 5 tipos de pase, cada uno diseñado para un modelo de negocio diferente:

El programa de visitas es el más popular. Cada vez que escaneas el pase del cliente, se suma una visita. Al completar el objetivo, el cliente acumula una recompensa canjeable.

Configuración

• Meta de visitas — Cuántas visitas necesita para ganar una recompensa (ej: 7, 10, 15)
• Descripción de recompensa — Lo que gana el cliente (ej: "Café gratis", "Lavado gratis")
• Color y diseño — Personaliza colores, logo y banner desde el editor de diseño

Cómo funciona

1. El cliente presenta su pase digital (desde Apple/Google Wallet)
2. Escaneas el QR del pase → se registra la visita
3. Al completar la meta (ej: 7/7) → se acumula 1 recompensa
4. El contador se reinicia a 0 y comienza un nuevo ciclo
5. Las recompensas se acumulan — el cliente decide cuándo canjear

Funciona igual que visitas, pero con la identidad visual de una tarjeta de sellos o ponchazos. Ideal para negocios que quieren esa experiencia clásica de "tarjeta de lealtad".

La diferencia con visitas es semántica: el pase dice "SELLOS" en vez de "VISITAS" y los mensajes de actualización dicen "sellos" en vez de "visitas". La lógica es idéntica — incluyendo las recompensas acumulables.

Las membresías son pases con fecha de vencimiento. Ideales para gimnasios, clubes, suscripciones o accesos VIP.

Estados de una membresía

Acciones disponibles

• Activar — Confirma la membresía de un cliente pendiente
• Renovar — Extiende la fecha de vencimiento
• Pausar / Reanudar — Congela la membresía (los días pausados se suman al vencimiento)
• Check-in — Al escanear, se registra la visita del miembro

Las gift cards tienen un saldo que se descuenta con cada uso. Pueden ser en dinero (USD) o en unidades (usos, servicios, etc.).

Dos modos de balance

Los cupones son promociones de uso limitado. Pueden ser de un solo uso (descuento único) o multi-uso (ej: 3 usos disponibles).

Configuración

• Descripción de la oferta — Lo que ofrece el cupón (ej: "20% en tu próxima compra")
• Número de usos — Cuántas veces se puede usar (default: 1)
• Fecha de expiración — Opcional. El cupón se marca como vencido automáticamente

Al escanear el cupón, se registra un uso. Cuando se agotan los usos, el pase cambia a estado "Canjeado" y se marca como inactivo en la wallet.

El escáner es la herramienta principal que usarás día a día. Accede desde el menú Escanear en el panel de Forja.

Métodos de escaneo

Cooldown de seguridad

Hay un intervalo de 2 minutos entre escaneos del mismo cliente para prevenir escaneos accidentales o duplicados. Si necesitas registrar una visita antes de que pase el cooldown, usa el botón "+1 visita" en el detalle del cliente.

Forja funciona incluso sin internet. Si pierdes la conexión mientras escaneas, los escaneos se guardan localmente y se sincronizan automáticamente cuando vuelve la conexión.

Cómo funciona

1. Si no hay internet, aparece un banner amarillo: "Sin conexión — los escaneos se guardarán localmente"
2. Al escanear, el pase se guarda en tu dispositivo (tarjeta azul: "Guardado offline")
3. Puedes seguir escaneando — todos se guardan en cola
4. Cuando vuelve el internet, los escaneos se sincronizan automáticamente
5. Verás un mensaje: "3 escaneos sincronizados"

En programas de visitas y sellos, las recompensas se acumulan. El cliente decide cuándo canjearlas.

Flujo de recompensas

1. El cliente completa las visitas requeridas (ej: 7/7)
2. Se acumula 1 recompensa → el cliente recibe un email de notificación
3. El contador de visitas se reinicia a 0 — comienza un nuevo ciclo
4. Las recompensas se acumulan (puede tener 0, 1, 2, 3...)
5. Al escanear un cliente con recompensas disponibles, aparece el botón "Canjear recompensa"
6. Al canjear, se descuenta 1 recompensa del total

Ejemplo práctico

Desde el editor de diseño puedes personalizar cómo se ve el pase en Apple Wallet y Google Wallet. Accede desde Programas → tu programa → Diseño del pase.

Opciones disponibles

Forja se puede instalar como una app en tu celular para acceder más rápido al escáner, sin abrir el navegador.

Android (Chrome)

1. Abre forja.cloud en Chrome
2. Inicia sesión en tu cuenta
3. Aparecerá un banner: "Instala Forja — Escanea sin abrir el navegador"
4. Toca "Instalar"
5. Forja aparece en tu pantalla de inicio como cualquier app

iPhone / iPad (Safari)

1. Abre forja.cloud en Safari
2. Inicia sesión en tu cuenta
3. Toca el botón de compartir (cuadrado con flecha hacia arriba)
4. Desplaza hacia abajo y toca "Agregar a pantalla de inicio"
5. Toca "Agregar"