Terminal-2 icon

Log in and log out

Log in your terminal and begin processing payments. Log out of your terminal when changing operator, or at the end of a shift.

Endpoint

Where and how to send Terminal API messages depends on your type of implementation. See Use the correct endpoint.

Login Request

For a list of request fields, see LoginRequest.

The SaleID and ServiceID in the MessageHeader should be unique. SaleID and ServiceID combinations are rejected if used recently, within 48 hours.

The fields described below are the fields you specify when making a LoginRequest call to the Terminal API.

Login Response

For a list of response fields, see LoginResponse.

The login response contains information about the status of the terminal in the following fields:

{
   "SaleToPOIResponse":{
      "LoginResponse":{
         "POISystemData":{
            "POISoftware":{
               "CertificationCode":"",
               "SoftwareVersion":"adyen_423314",
               "ManufacturerID":"Adyen",
               "ApplicationName":"Nexo"
            },
            "DateTime":"2018-04-03T08:50:23.000Z",
            "POIStatus":{
               "CommunicationOKFlag":true,
               "GlobalStatus":"OK"
            }
         },
         "Response":{
            "Result":"Success"
         }
      },
      "MessageHeader":{
         "ProtocolVersion":"3.0",
         "SaleID":"POSSystemID12345",
         "MessageClass":"Service",
         "MessageCategory":"Login",
         "ServiceID":"0403105031",
         "POIID":"P400Plus-275008565",
         "MessageType":"Response"
      }
   }
}

After a successful Login Request, the terminal will save the supplied values in persistent storage. The values will remain in effect until a new login request is processed or until a logout request is done.

Logout Request

For a list of request fields, see LogoutRequest.

The LogoutRequest will erase the persistent data stored by the LoginRequest.

The fields described below are the basic payment fields you specify when making a LogoutRequest call to the Terminal API.

For a list of response fields, see LogoutRequest. You receive a response with the following fields:

{
   "SaleToPOIResponse":{
      "LogoutResponse":{
         "Response":{
            "Result":"Success"
         }
      },
      "MessageHeader":{
         "ProtocolVersion":"3.0",
         "SaleID":"POSSystemID12345",
         "MessageClass":"Service",
         "MessageCategory":"Logout",
         "ServiceID":"0403105613",
         "POIID":"P400Plus-275008565",
         "MessageType":"Response"
      }
   }
}