{"title":"Exibir uma imagem no terminal","category":"default","creationDate":1776961627,"content":"<p>Voc\u00ea pode mostrar uma imagem no visor do seu terminal, por exemplo, um an\u00fancio, ou uma oferta especial gerada pela caixa registradora. Ao mostrar uma imagem, voc\u00ea pode usar seu terminal para aumentar a fidelidade dos clientes ou para fins de marketing.<\/p>\n<p>A imagem pode ser um arquivo PNG, JPEG, GIF ou BMP que voc\u00ea converte para Base64.<\/p>\n<p>Uma solicita\u00e7\u00e3o para mostrar uma imagem n\u00e3o atinge o tempo limite. Depois de enviar a solicita\u00e7\u00e3o, a imagem permanecer\u00e1 vis\u00edvel na tela at\u00e9 que voc\u00ea envie outra solicita\u00e7\u00e3o. Por exemplo, para parar de mostrar a imagem, voc\u00ea pode enviar uma solicita\u00e7\u00e3o para deixar o <a href=\"\/pt\/point-of-sale\/shopper-engagement\/display-data\/idle-display\">monitor inativo<\/a>.<\/p>\n<div class=\"sc-columns\" style=\"columns:2 auto;-moz-columns:2 auto;column-gap:normal;-moz-column-gap:normal;\">\n<div style=\"text-align: center;\">\n<p><img alt=\"\" src=\"\/images\/b\/0\/d\/a\/9\/b0da9eaf2fb5910a46daa833fe47455ffa1042f5-screen-enshowimageportrait.png\" \/><\/p>\n<\/div>\n<div style=\"text-align: center;\">\n<p><img alt=\"\" src=\"\/images\/b\/c\/3\/2\/3\/bc323138d5693219c648a7f3124310d148d02824-screen-enshowimageportrait-small.png\" \/><\/p>\n<\/div>\n<\/div>\n<p><br><\/p>\n<div style=\"text-align: center;\">\n<p><img alt=\"\" src=\"\/images\/1\/0\/b\/3\/3\/10b3302bfc76e2fad00b702f0bdc946d4a916615-screen-enshowimagelandscape.png\" \/><\/p>\n<\/div>\n<h3>Seguran\u00e7a<\/h3>\n<p>O terminal nunca executa ou armazena uma imagem que recebe. O terminal apenas decodifica a imagem, para poder mostr\u00e1-la no display.<\/p>\n<h2 id=\"display-image\">Fa\u00e7a uma solicita\u00e7\u00e3o de exibi\u00e7\u00e3o de uma imagem<\/h2>\n<ol>\n<li>\n<p>Converta um arquivo de imagem PNG, JPEG, GIF ou BMP para Base64.<\/p>\n<\/li>\n<li>\n<p>Fa\u00e7a uma solicita\u00e7\u00e3o POST para um <a href=\"\/pt\/point-of-sale\/design-your-integration\/terminal-api#endpoints\">endpoint da API de Terminais<\/a>, especificando:<\/p>\n<ul>\n<li>\n<p>The standard <a href=\"\/pt\/point-of-sale\/design-your-integration\/terminal-api#request-message-header\">\n  <code>SaleToPOIRequest.MessageHeader<\/code>\n<\/a> object, with <code>MessageClass<\/code> set to <strong>Device<\/strong> and <code>MessageCategory<\/code> set to <span translate=\"no\"><strong>Display<\/strong><\/span>.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: center;\">Required<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><code>ProtocolVersion<\/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;\"><strong>3.0<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>MessageClass<\/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;\"><span translate=\"no\"><strong>Device<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>MessageCategory<\/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;\"><span translate=\"no\"><strong>Display<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>MessageType<\/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;\"><span translate=\"no\"><strong>Request<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>ServiceID<\/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;\">Your unique ID for this request, consisting of 1-10 alphanumeric characters. Must be unique within the last 48 hours for the terminal (<code>POIID<\/code>) being used.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>SaleID<\/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;\">Your unique ID for the POS system component to send this request from.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>POIID<\/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;\">The unique ID of the terminal to send this request to. Format: <em>[device model]-[serial number]<\/em>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<\/ul>\n<ul>\n<li>\n<p> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/terminal-api\/latest\/post\/display#request-DisplayOutput\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">DisplayRequest.DisplayOutput<\/a>:  Uma matriz com um item contendo:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><code>Device<\/code><\/td>\n<td style=\"text-align: left;\"><strong>CustomerDisplay<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>InfoQualify<\/code><\/td>\n<td style=\"text-align: left;\"><strong>Display<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>OutputContent.OutputFormat<\/code><\/td>\n<td style=\"text-align: left;\"><strong>MessageRef<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>OutputContent.PredefinedContent.ReferenceID<\/code><\/td>\n<td style=\"text-align: left;\"><strong>Image<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>OutputContent.OutputText<\/code><\/td>\n<td style=\"text-align: left;\">Uma matriz com um <code>Text<\/code> par\u00e2metro que cont\u00e9m a imagem como uma string codificada em Base64.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<\/ul>\n<pre><code class=\"language-json\">{\n   \"SaleToPOIRequest\":{\n      \"MessageHeader\":{\n         \"ProtocolVersion\":\"3.0\",\n         \"MessageClass\":\"Device\",\n         \"MessageCategory\":\"Display\",\n         \"MessageType\":\"Request\",\n         \"ServiceID\":\"043001\",\n         \"SaleID\":\"POSSystemID12345\",\n         \"POIID\":\"V400m-346403161\"\n      },\n      \"DisplayRequest\":{\n         \"DisplayOutput\":[\n            {\n               \"Device\":\"CustomerDisplay\",\n               \"InfoQualify\":\"Display\",\n               \"OutputContent\":{\n                  \"OutputFormat\":\"MessageRef\",\n                  \"PredefinedContent\":{\n                     \"ReferenceID\":\"Image\"\n                  },\n                  \"OutputText\":[\n                     {\n                        \"Text\":\"iVBORw0KGgoAAAAN...AAASUVORK5CYII=\"\n                     }\n                  ]\n               }\n            }\n         ]\n      }\n   }\n}<\/code><\/pre>\n<p>Se ocorrer um erro ao decodificar a imagem, a imagem n\u00e3o ser\u00e1 exibida.<br \/>\nSe a solicita\u00e7\u00e3o for bem-sucedida, voc\u00ea receber\u00e1 uma resposta de exibi\u00e7\u00e3o com:<\/p>\n<ul>\n<li><code>OutputResult.Response.Result<\/code>: <strong>Success<\/strong><\/li>\n<\/ul>\n<pre><code class=\"language-json\">{\n    \"SaleToPOIResponse\": {\n        \"DisplayResponse\": {\n            \"OutputResult\": [\n                {\n                    \"Device\": \"CustomerDisplay\",\n                    \"InfoQualify\": \"Display\",\n                    \"Response\": {\n                        \"Result\": \"Success\"\n                    }\n                }\n            ]\n        },\n        \"MessageHeader\": {...}\n    }\n}<\/code><\/pre>\n<p>A imagem continua a ser exibida no visor at\u00e9 que voc\u00ea envie outra solicita\u00e7\u00e3o.<\/p>\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\/shopper-engagement\/display-data\/display-receipt\"\n                        target=\"_self\"\n                        >\n                    Mostrar um recibo virtual no display\n                <\/a><\/li><li><a href=\"\/point-of-sale\/shopper-engagement\/display-data\/idle-display\"\n                        target=\"_self\"\n                        >\n                    Coloque a tela em espera\n                <\/a><\/li><li><a href=\"\/point-of-sale\/shopper-engagement\/display-data\/display-qr-code\"\n                        target=\"_self\"\n                        >\n                    Deixe seu cliente ler um c\u00f3digo QR no visor do terminal.\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/shopper-engagement\/display-data\/display-image","articleFields":{"description":"Engage seus clientes exibindo um an\u00fancio ou outra imagem na tela do terminal de pagamento.","last_edit_on":"28-12-2020 14:52"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/shopper-engagement\/display-data\/display-image","title":"Exibir uma imagem no terminal","content":"Voc\u00ea pode mostrar uma imagem no visor do seu terminal, por exemplo, um an\u00fancio, ou uma oferta especial gerada pela caixa registradora. Ao mostrar uma imagem, voc\u00ea pode usar seu terminal para aumentar a fidelidade dos clientes ou para fins de marketing.\nA imagem pode ser um arquivo PNG, JPEG, GIF ou BMP que voc\u00ea converte para Base64.\nUma solicita\u00e7\u00e3o para mostrar uma imagem n\u00e3o atinge o tempo limite. Depois de enviar a solicita\u00e7\u00e3o, a imagem permanecer\u00e1 vis\u00edvel na tela at\u00e9 que voc\u00ea envie outra solicita\u00e7\u00e3o. Por exemplo, para parar de mostrar a imagem, voc\u00ea pode enviar uma solicita\u00e7\u00e3o para deixar o monitor inativo.\n\n\n\n\n\n\n\n\n\n\n\n\nSeguran\u00e7a\nO terminal nunca executa ou armazena uma imagem que recebe. O terminal apenas decodifica a imagem, para poder mostr\u00e1-la no display.\nFa\u00e7a uma solicita\u00e7\u00e3o de exibi\u00e7\u00e3o de uma imagem\n\n\nConverta um arquivo de imagem PNG, JPEG, GIF ou BMP para Base64.\n\n\nFa\u00e7a uma solicita\u00e7\u00e3o POST para um endpoint da API de Terminais, especificando:\n\n\nThe standard \n  SaleToPOIRequest.MessageHeader\n object, with MessageClass set to Device and MessageCategory set to Display.\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nProtocolVersion\n\n3.0\n\n\nMessageClass\n\nDevice\n\n\nMessageCategory\n\nDisplay\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\n\n\n DisplayRequest.DisplayOutput:  Uma matriz com um item contendo:\n\n\n\nParameter\nDescription\n\n\n\n\nDevice\nCustomerDisplay\n\n\nInfoQualify\nDisplay\n\n\nOutputContent.OutputFormat\nMessageRef\n\n\nOutputContent.PredefinedContent.ReferenceID\nImage\n\n\nOutputContent.OutputText\nUma matriz com um Text par\u00e2metro que cont\u00e9m a imagem como uma string codificada em Base64.\n\n\n\n\n\n{\n   \"SaleToPOIRequest\":{\n      \"MessageHeader\":{\n         \"ProtocolVersion\":\"3.0\",\n         \"MessageClass\":\"Device\",\n         \"MessageCategory\":\"Display\",\n         \"MessageType\":\"Request\",\n         \"ServiceID\":\"043001\",\n         \"SaleID\":\"POSSystemID12345\",\n         \"POIID\":\"V400m-346403161\"\n      },\n      \"DisplayRequest\":{\n         \"DisplayOutput\":[\n            {\n               \"Device\":\"CustomerDisplay\",\n               \"InfoQualify\":\"Display\",\n               \"OutputContent\":{\n                  \"OutputFormat\":\"MessageRef\",\n                  \"PredefinedContent\":{\n                     \"ReferenceID\":\"Image\"\n                  },\n                  \"OutputText\":[\n                     {\n                        \"Text\":\"iVBORw0KGgoAAAAN...AAASUVORK5CYII=\"\n                     }\n                  ]\n               }\n            }\n         ]\n      }\n   }\n}\nSe ocorrer um erro ao decodificar a imagem, a imagem n\u00e3o ser\u00e1 exibida.\nSe a solicita\u00e7\u00e3o for bem-sucedida, voc\u00ea receber\u00e1 uma resposta de exibi\u00e7\u00e3o com:\n\nOutputResult.Response.Result: Success\n\n{\n    \"SaleToPOIResponse\": {\n        \"DisplayResponse\": {\n            \"OutputResult\": [\n                {\n                    \"Device\": \"CustomerDisplay\",\n                    \"InfoQualify\": \"Display\",\n                    \"Response\": {\n                        \"Result\": \"Success\"\n                    }\n                }\n            ]\n        },\n        \"MessageHeader\": {...}\n    }\n}\nA imagem continua a ser exibida no visor at\u00e9 que voc\u00ea envie outra solicita\u00e7\u00e3o.\n\n\nVeja tamb\u00e9m\n\n\n                    Mostrar um recibo virtual no display\n                \n                    Coloque a tela em espera\n                \n                    Deixe seu cliente ler um c\u00f3digo QR no visor do terminal.\n                \n","type":"page","locale":"pt","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Shopper engagement","lvl3":"Exibir dados no terminal","lvl4":"Exibir uma imagem no terminal"},"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\/shopper-engagement","lvl3":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/shopper-engagement\/display-data","lvl4":"\/pt\/point-of-sale\/shopper-engagement\/display-data\/display-image"},"levels":5,"category":"In-person payments","category_color":"green","tags":["Exibir","imagem","terminal"]},"articleFiles":{"screen-EN_ShowImage_landscape.png":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/images\/4\/f\/f\/5\/7\/4ff57cad4d01941b92f1ee6e368a32a03070750a-screen-enshowimagelandscape.png\" \/>","screen-EN_ShowImage_portrait-small.png":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/images\/d\/c\/a\/c\/e\/dcacec3de7454a876dbfafee83e44cdcddddc728-screen-enshowimageportrait-small.png\" \/>","screen-EN_ShowImage_portrait.png":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/images\/7\/4\/5\/3\/b\/7453b26976fd8098c32c421bae7c1c9ef4effc8e-screen-enshowimageportrait.png\" \/>"}}