Standaard POS-integratie

De basisbetaalstroom beschrijft de noodzakelijke berichten die uw POS moet beheren om efficiënt te functioneren:

  1. Login: start een operationele sessie met de terminal, waardoor transacties vanuit de POS verwerkt kunnen worden.

  2. Betaling: verkooptransactie, waarbij een kaart of ander instrument wordt gebruikt om een aankoop aan het verkooppunt te voltooien.

  3. Annuleren: stopt onmiddellijk en annuleert een lopende transactie voordat de autorisatie is gestart.

  4. TransactionStatus: controleer de uiteindelijke uitkomst of de laatst bekende verwerkingsstatus van een eerdere transactie, meestal geactiveerd na verloren communicatie tussen POS en POI.

  5. Reversal: maak een recent goedgekeurde transactie ongedaan door het geld terug te storten op de rekening of kaart van de klant, voordat de transactie financieel is afgehandeld.

  6. Terugbetaling: geef geld terug aan een klant na een verkoop die al is afgehandeld, meestal vanwege een productretour.

  7. Logout: Dit verzoek sluit de actieve operationele sessie op de terminal af, waarmee de shift of gebruiksperiode van de kassier wordt beëindigd.

Met deze 7 berichten dekt uw POS het standaard integratiebereik. U vindt de details van deze berichten hieronder. We bieden aanvullende functies die ook interessant kunnen zijn om extra waarde of veiligheid te bieden aan uw klanten.

1. Login

Het Login Request is de verplichte eerste stap om communicatie met de betaalterminal (POI) te initiëren en een operationele sessie op te zetten.

Deze handeling moet worden geactiveerd bij het opstarten van de applicatie of telkens wanneer de kassier zich aanmeldt op het Point of Sale (POS) systeem. Het primaire doel is het overbrengen van systeemidentiteit (POS software details) en operationele context (Operator ID, Datum/Tijd) naar de POI, zodat alle volgende transacties correct worden gelogd en geautoriseerd.

Klik om te bekijken: Login Request/Response Sequence Diagram

Dit diagram toont de verplichte synchrone uitwisseling die wordt gebruikt om de sessie op te zetten:

Login Flow (login) - Synchronous.png

A. Login Request

Header

Het standaard SaleToPOIRequest.MessageHeader object, met MessageClass op Service en MessageCategory op Login.

Body

Deze tabel geeft de velden weer die vereist zijn binnen het LoginRequest object, waarmee de POS software en de operator voor de nieuwe sessie worden geïdentificeerd.

Veldnaam Type Verplicht Beschrijving
DateTime String Ja De huidige datum en tijd van het POS-systeem op het moment dat de sessie wordt geopend, in UTC volgens ISO 8601.
OperatorID String Nee Identificatie van de specifieke kassier of operator (bv. "Cashier001").
OperatorLanguage String Ja Definieert de taalvoorkeur van de kassier/operator (bv. EN, PL), in ISO 639-1 codes, met twee alfakarakters.
SaleSoftware.ApplicationName String Ja De naam van de POS-applicatie die het verzoek verstuurt (bv. "POS Simulator").
SaleSoftware.ProviderIdentification String Ja Identificatie van de softwareleverancier (bv. "POS Provider ID").
SaleSoftware.SoftwareVersion String Ja Het versienummer van de POS-applicatie (bv. "22.1.1.0").