Zum Hauptinhalt springen

Lokale Schnittstelle

Lokale Kassenschnittstelle: Über die lokale Kassenschnittstelle stellen Sie über einen Socket eine direkte Verbindung zum Endgerät her. Der Vorteil besteht darin, dass Sie über eine schnelle Verbindung verfügen, da sich sowohl Ihre Anwendung als auch das Endgerät im selben lokalen Netzwerk befinden. Der Nachteil ist, dass Sie die IP-Adresse des Endgeräts kennen müssen. Die Dokumentation zur lokalen Kassenschnittstelle variiert je nach der auf dem Endgerät installierten Anwendungsversion.

1. Voraussetzungen​

  • Ein registriertes Terminal (mit zugewiesener TID, PayDroid-Betriebssystem und Wallee-App auf dem neuesten Stand).
  • Die Funktion „Local Till API“ muss in der Terminalkonfiguration aktiviert sein.
  • Das POS-Gerät muss sich im selben lokalen Netzwerk wie das Terminal befinden.
  • Stellen Sie sicher, dass die Firewall den LAN-Datenverkehr zwischen POS und Terminal zulässt.

2. Das Terminal kennenlernen​

Es gibt zwei gängige Möglichkeiten, eine Verbindung herzustellen:

  1. mDNS-/Bonjour-Erkennung – Das Kassensystem erkennt automatisch verfügbare Endgeräte im LAN.
  2. Statische IP-Zuweisung – Das Endgerät wird mit einer festen IP-Adresse konfiguriert, und das Kassensystem stellt eine direkte Verbindung her.

Beispiel für eine Antwort auf eine Auskunftsanfrage:

{
  "terminalId": "32518857",
  "ip": "192.168.1.45",
  "port": 8080
}

3. Eine Transaktion starten​

Sobald das Terminal erreichbar ist, senden Sie eine POST-Anfrage an dessen lokale API:

POST http://192.168.1.45:8080/transactions/start
Content-Type: application/json

Beispiel für den Request-Body:

{
  "amount": {
    "currency": "CHF",
    "value": "23.60"
  },
  "transactionType": "PURCHASE",
  "reference": "ORDER-12345"
}

Antwort:

{
  "transactionId": "abc123",
  "status": "PENDING"
}

4. Statusaktualisierungen erhalten​

Das Terminal kann den POS über WebSocket-Callback oder durch Abfrage der API über Statusänderungen informieren.

Beispiel für ein Statusereignis:

{
  "transactionId": "abc123",
  "status": "APPROVED",
  "amount": {
    "currency": "CHF",
    "value": "23.60"
  },
  "reference": "ORDER-12345",
  "timestamp": "2025-09-25T10:24:00Z"
}

5. Testen der Integration​

  1. Verbinden Sie das Kassensystem und das Terminal mit demselben LAN.
  2. Führen Sie eine kleine Testtransaktion durch.
  3. Vergewissern Sie sich, dass das Terminal den Kunden auffordert, eine Eingabe vorzunehmen.
  4. Überprüfen Sie, ob das Kassensystem die Statusaktualisierung und das endgültige Transaktionsergebnis empfängt.