Sessie- en loginlevenscyclus

Een Local API-sessie is de periode tussen een Login en een Logout. Transacties kunnen alleen binnen een open sessie worden uitgevoerd. Dit geldt voor de HTTP- en TCP/IP-transports; de Cloud API heeft geen sessie.

Login

POST /login opent de sessie. Stuur uw SaleSoftware-gegevens (applicatienaam, aanbieder, versie). In de Login geeft de POS de hoogste ondersteunde protocolversie door; het terminal antwoordt met de versie die het zal gebruiken voor de sessie.

Een Response.Result van Success bevestigt dat de sessie open is. Als het binnenkomende bericht niet kan worden geparseerd, retourneert het terminal in plaats daarvan een EventNotification met EventToNotify: Reject.

Werken binnen de sessie

• Er loopt altijd slechts één servicedialoog tegelijk. Het starten van een tweede betaling voordat de eerste is afgerond, geeft een Busy of NotAllowed conditie terug (HTTP 403 op het betaalendpoint terwijl er een betaling bezig is).
• Bewaar de POITransactionID van elke voltooide betaling voor latere terugboekingen, terugbetalingen en statusvragen.

Detecteren van een hardwarewissel

Bewaar het serienummer van het terminal bij de eerste login (beschikbaar via een Diagnose-oproep) en controleer dit bij volgende logins. Een veranderd serienummer betekent dat het fysieke terminal achter hetzelfde adres is gewisseld — een risico op fraude en afstemming dat uw POS moet signaleren.

Logout

POST /logout sluit de sessie. Log opnieuw in na elke terminalherstart of firmware-update. Operaties die na een logout of na het verlopen van de sessie worden verzonden, geven de LoggedOut conditie terug.