Szenario: Der gedruckte Coupon muss live freigeschaltet werden
Ein Handelsunternehmen verteilt Flyer mit einem QR‑Code, der einen Rabatt im Laden löst. Die Aktion läuft nur an bestimmten Tagen, Gutscheine sollen nur einmal pro Kunde gültig sein und das Kassensystem muss sofort wissen, ob die Einlösung autorisiert ist. Die Flyer sind bereits gedruckt — der QR‑Code selbst darf sich nicht ändern, wohl aber das Verhalten dahinter.
Warum ein dynamischer QR‑Code hier die bessere Wahl ist
Ein dynamischer QR‑Code trennt das physische Druckbild vom digitalen Ziel: Der Code bleibt auf dem Flyer, während das Ziel (z. B. URL, PDF, Coupon‑Token) jederzeit serverseitig angepasst wird. So lässt sich in Echtzeit steuern, ob ein Scan einen gültigen Rabatt auslöst, eine Fehlerseite zeigt oder auf eine Aktionsseite weiterleitet. Das reduziert Verlust durch veraltete Drucksachen und ermöglicht Nachverfolgung von Einlösungen.
So funktioniert die Echtzeit‑Integration mit Linkentra
Linkentra liefert die Tools, um beim Scan sofort Events an externe Systeme zu senden: Webhooks für Push‑Benachrichtigung und eine API für Abfragen und Reporting. Im Zusammenspiel mit Ihrem POS lassen sich Rabatte freigeben, Coupons prüfen und Einlösungen protokollieren — in Echtzeit und steuerbar über die Linkentra‑Oberfläche oder eigene Automatisierungen.
Typischer Ablauf (End‑to‑End)
- Kunde scannt den dynamischen QR‑Code an der Kasse.
- Linkentra wertet den Scan aus und löst bei Bedarf einen Webhook an die hinterlegte POS‑Endpoint‑URL aus.
- Das POS‑System empfängt das Event (Scan‑ID, QR‑Kampagnen‑ID, Zeitstempel, optional Metadaten wie Standort oder Gerät) und prüft Validität (Gültigkeitszeitraum, einmalige Einlösung, Kundenkonto).
- POS antwortet (erfolgreich/abgelehnt) oder führt eine serverseitige Prüfung über die Linkentra‑API durch.
- Je nach Ergebnis wird am POS der Rabatt gewährt oder die Einlösung abgelehnt; Linkentra protokolliert den Ablauf in den Statistiken.
Warum Webhooks und API zusammen nutzen?
Webhooks liefern schnelle, push‑basierte Benachrichtigungen an Ihr POS, damit die Kasse sofort reagieren kann. Die API ergänzt das durch on‑demand‑Abfragen, Bulk‑Downloads für Reporting und die Möglichkeit, Kampagnenregeln automatisiert zu ändern (z. B. Ziel‑URL tauschen, Zeitsteuerung setzen). Diese Kombination sorgt für Reaktionsgeschwindigkeit und Kontrolle.
Konkrete Implementierung: Schritt für Schritt
Die folgende praktische Anleitung hilft bei der Integration in ein typisches POS‑Setup:
1. Vorbereitung in Linkentra
- Erstellen Sie einen dynamischen QR‑Code für die Aktion und vergeben Sie eine Kampagnen‑ID.
- Konfigurieren Sie im Linkentra‑Backend den Webhook‑Endpunkt: die URL Ihres POS‑Systems, die Events (z. B. "scan").
- Optional: Legen Sie zeitliche Regeln oder Fallback‑Ziele fest (z. B. Stopp nach Ablaufdatum).
2. POS‑Endpoint aufsetzen
- Entwickeln Sie einen sicheren HTTP(S)‑Endpoint, der POST‑Requests mit JSON‑Payload entgegennimmt.
- Implementieren Sie Authentifizierung (z. B. HMAC‑Signatur oder ein Bearer‑Token) und prüfen Sie die Signatur bei jedem Request.
3. Beispielpayload (vereinfacht)
Ein typisches Webhook‑Event enthält minimal folgende Informationen, die Ihr POS zur Validierung nutzen kann:
{
"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. Validierung & Antwort
- Prüfen Sie Gültigkeit (Zeitfenster, maximale Einlösungen, Kundenstatus).
- Stellen Sie sicher, dass Anfragen idempotent verarbeitet werden (z. B. nur eine Einlösung pro scan_id akzeptieren).
- Senden Sie bei Bedarf eine Statusbestätigung an Linkentra oder schreiben Sie das Ergebnis in Ihr eigenes Log‑/Reporting‑System.
5. Monitoring und Fehlerbehandlung
- Implementieren Sie Retries und Rückstellmechanismen: Linkentra unterstützt Webhook‑Retries bei kurzzeitigen Fehlern.
- Überwachen Sie Fehlerraten und verarbeitete Events, um Probleme früh zu erkennen.
Best Practices für sichere, robuste Einlösungen
- Absicherung: Nutzen Sie HMAC‑Signaturen, TLS und IP‑Whitelists, um Webhook‑Endpoints zu schützen.
- Idempotenz: Verarbeiten Sie duplicate Events so, dass eine Einlösung nicht mehrfach abgerechnet wird.
- Fallbacks: Planen Sie Offline‑Szenarien: Wenn die POS‑API nicht erreichbar ist, kann Linkentra ein alternatives Ziel anzeigen oder die Einlösung zeitlich blocken.
- Transparenz: Loggen Sie Scan‑IDs, Zeitstempel und Ergebniscodes für Audits und Reporting.
- Limitierung: Setzen Sie Regeln für maximale Einlösungen pro Kampagne oder pro Kunde, um Missbrauch zu verhindern.
Praxisbeispiel: Café mit Happy‑Hour‑Coupon
Ein Café verteilt Tischaufsteller mit einem QR‑Code, der während der Happy Hour 20 % auf alle Getränke gewährt. Umsetzung:
- Linkentra erzeugt einen dynamischen QR, Ziel wird per Zeitsteuerung auf die Happy‑Hour‑Regeln gesetzt.
- Beim Scan löst Linkentra einen Webhook an das Kassensystem aus; das POS prüft, ob die Einlösung innerhalb des Zeitfensters erfolgt und ob der Coupon bereits genutzt wurde.
- Das POS gewährt den Rabatt und sendet eine Bestätigung in das Reporting, Linkentra zählt den Scan und zeigt die Einlösestatistik.
Vorteile: Keine Neuauflage von Tischaufstellern, Echtzeitkontrolle der Aktion, genaue Auswertung, und bei Bedarf komplette Self‑Hosted‑Lösung für Betreiber, die Datenhoheit wünschen.
Self‑Hosted oder Cloud‑Option?
Linkentra bietet beides: Cloud‑SaaS für schnelle Einrichtung und Self‑Hosted‑Installation für Unternehmen, die ihre Infrastruktur und Daten vollständig kontrollieren möchten. Für sensible POS‑Integration empfiehlt sich die Self‑Hosted‑Option, weil interne Sicherheitsrichtlinien, Netzwerke und Compliance-Anforderungen so leichter erfüllt werden können.
Schnell‑Checkliste zur Umsetzung
- QR‑Kampagne in Linkentra anlegen und Webhook konfigurieren.
- POS‑Endpoint mit Authentifizierung und Idempotenz prüfen.
- Testläufe durchführen (erfolgreiche/abgelehnte Einlösungen, Zeitüberschreitung, Offline‑Szenarien).
- Monitoring und Logging aktivieren; Alerts bei Fehlern einrichten.
- Nachhalten: Scan‑Statistiken aus Linkentra zur Kampagnenoptimierung verwenden.
Fazit
Mit dynamischen QR‑Codes, Webhooks und einer API‑Integration lassen sich Einlösungen am POS in Echtzeit steuern, validieren und protokollieren. Linkentra liefert die Bausteine — von dynamischen Zielen über Webhooks bis zur Self‑Hosted‑Option — und ermöglicht so flexible, sichere und nachvollziehbare Rabatt‑ und Coupon‑Workflows ohne ständige Nachdrucke. Für Händler, Gastronomie und Eventveranstalter ist das eine effiziente Lösung, um Aktionen zu kontrollieren und zugleich wertvolle Nutzungsdaten zu sammeln.
Nächster Schritt
Linkentra selbst ausprobieren
Dynamische QR-Codes mit Kontrolle über Hosting und Daten: Inhalte nachträglich ändern, Branding anpassen, Medien zentral verwalten und Scans auswerten – wahlweise auf eigener Infrastruktur (Self‑Hosted) oder sofort in der Linkentra Cloud. Editionsabhängige Funktionen für Teams, API und White‑Label.