Integrazione POS standard

Il flusso di pagamento di base descrive i messaggi necessari che il tuo POS dovrebbe gestire per operare in modo efficiente:

  1. Login: avvia una sessione operativa con il terminale, consentendo di elaborare transazioni dal POS.

  2. Pagamento: transazione di vendita, utilizzando una carta o altro strumento per completare un acquisto presso il Punto Vendita.

  3. Annulla: interrompe e cancella immediatamente una transazione in corso prima che sia iniziata l'autorizzazione.

  4. TransactionStatus: controlla l'esito finale o lo stato di elaborazione più recente di una transazione precedente, tipicamente attivato dopo una perdita di comunicazione tra POS e POI.

  5. Storno: annulla una transazione recentemente approvata accreditando i fondi sul conto o sulla carta del cliente prima che la transazione sia stata regolata finanziariamente.

  6. Rimborso: restituisce fondi a un cliente a seguito di una vendita già regolata, tipicamente per un reso di prodotto.

  7. Logout: Questa richiesta chiude la sessione operativa attiva sul terminale, concludendo il turno del cassiere o il periodo di utilizzo.

Con questi 7 messaggi, il tuo POS coprirà l'ambito di integrazione standard. Troverai i dettagli di questi messaggi di seguito. Offriamo funzionalità aggiuntive che potrebbero interessarti per offrire ulteriore valore o sicurezza ai tuoi clienti.

1. Login

La Login Request è il primo passo obbligatorio per iniziare la comunicazione con il Terminale di Pagamento (POI) e stabilire una sessione operativa.

Questa operazione deve essere attivata all'avvio dell'applicazione o ogni volta che il cassiere effettua il login nel sistema POS. Il suo scopo principale è trasmettere l'identità del sistema (dettagli del software POS) e il contesto operativo (ID Operatore, Data/Ora) al POI, assicurando che tutte le transazioni successive siano correttamente registrate e autorizzate.

Clicca per vedere: Diagramma di sequenza richiesta/risposta Login

Questo diagramma illustra lo scambio sincrono obbligatorio utilizzato per stabilire la sessione:

Login Flow (login) - Synchronous.png

A. Login Request

Header

L'oggetto standard SaleToPOIRequest.MessageHeader , con MessageClass impostato su Service e MessageCategory impostato su Login.

Body

Questa tabella dettaglia i campi richiesti all'interno dell'oggetto LoginRequest, che identifica il software POS e l'operatore per la nuova sessione.

Nome campo Tipo Obbligatorio Descrizione
DateTime Stringa Sì La data e ora corrente del sistema POS al momento dell'apertura della sessione, in UTC secondo ISO 8601.
OperatorID Stringa No Identificazione del cassiere o operatore specifico (es. "Cashier001").
OperatorLanguage Stringa Sì Definisce la preferenza linguistica del cassiere/operatore (es. EN, PL), in codici ISO 639-1, usando due caratteri alfabetici.
SaleSoftware.ApplicationName Stringa Sì Il nome dell'applicazione POS che invia la richiesta (es. "POS Simulator").
SaleSoftware.ProviderIdentification Stringa Sì Identificazione del fornitore del software (es. "POS Provider ID").
SaleSoftware.SoftwareVersion Stringa Sì Il numero di versione dell'applicazione POS (es. "22.1.1.0").