Skip to content
Volver al blog

Puntos de fidelidad al instante en caja: flujos Wallet en tiempo real y arquitectura TPV

Conecte la validación con escáner, las actualizaciones de saldo en directo y los avisos en pases Wallet en un flujo fluido en caja para Apple Wallet y Google Wallet.

Passinstance Team
Passinstance Team

Wallet pass platform team

2026-08-165 min de lectura
Imagen de portada para Puntos de fidelidad al instante en caja: flujos Wallet en tiempo real y arquitectura TPV

Los programas de puntos fracasan cuando los saldos tardan en actualizarse. Cuando un cliente realiza una compra y sus puntos no aparecen hasta horas después —o a la mañana siguiente por correo electrónico—, se pierde el vínculo inmediato entre el gasto y la recompensa.

Por el contrario, los flujos modernos en billetera móvil ofrecen refuerzo inmediato: el personal escanea el pase, el TPV valida la compra y el teléfono del cliente recibe la actualización en la pantalla de bloqueo tras el cobro.

Esta guía detalla la arquitectura técnica, la configuración de hardware, el diseño visual dinámico y la integración por API necesarios para ofrecer actualizaciones ágiles de puntos en caja tanto en Apple Wallet como en Google Wallet.


1. La psicología del refuerzo inmediato

En el comercio físico y la hostelería, la recurrencia se apoya en la Regla del Pico-Final y en una respuesta visible tras cada visita:

  1. 1
    Bucle de retroalimentación visible: Ver subir el saldo de 500 → 550 puntos tras la compra refuerza la percepción de valor del programa.
  2. 2
    Eliminación de fricción: Los clientes no necesitan abrir una app adicional ni iniciar sesión en un portal web. El pase reside en Apple Wallet o Google Wallet, accesible rápidamente desde el teléfono.
  3. 3
    Valor tangible frente a sellos manuales: Actualizar los saldos al completar la venta evita depender de correos nocturnos o tarjetas de papel difíciles de seguir.

2. Arquitectura TPV en tiempo real de extremo a extremo

Entregar actualizaciones ágiles de puntos se basa en una arquitectura orientada a eventos que conecta el escaneo en caja con Apple APNs y las actualizaciones de Google Wallet.

Secuencia de actualización en caja

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
FLUJO DE ARQUITECTURA
ACTORES DEL SISTEMA
P1 Teléfono Cliente (Pase Wallet)
P2 TPV / Escáner (Punto de venta)
P3 Motor Passinstance (API Cloud)
P4 APNs / Google Wallet Services
PASO 1 SOLICITUD / ACCIÓN Escaneo Código/QR
PASO 2 SOLICITUD / ACCIÓN POST/mechanics/redeem
PASO 3 SOLICITUD / ACCIÓN Suma Puntos y Nivel
PASO 4 SOLICITUD / ACCIÓN Envío de Actualización
PASO 5 RESPUESTA 200 OK + Nuevo Estado
PASO 6 RESPUESTA Refresco del Pase y Aviso Nativo en Bloqueo
›
«Lumora Home: +50 pts sumados. Saldo: 550»
  1. 1
    Captura: El cliente muestra su pase de Apple Wallet o Google Wallet. El escáner de presentación 2D decodifica el código de barras (p. ej., UUID del cliente o ID de miembro).
  2. 2
    Envío de transacción: El terminal TPV transmite el evento a Passinstance con el identificador de la operación, el importe de la cesta, los artículos y el establecimiento.
  3. 3
    Motor de reglas y cálculo de nivel: La API de Passinstance valida el evento, calcula multiplicadores de puntos (p. ej., puntos dobles en campañas promocionales) y evalúa ascensos de categoría.
  4. 4
    Envío de actualización: Passinstance activa una notificación Apple Push Notification (APNs) para dispositivos iOS y una actualización REST de Google Wallet para Android.
  5. 5
    Actualización en el dispositivo: El sistema descarga el paquete .pkpass o JSON actualizado de Google Wallet, refresca el saldo visible y muestra el aviso configurado en pantalla de bloqueo:

> Lumora Home Rewards > Puntos añadidos con éxito: +50 puntos ganados. Su saldo actual es 550.


3. Progresión visual dinámica de niveles

Un pase estático se olvida pronto. Los pases dinámicos cambian su apariencia visual según el progreso del cliente y su categoría VIP.

Transiciones visuales de estado

Métrica / ElementoNivel Miembro BaseNivel VIP OroNivel Platino Élite
Color de cabecera#1b2d3c (Azul marino)#D4AF37 (Acento dorado)#020E25 (Pizarra noche)
Gráfico superiorLogotipo minimalistaTextura doradaDiseño platino
Campo de saldo240 pts1.250 pts4.800 pts
Etiqueta de ventajaAcumulación estándarMultiplicador 1,25x + Envío gratisMultiplicador 2,0x + Acceso preferente
Formato de códigoQR / Aztec / PDF417QR / Aztec / PDF417QR / Aztec / PDF417

Cuando un cliente supera un umbral de nivel en caja, Passinstance sustituye dinámicamente los recursos de la plantilla: actualiza colores, imágenes superiores y etiquetas de membresía.


4. Configuración de hardware y escáneres

No todos los lectores leen igual las pantallas de smartphones. Los códigos en billeteras móviles requieren escáneres ópticos de imagen 2D calibrados para superficies de vidrio con reflejos.

Buenas prácticas de hardware

  1. 1
    Tipos de escáner:

- Recomendados: Escáneres de presentación 2D por imagen (Zebra DS9308, Honeywell Genesis 7580g, Datalogic Magellan). - Evitar: Lectores láser 1D antiguos (el haz láser rebota en el cristal de la pantalla y no lee códigos digitales).

  1. 2
    Gestión de brillo y contraste:

- Apple Wallet aumenta automáticamente el brillo de la pantalla al máximo cuando un pase está abierto. - Use códigos monocromáticos de alto contraste (negro sobre fondo blanco puro) dentro del pase para lograr lecturas ópticas fiables al primer intento.

  1. 3
    Resiliencia con cola offline:

- Ante pérdidas puntuales de conectividad en tienda, el TPV debe almacenar localmente el registro de la operación y reenviar los eventos pendientes a Passinstance en cuanto vuelva la red.


5. Esquema de integración REST API

Integrar actualizaciones de puntos en su TPV actual o comercio electrónico propio requiere una única petición a la API:

Endpoint para sumar puntos

BASH
curl -X POST https://api.passinstance.com/api/v1/mechanics/redeem \
  -H "X-API-Key: pi_live_tu_clave_de_espacio" \
  -H "Content-Type: application/json" \
  -d '{
    "passId": "pass_99847291",
    "mechanicId": "mech_loyalty_points",
    "action": "EARN",
    "amount": 50,
    "referenceId": "TXN_8849204"
  }'

Carga útil de respuesta

JSON
{
  "status": "APPLIED",
  "passId": "pass_99847291",
  "balance": 550,
  "tier": "Signature Tier",
  "updatedAt": "2026-08-16T15:42:01.120Z"
}

6. Indicadores clave a supervisar

Para medir la eficacia operativa de su programa en caja, haga seguimiento de estos KPI en el panel de análisis y en los informes de su TPV:

  • Confirmación de entrega de actualizaciones: Verifique que las peticiones de actualización en APNs y Google Wallet se completen correctamente tras cada escaneo en caja.
  • Tasa de escaneo en mostrador: Porcentaje de compras en caja en las que los clientes presentan su pase Wallet.
  • Tasa de repetición en el mismo mes: Frecuencia de regreso de los clientes durante los 30 días posteriores a recibir una actualización de saldo.
  • Tasa de permanencia del pase: Proporción de pases emitidos que permanecen guardados en los dispositivos a lo largo del tiempo.

Conclusión y próximos pasos

Las actualizaciones ágiles de puntos convierten las tarjetas de fidelización en un ciclo práctico entre el mostrador y la billetera móvil. Al combinar escáneres ópticos 2D con las mecánicas y la API de actualización de Passinstance, su equipo comercial reduce la dependencia de tarjetas plásticas y construye un flujo de cliente repetible.

¿Listo para implantar fidelización en Wallet en sus tiendas? Explore nuestra Documentación de la API REST o concierte una consulta técnica con nuestro equipo.

Demo interactiva en vivo
Apple Wallet y Google Wallet

Pruebe un pase real de Wallet en su teléfono

Compruebe cómo funcionan los pases digitales. Escanee con la cámara de su teléfono o pulse abajo para añadirlo directamente a Apple Wallet o Google Wallet.

Artisan RoastersCafé & F&B
Test QR code for Artisan Roasters

Escanear con la cámara del móvil

Relacionado en este tema

Fidelización, tarjetas de sellos y ofertas

Abrir centro de temas

¿Listo para lanzar su programa de tarjetas de billetera?

Cree su cuenta, diseñe su plantilla de tarjeta y pruebe tarjetas reales directamente en Apple Wallet y Google Wallet.