Schnellstart

1. API auswählen

Die POS API v3 ist laut aktuellem Dokumentationsverzeichnis die maßgebliche Referenz für Kassenintegrationen. Für Speisepläne, Checkout, Verwaltung und Auswertungen stehen eigene API-Referenzen bereit.

2. Zugangsdaten vorbereiten

Für die POS API benötigst du einen DevKey, den du von menio erhältst. Bei der Registrierung eines Clients wird eine trackingUnitId vergeben. Weitere Anforderungen unterscheiden sich je nach Endpunkt. Die Authentifizierungsübersicht beschreibt die Verfahren je API.

3. Händlerdaten abrufen

Dieses Beispiel entspricht dem Merchant-Info-Endpunkt der POS-Referenz. Ersetze {qnipsUserName} durch den URL-kodierten Benutzernamen des Händlers. Setze DEV_KEY in deiner lokalen Umgebung; veröffentliche den Schlüssel nicht im Quellcode.

API_BASE='https://pos-playground-eu.qnips.com/api/pos/v3'
curl --request GET \
  "${API_BASE}/merchants/{qnipsUserName}/info" \
  --header "DevKey: ${DEV_KEY}" \
  --header 'Accept: application/json'

Der Endpunkt liefert gemäß Blueprint die verfügbaren Brands und Outlets. Wähle anschließend die passende Filiale und registriere den Client als Tracking Unit. Die Einzelschritte und erforderlichen Parameter findest du in der POS API v3.

4. In der richtigen Umgebung arbeiten

Die POS-v3-Quelle nennt pos-playground-eu.qnips.com als Testumgebung und pos-live-eu.qnips.com als produktive Umgebung. Die technischen Domains gehören zum bestehenden Schnittstellenvertrag und werden im Portal unverändert dargestellt.

Das Portal führt keine API-Aufrufe aus und speichert keine Zugangsdaten. Die Request-Beispiele sind zum Lesen und Kopieren vorgesehen.

5. Versionsstand berücksichtigen

Die importierten Blueprints stammen aus dem Backup vom 16. März 2026. Ein Backup belegt keine heutige Erreichbarkeit oder unveränderte Funktion des Backends. Beta- und Archivstände sind separat gekennzeichnet. Prüfe für deine Integration die vorgesehene Umgebung und den Produktstatus mit menio.