\n Reconcile a balance mismatch\n <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/point-of-sale\/reconciling-totals\/retrieve-totals-from-the-terminal","articleFields":{"description":"Return payment totals from a terminal and filter for totals by group or operator.","id":"42829675","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"20-08-2019 11:48"},"algolia":{"url":"https:\/\/docs.adyen.com\/point-of-sale\/reconciling-totals\/retrieve-totals-from-the-terminal","title":"Retrieve totals from the terminal","content":"Using a Terminal API request, your POS app can retrieve totals from a payment terminal without starting a new reconciliation period. The result includes the total value and number of transactions by payment instrument type (such as card) and transaction type (such as credit or debit). You can filter and group the results on aspects like operator or shift number.\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\nGet the totals of a terminal\n\n\nLog in to the terminal.\n\n\nMake a Terminal API get totals request, specifying:\n\n\nThe standard \n SaleToPOIRequest.MessageHeader\n object, with MessageClass set to Service and MessageCategory set to GetTotals.\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nProtocolVersion\n\n3.0\n\n\nMessageClass\n\nService\n\n\nMessageCategory\n\nGetTotals\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 GetTotalsRequest object with:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nTotalDetails\n\nGroup the results by terminal (POIID), sale system, operator, shift number, or totals group.\n\n\nTotalFilter\n\nLimit the results to the specified terminal (POIID), sale system, operator, shift number, or totals group.\n\n\n\n\n\nSelect the tabs to see some example requests.\n\n\n \n \n \n \n\n\n\n\nIn the GetTotalsResponse, check the TransactionTotals object.\nThe following example is the response for a request that asked for the totals of a terminal and group of totals.\n{\n \"SaleToPOIResponse\":{\n \"MessageHeader\":{\n \"ProtocolVersion\":\"3.0\",\n \"SaleID\":\"CashRegB3\",\n \"MessageClass\":\"Service\",\n \"MessageCategory\":\"GetTotals\",\n \"ServiceID\":\"0518144235\",\n \"POIID\":\"P400Plus-275008565\",\n \"MessageType\":\"Response\"\n },\n \"GetTotalsResponse\":{\n \"POIReconciliationID\":\"1000\",\n \"Response\":{\n \"Result\":\"Success\"\n },\n \"TransactionTotals\":[\n {\n \"SaleID\":\"CashRegB3\",\n \"PaymentInstrumentType\":\"StoredValue\",\n \"PaymentCurrency\":\"EUR\",\n \"PaymentTotals\":[\n {\n \"TransactionType\":\"Debit\",\n \"TransactionCount\":1,\n \"TransactionAmount\":100.99\n }\n ],\n \"OperatorID\":\"\",\n \"CardBrand\":\"SVS\",\n \"TotalsGroupID\":\"GroupA\",\n \"ShiftNumber\":\"\"\n },\n {\n \"SaleID\":\"CashRegB3\",\n \"PaymentInstrumentType\":\"Card\",\n \"PaymentCurrency\":\"EUR\",\n \"PaymentTotals\":[\n {\n \"TransactionType\":\"Debit\",\n \"TransactionCount\":51,\n \"TransactionAmount\":1841.52\n }\n ],\n \"OperatorID\":\"\",\n \"CardBrand\":\"mc\",\n \"TotalsGroupID\":\"GroupA\",\n \"ShiftNumber\":\"\"\n }\n ]\n }\n }\n\n\nSee also\n\n\n Log in and log out on 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":"Retrieve totals from the terminal"},"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\/retrieve-totals-from-the-terminal"},"levels":4,"category":"In-person payments","category_color":"green","tags":["Retrieve","totals","terminal"]},"articleFiles":{"retrieve-totals-from-the-terminal_0.json":"retrieve-totals-from-the-terminal_0.json<\/p>","retrieve-totals-from-the-terminal_1.json":"
retrieve-totals-from-the-terminal_1.json<\/p>","retrieve-totals-from-the-terminal_2.json":"
retrieve-totals-from-the-terminal_2.json<\/p>"}}
![\"-white_check_mark-\"](\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" "\\"-white_check_mark-\\"")
<\/td>\n