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 pase se actualiza y el cliente recibe un aviso en su billetera (Apple Wallet o Google Wallet); si dejó su correo, también le llega un correo
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

Tu cliente no descarga ninguna app. Escanea el QR del hablador o abre tu enlace de registro, escribe su nombre y su correo, y en esa misma pantalla recibe su pase con los botones Agregar a Apple Wallet y Agregar a la Billetera de Google.

iPhone

1. Toca "Agregar a Apple Wallet"
2. Safari muestra el pase; toca "Agregar" arriba a la derecha
3. El pase queda en la app Wallet, que ya viene en todo iPhone

Android

1. Toca "Agregar a la Billetera de Google"
2. Se abre Google Wallet (viene en casi todos los Android; si no, se descarga gratis de Play Store) y toca "Guardar"
3. Necesita una cuenta de Google iniciada en el teléfono

Sin billetera

"Ver mi pase en la web" abre el pase en el navegador con el mismo QR. Puede guardar ese enlace como favorito o agregarlo a su pantalla de inicio.

Las actualizaciones llegan solas

Cada vez que escaneas su pase, las visitas, el saldo o la vigencia cambian en su teléfono en segundos, sin que él haga nada. En iPhone además recibe un aviso en la pantalla de bloqueo con el nuevo estado.

Si pierde el pase

Cambió de teléfono o lo borró: que vuelva a abrir tu enlace de registro con el mismo correo. Forja lo reconoce ("¡Bienvenido de vuelta!") y le entrega el mismo pase con su progreso intacto.

Esto es para ti y tu equipo: la app del escáner. Tus clientes no la necesitan, ellos usan el pase en su billetera. 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 tuforja.com 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 tuforja.com 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"