Escenario: El cupón impreso debe activarse en vivo
Una empresa comercial reparte folletos con un código QR que activa un descuento en la tienda. La promoción solo está vigente en determinados días, los cupones deben ser válidos una sola vez por cliente y el sistema de caja debe saber inmediatamente si la redención está autorizada. Los folletos ya están impresos: el propio código QR no puede cambiar, pero sí el comportamiento que hay detrás.
Por qué un código QR dinámico es la mejor opción aquí
Un código QR dinámico separa la imagen física impresa del destino digital: el código permanece en el folleto, mientras que el destino (p. ej., URL, PDF, token de cupón) puede ajustarse en el servidor en cualquier momento. Así se puede controlar en tiempo real si un escaneo activa un descuento válido, muestra una página de error o redirige a una página de la promoción. Esto reduce pérdidas por material impreso obsoleto y permite el seguimiento de redenciones.
Así funciona la integración en tiempo real con Linkentra
Linkentra suministra las herramientas para enviar eventos a sistemas externos inmediatamente al escanear: webhooks para notificaciones push y una API para consultas e informes. En combinación con su TPV se pueden autorizar descuentos, verificar cupones y registrar redenciones —en tiempo real y controlable desde la interfaz de Linkentra o mediante automatizaciones propias.
Proceso típico (de extremo a extremo)
- El cliente escanea el código QR dinámico en la caja.
- Linkentra evalúa el escaneo y, si procede, dispara un webhook a la URL de endpoint del TPV registrada.
- El sistema TPV recibe el evento (ID de escaneo, ID de campaña QR, sello de tiempo, metadatos opcionales como ubicación o dispositivo) y verifica la validez (periodo de vigencia, redención única, cuenta de cliente).
- El TPV responde (éxito/denegado) o realiza una comprobación server‑side mediante la API de Linkentra.
- Según el resultado, el TPV aplica el descuento o rechaza la redención; Linkentra registra el proceso en las estadísticas.
¿Por qué usar webhooks y API juntos?
Los webhooks proporcionan notificaciones rápidas basadas en push a su TPV para que la caja pueda reaccionar al instante. La API complementa esto con consultas bajo demanda, descargas masivas para informes y la capacidad de cambiar reglas de campaña de forma automatizada (p. ej., intercambiar la URL de destino, establecer control por tiempo). Esta combinación ofrece velocidad de reacción y control.
Implementación concreta: paso a paso
La siguiente guía práctica ayuda a integrar en una configuración típica de TPV:
1. Preparación en Linkentra
- Crear un código QR dinámico para la promoción y asignar una ID de campaña.
- Configurar en el backend de Linkentra el endpoint del webhook: la URL de su sistema POS y los eventos (p. ej. "scan").
- Opcional: establecer reglas temporales o destinos de reserva (p. ej. detener tras la fecha de caducidad).
2. Configurar el endpoint del POS
- Desarrollar un endpoint HTTP(S) seguro que reciba peticiones POST con carga JSON.
- Implementar autenticación (p. ej. firma HMAC o un token Bearer) y verificar la firma en cada petición.
3. Payload de ejemplo (simplificado)
Un evento típico de webhook contiene como mínimo la siguiente información, que su POS puede usar para validar:
{
"scan_id": "abc123",
"qr_id": "camp-2026-fruehling",
"timestamp": "2026-10-27T12:34:56Z",
"location": "Filiale Berlin Mitte",
"metadata": {"device":"kasse-05","user_id":"optional"}
}
4. Validación y respuesta
- Comprobar la validez (ventana temporal, número máximo de redenciones, estado del cliente).
- Asegurarse de que las solicitudes se procesen de forma idempotente (p. ej. aceptar solo una redención por scan_id).
- Si es necesario, enviar una confirmación de estado a Linkentra o registrar el resultado en su propio sistema de logs/informes.
5. Monitorización y manejo de errores
- Implementar reintentos y mecanismos de reprogramación: Linkentra admite reintentos de webhook ante errores temporales.
- Supervisar las tasas de error y los eventos procesados para detectar problemas de forma temprana.
Buenas prácticas para redenciones seguras y robustas
- Protección: Utilizar firmas HMAC, TLS y listas blancas de IP para proteger los endpoints de webhook.
- Idempotencia: Procesar eventos duplicados de modo que una redención no se contabilice varias veces.
- Reservas: Planificar escenarios offline: si la API del POS no está disponible, Linkentra puede mostrar un objetivo alternativo o bloquear temporalmente la redención.
- Transparencia: Registrar scan_ids, marcas temporales y códigos de resultado para auditorías e informes.
- Limitación: Establecer reglas para el número máximo de redenciones por campaña o por cliente para prevenir abusos.
Ejemplo práctico: Cafetería con cupón de Happy Hour
Una cafetería distribuye carteles de mesa con un código QR que durante la Happy Hour concede un 20 % en todas las bebidas. Implementación:
- Linkentra genera un QR dinámico; el destino se ajusta mediante programación horaria según las reglas de la Happy‑Hour.
- Al escanear, Linkentra desencadena un webhook al sistema de caja; el TPV verifica si la redención se realiza dentro del intervalo temporal y si el cupón ya ha sido usado.
- El TPV aplica el descuento y envía una confirmación al reporting, Linkentra cuenta el escaneo y muestra las estadísticas de redención.
Ventajas: sin reimpresión de expositores de mesa, control en tiempo real de la promoción, análisis preciso y, si es necesario, solución completamente Self‑Hosted para operadores que deseen la soberanía de sus datos.
¿Self‑Hosted u opción en la nube?
Linkentra ofrece ambas opciones: Cloud‑SaaS para una puesta en marcha rápida y una instalación Self‑Hosted para empresas que quieran controlar por completo su infraestructura y sus datos. Para integraciones sensibles con el TPV se recomienda la opción Self‑Hosted, ya que las políticas internas de seguridad, redes y requisitos de cumplimiento se pueden satisfacer más fácilmente.
Lista de comprobación rápida para la implementación
- Crear la campaña de QR en Linkentra y configurar el webhook.
- Verificar el endpoint del TPV con autenticación e idempotencia.
- Realizar pruebas (redenciones aceptadas/rechazadas, expiración temporal, escenarios sin conexión).
- Activar monitorización y registro; configurar alertas ante errores.
- Seguimiento: usar las estadísticas de escaneos de Linkentra para optimizar la campaña.
Conclusión
Con códigos QR dinámicos, webhooks y una integración API, las redenciones en el TPV pueden gestionarse, validarse y registrarse en tiempo real. Linkentra proporciona los componentes —desde destinos dinámicos y webhooks hasta la opción Self‑Hosted—, permitiendo flujos de trabajo de descuentos y cupones flexibles, seguros y auditables sin impresiones constantes. Para comercios, hostelería y organizadores de eventos, es una solución eficiente para controlar promociones y, al mismo tiempo, recopilar datos de uso valiosos.
Siguiente paso
Probar Linkentra por ti mismo
Códigos QR dinámicos con control sobre el hosting y los datos: cambiar contenidos posteriormente, adaptar la imagen de marca, gestionar medios de forma centralizada y analizar escaneos —opcionalmente en infraestructura propia (Self‑Hosted) o inmediatamente en la Linkentra Cloud. Funciones según edición para equipos, API y White‑Label.