Saltar al contenido
HeartBadge docs

Tarjeta de Insignia y Código de Barras

Live

La superficie visual de tu insignia: lo que ves, lo que escaneas, cómo funciona la verificación.

Tu tarjeta de insignia es la representación visual de una membresía finalizada. Aparece después de que los requisitos aplicables de pago, verificación, ventana de protección y configuración estén completos. Si tu pedido aún está pendiente, revisa Activar Tu Insignia antes de crear otra compra.

Cuando está disponible, la tarjeta muestra tu identificador de 20 dígitos, la marca de tu programa y tu nivel actual de HRTB. En la parte inferior de la tarjeta hay un código de barras rotatorio que los operadores escanean para verificar tu presencia y activar acciones elegibles del programa.

La tarjeta

La tarjeta de insignia muestra:

  • Marca del programa. El nombre y la identidad visual del programa al que te uniste (el festival, club u operador).
  • Tu identificador de insignia. El número de 20 dígitos con checksum Luhn que identifica únicamente tu insignia. Ver Identificador de Insignia.
  • Tu nivel HRTB. El nivel (1x, 1.5x, 2x, 3x) que multiplica tus ganancias.

El código de barras

El código de barras en la parte inferior de la tarjeta rota cada 30 segundos. Esto es intencional — un código de barras estático podría ser fotografiado y reutilizado por otra persona. La rotación asegura que solo alguien con acceso actual a tu insignia pueda presentar un escaneo válido.

Cómo funciona la rotación: El código de barras codifica tu identificador de insignia más un componente basado en el tiempo. El lector del operador verifica que el componente de tiempo sea reciente (dentro de la ventana actual o anterior) y que el identificador de insignia sea válido. Si ambas condiciones se cumplen, el escaneo tiene éxito.

Cómo funciona el escaneo

  1. Presentas tu tarjeta de insignia. Abre la aplicación y muestra el código de barras al lector del operador (un teléfono, una tableta o un escáner dedicado).
  2. El lector verifica. El lector decodifica el código de barras, verifica la ventana de tiempo y comprueba el identificador de insignia. Esta verificación puede ocurrir sin conexión usando pruebas SPV que viajan con la insignia — sin necesidad de un viaje de ida y vuelta al servidor.
  3. El evento se registra. Un escaneo exitoso activa un evento de registro. Dependiendo de la configuración del programa, esto puede enviar recompensas a tu billetera, avanzar tu estado HRTB o simplemente registrar tu presencia.

Verificación sin conexión

Los festivales no siempre tienen señal. Los torniquetes de tránsito no pueden esperar un viaje de ida y vuelta a la nube. HeartBadge está diseñado para verificar en el borde. La insignia lleva sus propias pruebas (SPV + BEEF), y el lector puede verificarlas localmente. Un escaneo el domingo por la noche sin Wi-Fi aún se resuelve en una recompensa el lunes por la mañana una vez que la conectividad regresa.

Inmersión técnica: SPV y Sin Conexión.

NFC (próximamente)

El código de barras rotatorio es el método de escaneo actual. El soporte NFC — toca tu teléfono a un lector — está en despliegue. Ver Apple Wallet y Google Wallet.