{"title":"Verifique a conex\u00e3o em nuvem","category":"default","creationDate":1602158340,"content":"<p>Em uma integra\u00e7\u00e3o em nuvem com a API de Terminais, os terminais estabelecem uma conex\u00e3o de WebSockets para acessar a API de Terminais na nuvem. Nossa <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a> precisa habilitar websockets para voc\u00ea. Uma vez que os websockets est\u00e3o habilitados, voc\u00ea pode verificar remotamente e em tempo real se os terminais est\u00e3o ligados e t\u00eam uma conex\u00e3o ao vivo na nuvem.<br \/>\nVoc\u00ea pode verificar isso:<\/p>\n<ul>\n<li><a href=\"#use-the-customer-area\">Usando sua \u00e1rea de cliente<\/a><\/li>\n<li><a href=\"#use-an-api-call\">Usando uma chamada de API<\/a><\/li>\n<\/ul>\n<h2 id=\"use-the-customer-area\">Usando a \u00c1rea do Cliente<\/h2>\n<p>Para verificar a partir de sua \u00e1rea de cliente se um terminal espec\u00edfico tem uma conex\u00e3o de nuvem ao vivo para Terminal API:<\/p>\n<ol>\n<li>\n<p>Na sua <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>, v\u00e1 para <strong>In-person payments<\/strong> &gt; <strong>Terminals<\/strong>.<\/p>\n<\/li>\n<li>\n<p>Selecione o terminal na lista.<br \/>\nA p\u00e1gina <strong>Settings<\/strong> &gt; <strong>About this terminal<\/strong> \u00e9 exibida.<\/p>\n<\/li>\n<li>\n<p>Em <strong>Cloud connection<\/strong>, selecione <strong>Check connection<\/strong>.<br \/>\nUm \u00edcone indica o resultado e uma mensagem \u00e9 exibida:<\/p>\n<ul>\n<li><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/>  Terminal est\u00e1 conectado<\/li>\n<li><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/>  Terminal est\u00e1 desconectado<\/li>\n<\/ul>\n<div class=\"sc-notice info\"><div>\n<ul>\n<li>O \u00edcone de conex\u00e3o n\u00e3o \u00e9 atualizado automaticamente. Voc\u00ea precisa pressionar <strong>Check connection<\/strong> toda vez que quiser saber o estado atual.<\/li>\n<li>Se voc\u00ea n\u00e3o v\u00ea <strong>Cloud connection<\/strong>, os WebSockets n\u00e3o est\u00e3o habilitados para o terminal.\n<\/div><\/div><\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<h2 id=\"use-an-api-call\">Use uma chamada de API<\/h2>\n<p>Usando a API <code>\/connectedTerminals<\/code>, voc\u00ea pode obter uma lista de terminais registrados em uma conta de comerciante ou loja espec\u00edfica que tenham uma conex\u00e3o em nuvem ao vivo. Voc\u00ea tamb\u00e9m pode verificar se um terminal espec\u00edfico tem uma conex\u00e3o ao vivo na nuvem.<\/p>\n<p>O endpoint a ser usado difere para terminais de teste e ativos:<\/p>\n<ul>\n<li>Para terminais de teste: <code>https:\/\/terminal-api-test.adyen.com\/connectedTerminals<\/code><\/li>\n<li>ara terminais ativos: <code>https:\/\/terminal-api-live.adyen.com\/connectedTerminals<\/code><\/li>\n<\/ul>\n<p>Autentique suas solicita\u00e7\u00f5es usando a mesma <a href=\"\/pt\/point-of-sale\/design-your-integration\/terminal-api#api-key\">chave de API que voc\u00ea usa para suas solicita\u00e7\u00f5es de Terminal API<\/a>.<\/p>\n<p>Para verificar se os terminais t\u00eam uma conex\u00e3o ao vivo na nuvem para a API Terminal:<\/p>\n<ol>\n<li>\n<p>Fa\u00e7a uma solicita\u00e7\u00e3o POST test ou live para o endpoint <code>\/connectedTerminals<\/code>, especificando:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Par\u00e2metro<\/th>\n<th style=\"text-align: center;\">Requerimento<\/th>\n<th style=\"text-align: left;\">Descri\u00e7\u00e3o<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><code>merchantAccount<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">A conta do comerciante que voc\u00ea deseja verificar.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>store<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/td>\n<td style=\"text-align: left;\">A loja que voc\u00ea deseja verificar. Deve pertencer ao especificado <code>merchantAccount<\/code>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>uniqueTerminalId<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/td>\n<td style=\"text-align: left;\">O POIID do terminal que voc\u00ea deseja verificar, no formato <em>[modelo do dispositivo]-[n\u00famero de s\u00e9rie]<\/em>. Deve pertencer ao especificado <code>merchantAccount<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Aqui est\u00e3o alguns exemplos de solicita\u00e7\u00f5es:<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Conecte os terminais em uma  merchant account'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"merchantAccount\\\": \\\"ADYEN_MERCHANT_ACCOUNT\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Conecte os terminais em uma store store'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"merchantAccount\\\": \\\"ADYEN_MERCHANT_ACCOUNT\\\",\\n    \\\"store\\\": \\\"YOUR_STORE_ID\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Verifique um terminal espec\u00edfico'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"merchantAccount\\\": \\\"ADYEN_MERCHANT_ACCOUNT\\\",\\n    \\\"uniqueTerminalId\\\": \\\"V400m-324688178\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>Voc\u00ea recebe uma resposta com:<\/p>\n<ul>\n<li><code>uniqueTerminalIds<\/code>: Uma matriz com os POIIDs dos terminais que t\u00eam uma conex\u00e3o ativa na nuvem. Se voc\u00ea verificou um terminal espec\u00edfico, o mesmo <code>uniqueTerminalId<\/code> a solicita\u00e7\u00e3o \u00e9 retornado.<\/li>\n<\/ul>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Resposta de \/connectedTerminals'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n   \\\"uniqueTerminalIds\\\" : [\\n      \\\"MX915-284251016\\\",\\n      \\\"MX925-260390740\\\",\\n      \\\"V400m-324688136\\\",\\n      \\\"V400m-324688178\\\",\\n      \\\"V400m-324688181\\\"\\n   ]\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>Se a <code>uniqueTerminalIds<\/code> matriz da resposta estiver vazia, isso pode indicar:<\/p>\n<ul>\n<li>Nenhum terminal encontrado com uma conex\u00e3o ao vivo na nuvem.<\/li>\n<li>WebSockets n\u00e3o est\u00e3o habilitados.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<h2>Veja tamb\u00e9m<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/point-of-sale\/diagnostics\/request-diagnosis\"\n                        target=\"_self\"\n                        >\n                    Fa\u00e7a uma solicita\u00e7\u00e3o de diagn\u00f3stico\n                <\/a><\/li><li><a href=\"\/point-of-sale\/pos-troubleshooting\/connection-tests\"\n                        target=\"_self\"\n                        >\n                    Execute testes de conex\u00e3o do terminal\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/diagnostics\/check-cloud-connection","articleFields":{"description":"Verifique remotamente a conex\u00e3o live WebSockets dos terminais.","last_edit_on":"27-01-2021 19:37"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/diagnostics\/check-cloud-connection","title":"Verifique a conex\u00e3o em nuvem","content":"Em uma integra\u00e7\u00e3o em nuvem com a API de Terminais, os terminais estabelecem uma conex\u00e3o de WebSockets para acessar a API de Terminais na nuvem. Nossa Support Team precisa habilitar websockets para voc\u00ea. Uma vez que os websockets est\u00e3o habilitados, voc\u00ea pode verificar remotamente e em tempo real se os terminais est\u00e3o ligados e t\u00eam uma conex\u00e3o ao vivo na nuvem.\nVoc\u00ea pode verificar isso:\n\nUsando sua \u00e1rea de cliente\nUsando uma chamada de API\n\nUsando a \u00c1rea do Cliente\nPara verificar a partir de sua \u00e1rea de cliente se um terminal espec\u00edfico tem uma conex\u00e3o de nuvem ao vivo para Terminal API:\n\n\nNa sua Customer Area, v\u00e1 para In-person payments &gt; Terminals.\n\n\nSelecione o terminal na lista.\nA p\u00e1gina Settings &gt; About this terminal \u00e9 exibida.\n\n\nEm Cloud connection, selecione Check connection.\nUm \u00edcone indica o resultado e uma mensagem \u00e9 exibida:\n\n  Terminal est\u00e1 conectado\n  Terminal est\u00e1 desconectado\n\n\n\nO \u00edcone de conex\u00e3o n\u00e3o \u00e9 atualizado automaticamente. Voc\u00ea precisa pressionar Check connection toda vez que quiser saber o estado atual.\nSe voc\u00ea n\u00e3o v\u00ea Cloud connection, os WebSockets n\u00e3o est\u00e3o habilitados para o terminal.\n\n\n\n\nUse uma chamada de API\nUsando a API \/connectedTerminals, voc\u00ea pode obter uma lista de terminais registrados em uma conta de comerciante ou loja espec\u00edfica que tenham uma conex\u00e3o em nuvem ao vivo. Voc\u00ea tamb\u00e9m pode verificar se um terminal espec\u00edfico tem uma conex\u00e3o ao vivo na nuvem.\nO endpoint a ser usado difere para terminais de teste e ativos:\n\nPara terminais de teste: https:\/\/terminal-api-test.adyen.com\/connectedTerminals\nara terminais ativos: https:\/\/terminal-api-live.adyen.com\/connectedTerminals\n\nAutentique suas solicita\u00e7\u00f5es usando a mesma chave de API que voc\u00ea usa para suas solicita\u00e7\u00f5es de Terminal API.\nPara verificar se os terminais t\u00eam uma conex\u00e3o ao vivo na nuvem para a API Terminal:\n\n\nFa\u00e7a uma solicita\u00e7\u00e3o POST test ou live para o endpoint \/connectedTerminals, especificando:\n\n\n\nPar\u00e2metro\nRequerimento\nDescri\u00e7\u00e3o\n\n\n\n\nmerchantAccount\n\nA conta do comerciante que voc\u00ea deseja verificar.\n\n\nstore\n\nA loja que voc\u00ea deseja verificar. Deve pertencer ao especificado merchantAccount.\n\n\nuniqueTerminalId\n\nO POIID do terminal que voc\u00ea deseja verificar, no formato [modelo do dispositivo]-[n\u00famero de s\u00e9rie]. Deve pertencer ao especificado merchantAccount\n\n\n\nAqui est\u00e3o alguns exemplos de solicita\u00e7\u00f5es:\n\n\n\n\n\n\n\n\n\n\n\nVoc\u00ea recebe uma resposta com:\n\nuniqueTerminalIds: Uma matriz com os POIIDs dos terminais que t\u00eam uma conex\u00e3o ativa na nuvem. Se voc\u00ea verificou um terminal espec\u00edfico, o mesmo uniqueTerminalId a solicita\u00e7\u00e3o \u00e9 retornado.\n\n\n\n\nSe a uniqueTerminalIds matriz da resposta estiver vazia, isso pode indicar:\n\nNenhum terminal encontrado com uma conex\u00e3o ao vivo na nuvem.\nWebSockets n\u00e3o est\u00e3o habilitados.\n\n\n\nVeja tamb\u00e9m\n\n\n                    Fa\u00e7a uma solicita\u00e7\u00e3o de diagn\u00f3stico\n                \n                    Execute testes de conex\u00e3o do terminal\n                \n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Executar diagn\u00f3sticos","lvl3":"Verifique a conex\u00e3o em nuvem"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/point-of-sale","lvl2":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/diagnostics","lvl3":"\/pt\/point-of-sale\/diagnostics\/check-cloud-connection"},"levels":4,"category":"In-person payments","category_color":"green","tags":["Verifique","conex\u00e3o","nuvem"]}}