\n Reconcile a balance mismatch\n <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/point-of-sale\/reconciling-totals\/log-in-and-log-out","articleFields":{"description":"Log in your terminal and begin processing payments. Log out of your terminal\u00a0when changing operator, or at the end of a shift.","id":"36196842","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"20-08-2019 11:45"},"algolia":{"url":"https:\/\/docs.adyen.com\/point-of-sale\/reconciling-totals\/log-in-and-log-out","title":"Log in and log out","content":"If you want to use Terminal API requests to retrieve transaction totals of a terminal or reconcile balance mismatches, you must first make a Terminal API request to log in to the terminal.\nThis login request can additionally mark events like a change of operator or the start of a new shift, so that you can get the totals by operator or shift.\nThe login request does not authenticate the operator.\nRequirements\nBefore you begin, take into account the following requirements.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nA Terminal API integration with payment terminals.\n\n\n\nLog in to the terminal\n\n\nMake a Terminal API login request, specifying:\n\n\nThe standard \n SaleToPOIRequest.MessageHeader\n object, with MessageClass set to Service and MessageCategory set to Login.\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nProtocolVersion\n\n3.0\n\n\nMessageClass\n\nService\n\n\nMessageCategory\n\nLogin\n\n\nMessageType\n\nRequest\n\n\nServiceID\n\nYour unique ID for this request, consisting of 1-10 alphanumeric characters. Must be unique within the last 48 hours for the terminal (POIID) being used.\n\n\nSaleID\n\nYour unique ID for the POS system component to send this request from.\n\n\nPOIID\n\nThe unique ID of the terminal to send this request to. Format: [device model]-[serial number].\n\n\n\n\n\nThe LoginRequest object, with:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nDateTime\n\nThe date and time in UTC format.\n\n\nSaleSoftware\n\nAn object with the manufacturer, application name, software version, and certification code of the sale system.\n\n\nOperatorLanguage\n\nThe language of the operator in two-character ISO 639-1 format. For example, en for English.\n\n\nOperatorID\n\nYour identification of the operator.\n\n\nSaleTerminalData.TotalsGroupID\n\nYour identification of a group of transactions, for reconciliation purposes.\n\n\nShiftNumber\n\nYour identification of the shift.\n\n\n\n\n\n\n\n\n\n\nIn the LoginResponse, check the following:\n\nResponse.Result: Success indicates that you logged in to the terminal.\nPOIStatus: Indicates if the terminal is ready for use.\n\n{\n \"SaleToPOIResponse\":{\n \"LoginResponse\":{\n \"POISystemData\":{\n \"POISoftware\":{\n \"CertificationCode\":\"\",\n \"SoftwareVersion\":\"adyen_423314\",\n \"ManufacturerID\":\"Adyen\",\n \"ApplicationName\":\"Nexo\"\n },\n \"DateTime\":\"2018-04-03T08:50:23.000Z\",\n \"POIStatus\":{\n \"CommunicationOKFlag\":true,\n \"GlobalStatus\":\"OK\"\n }\n },\n \"Response\":{\n \"Result\":\"Success\"\n }\n },\n \"MessageHeader\":{\n \"ProtocolVersion\":\"3.0\",\n \"SaleID\":\"POSSystemID12345\",\n \"MessageClass\":\"Service\",\n \"MessageCategory\":\"Login\",\n \"ServiceID\":\"0403105031\",\n \"POIID\":\"P400Plus-275008565\",\n \"MessageType\":\"Response\"\n }\n }\n}\n\n\nAfter logging in, the terminal saves the provided values. The values remain in effect until a new login request is processed for the same terminal, or until you log out from this terminal.\nLog out from the terminal\n\n\nMake a Terminal API logout request, specifying:\n\n\nThe standard \n SaleToPOIRequest.MessageHeader\n object, with MessageClass set to Service and MessageCategory set to Logout.\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nProtocolVersion\n\n3.0\n\n\nMessageClass\n\nService\n\n\nMessageCategory\n\nLogout\n\n\nMessageType\n\nRequest\n\n\nServiceID\n\nYour unique ID for this request, consisting of 1-10 alphanumeric characters. Must be unique within the last 48 hours for the terminal (POIID) being used.\n\n\nSaleID\n\nYour unique ID for the POS system component to send this request from.\n\n\nPOIID\n\nThe unique ID of the terminal to send this request to. Format: [device model]-[serial number].\n\n\n\n\n\nAn empty LogoutRequest object.\n\n\n\n\n\n\n\nIn the LogoutResponse, check the following:\n\nResponse.Result: Success indicates that you logged out from the terminal.\n\n{\n \"SaleToPOIResponse\":{\n \"LogoutResponse\":{\n \"Response\":{\n \"Result\":\"Success\"\n }\n },\n \"MessageHeader\":{\n \"ProtocolVersion\":\"3.0\",\n \"SaleID\":\"POSSystemID12345\",\n \"MessageClass\":\"Service\",\n \"MessageCategory\":\"Logout\",\n \"ServiceID\":\"0403105613\",\n \"POIID\":\"P400Plus-275008565\",\n \"MessageType\":\"Response\"\n }\n }\n}\n\n\nSee also\n\n\n Retrieve totals from a terminal\n \n Reconcile a balance mismatch\n \n","type":"page","locale":"en","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"In-person payments","lvl2":"Reconciling totals","lvl3":"Log in and log out"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/point-of-sale","lvl2":"https:\/\/docs.adyen.com\/point-of-sale\/reconciling-totals","lvl3":"\/point-of-sale\/reconciling-totals\/log-in-and-log-out"},"levels":4,"category":"In-person payments","category_color":"green","tags":[]},"articleFiles":{"log-in-and-log-out_0.json":"log-in-and-log-out_0.json<\/p>","log-in-and-log-out_1.json":"
log-in-and-log-out_1.json<\/p>"}}
![\"-white_check_mark-\"](\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" "\\"-white_check_mark-\\"")
<\/td>\n