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 eine schnelle Verbindung haben, 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 POS-System erkennt verfügbare Endgeräte im LAN automatisch.
  2. Statische IP-Zuweisung – Das Endgerät ist mit einer festen IP-Adresse konfiguriert, und das POS-System 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, sende 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 dem POS Statusänderungen über einen WebSocket-Callback oder durch Abfrage der API mitteilen.

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 erhält.