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
Bucle de retroalimentación visible: Ver subir el saldo de
500 → 550 puntostras la compra refuerza la percepción de valor del programa. -
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
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
-
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
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
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
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
Actualización en el dispositivo: El sistema descarga el paquete
.pkpasso 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 / Elemento | Nivel Miembro Base | Nivel VIP Oro | Nivel Platino Élite |
|---|---|---|---|
| Color de cabecera | #1b2d3c (Azul marino) | #D4AF37 (Acento dorado) | #020E25 (Pizarra noche) |
| Gráfico superior | Logotipo minimalista | Textura dorada | Diseño platino |
| Campo de saldo | 240 pts | 1.250 pts | 4.800 pts |
| Etiqueta de ventaja | Acumulación estándar | Multiplicador 1,25x + Envío gratis | Multiplicador 2,0x + Acceso preferente |
| Formato de código | QR / Aztec / PDF417 | QR / Aztec / PDF417 | QR / 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
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).
-
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.
-
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
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
{
"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.





