De tempos em tempos, um dos terminais da Adyen encontram um problema ou precisam realizar manuten\u00e7\u00e3o. Quando isso acontece, o terminal gera uma notifica\u00e7\u00e3o de evento. Voc\u00ea pode opcionalmente apresentar esta notifica\u00e7\u00e3o em sua caixa registradora para informar a equipe da loja sobre a disponibilidade e o estado do terminal.<\/p>\n
Aqui descrevemos como voc\u00ea exp\u00f5e um endpoint<\/a> no servidor e configura notifica\u00e7\u00f5es de eventos<\/a>. Seu servidor receber\u00e1 webhooks que incluem um Tamb\u00e9m fornecemos uma lista de tipos de As notifica\u00e7\u00f5es de eventos s\u00e3o enviadas como HTTP callbacks (webhooks) para um endpoint no seu servidor. Para receber notifica\u00e7\u00f5es, verifique se voc\u00ea possui um servidor com:<\/p>\n Para teste, voc\u00ea tamb\u00e9m pode usar uma porta HTTP (80, 8080 ou 8888).<\/p>\n<\/div><\/li>\n O pr\u00f3ximo passo \u00e9 inserir os detalhes do seu servidor na sua \u00c1rea do Cliente e selecionar informa\u00e7\u00f5es adicionais que voc\u00ea deseja receber nas notifica\u00e7\u00f5es. Voc\u00ea pode configurar as notifica\u00e7\u00f5es no n\u00edvel de company account ou merchant account.<\/p>\n Agora, as notifica\u00e7\u00f5es de eventos ser\u00e3o enviadas para o terminal especificado.<\/p>\n Cada notifica\u00e7\u00e3o cont\u00e9m um Exemplos de notifica\u00e7\u00f5es de eventos s\u00e3o fornecidos abaixo.<\/p>\nEventToNotify<\/code>. Isso indica o estado do terminal e pode ser usado para apresentar uma mensagem na sua caixa registradora.<\/p>\nEventToNotify<\/code><\/a> poss\u00edveis e exemplos<\/a> de cada um.<\/p>\nConfigurar notifica\u00e7\u00f5es de eventos<\/h2>\n
Etapa 1: Expor um endpoint em seu servidor<\/h3>\n
\n
Etapa 2: Configurar notifica\u00e7\u00f5es na sua \u00e1rea de cliente<\/h3>\n
\n
\n
\nInclu\u00edmos esses detalhes no cabe\u00e7alho da solicita\u00e7\u00e3o de notifica\u00e7\u00e3o para autentica\u00e7\u00e3o no seu servidor.<\/li>\nTipos de notifica\u00e7\u00e3o de eventos<\/h2>\n
EventToNotify<\/code>. Voc\u00ea pode usar isso para apresentar uma mensagem na sua caixa registradora informando a equipe da loja sobre o estado do terminal.<\/p>\n\n\n
\n \nEvento<\/th>\n Descri\u00e7\u00e3o<\/th>\n<\/tr>\n<\/thead>\n \n Shutdown<\/a><\/code><\/td>\nO terminal est\u00e1 desligando.<\/td>\n<\/tr>\n \n BeginMaintenance<\/a><\/code><\/td>\nO terminal est\u00e1 desligando.<\/td>\n<\/tr>\n \n EndMaintenance<\/a><\/code><\/td>\nA manuten\u00e7\u00e3o do terminal est\u00e1 terminanda.<\/td>\n<\/tr>\n \n OutOfOrder<\/a><\/code><\/td>\nO terminal est\u00e1 inacess\u00edvel.<\/td>\n<\/tr>\n \n Initialised<\/a><\/code><\/td>\nO terminal foi inicializado e est\u00e1 pronto para as transa\u00e7\u00f5es.<\/td>\n<\/tr>\n \n Reject<\/a><\/code><\/td>\nUma solicita\u00e7\u00e3o foi rejeitada. Uma explica\u00e7\u00e3o do erro deve ser fornecida no elemento EventDetails<\/code>.<\/td>\n<\/tr>\n\n SaleWakeUp<\/a><\/code><\/td>\nO terminal est\u00e1 iniciando uma solicita\u00e7\u00e3o de pagamento. O elemento EventDetails<\/code> cont\u00e9m o n\u00famero de refer\u00eancia que foi inserido no terminal.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nExemplos<\/h2>\n
Shutdown<\/h3>\n
{\n \"SaleToPOIRequest\":{\n \"EventNotification\":{\n \"EventDetails\":\"newstate=IDLE&oldstate=START\",\n \"EventToNotify\":\"Shutdown\",\n \"TimeStamp\":\"2019-08-07T10:16:10.000Z\"\n },\n \"MessageHeader\":{\n \"SaleID\":\"POSSystemID12345\",\n \"ProtocolVersion\":\"3.0\",\n \"MessageType\":\"Notification\",\n \"POIID\":\"V400m-324688179\",\n \"MessageClass\":\"Event\",\n \"MessageCategory\":\"Event\",\n \"DeviceID\":\"1517998561\"\n }\n }\n}<\/code><\/pre>\nBeginMaintenance<\/h3>\n
{\n \"SaleToPOIRequest\":{\n \"EventNotification\":{\n \"EventDetails\":\"newstate=IDLE&oldstate=START\",\n \"EventToNotify\":\"BeginMaintenance\",\n \"TimeStamp\":\"2019-08-07T10:16:10.000Z\"\n },\n \"MessageHeader\":{\n \"SaleID\":\"POSSystemID12345\",\n \"ProtocolVersion\":\"3.0\",\n \"MessageType\":\"Notification\",\n \"POIID\":\"V400m-324688179\",\n \"MessageClass\":\"Event\",\n \"MessageCategory\":\"Event\",\n \"DeviceID\":\"1517998562\"\n }\n }\n}<\/code><\/pre>\nEndMaintenance<\/h3>\n
{\n \"SaleToPOIRequest\":{\n \"EventNotification\":{\n \"EventDetails\":\"newstate=IDLE&oldstate=START\",\n \"EventToNotify\":\"EndMaintenance\",\n \"TimeStamp\":\"2019-08-07T10:16:10.000Z\"\n },\n \"MessageHeader\":{\n \"SaleID\":\"POSSystemID12345\",\n \"ProtocolVersion\":\"3.0\",\n \"MessageType\":\"Notification\",\n \"POIID\":\"V400m-324688179\",\n \"MessageClass\":\"Event\",\n \"MessageCategory\":\"Event\",\n \"DeviceID\":\"1517998561\"\n }\n }\n}<\/code><\/pre>\nOutOfOrder<\/h3>\n
{\n \"SaleToPOIRequest\":{\n \"EventNotification\":{\n \"EventDetails\":\"newstate=IDLE&oldstate=START\",\n \"EventToNotify\":\"OutOfOrder\",\n \"TimeStamp\":\"2019-08-07T10:16:10.000Z\"\n },\n \"MessageHeader\":{\n \"SaleID\":\"POSSystemID12345\",\n \"ProtocolVersion\":\"3.0\",\n \"MessageType\":\"Notification\",\n \"POIID\":\"V400m-324688179\",\n \"MessageClass\":\"Event\",\n \"MessageCategory\":\"Event\",\n \"DeviceID\":\"1517998563\"\n }\n }\n}<\/code><\/pre>\nInitialised<\/h3>\n
{\n \"SaleToPOIRequest\":{\n \"EventNotification\":{\n \"EventDetails\":\"newstate=IDLE&oldstate=START\",\n \"EventToNotify\":\"Initialised\",\n \"TimeStamp\":\"2019-08-07T10:16:10.000Z\"\n },\n \"MessageHeader\":{\n \"SaleID\":\"POSSystemID12345\",\n \"ProtocolVersion\":\"3.0\",\n \"MessageType\":\"Notification\",\n \"POIID\":\"V400m-324688179\",\n \"MessageClass\":\"Event\",\n \"MessageCategory\":\"Event\",\n \"DeviceID\":\"1517998564\"\n }\n }\n}<\/code><\/pre>\nReject<\/h3>\n
{\n \"SaleToPOIRequest\":{\n \"EventNotification\":{\n \"EventDetails\":\"newstate=IDLE&oldstate=START\",\n \"EventToNotify\":\"Reject\",\n \"TimeStamp\":\"2019-08-07T10:16:10.000Z\"\n },\n \"MessageHeader\":{\n \"SaleID\":\"POSSystemID12345\",\n \"ProtocolVersion\":\"3.0\",\n \"MessageType\":\"Notification\",\n \"POIID\":\"V400m-324688179\",\n \"MessageClass\":\"Event\",\n \"MessageCategory\":\"Event\",\n \"DeviceID\":\"1517998565\"\n }\n }\n}<\/code><\/pre>\nSaleWakeUp<\/h3>\n
{\n \"SaleToPOIRequest\":{\n \"EventNotification\":{\n \"EventDetails\":\"0123456789\",\n \"EventToNotify\":\"SaleWakeUp\",\n \"TimeStamp\":\"2019-11-15T10:16:10.000Z\"\n },\n \"MessageHeader\":{\n \"SaleID\":\"POSSystemID12345\",\n \"ProtocolVersion\":\"3.0\",\n \"MessageType\":\"Notification\",\n \"POIID\":\"V400m-324688179\",\n \"MessageClass\":\"Event\",\n \"MessageCategory\":\"Event\",\n \"DeviceID\":\"1517998561\"\n }\n }\n}<\/code><\/pre>","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/design-your-integration\/notifications\/event-notifications","articleFields":{"description":"Receba notifica\u00e7\u00f5es de eventos em sua caixa registradora.","next_steps":[{"title":"Fa\u00e7a um pagamento","description":"Efetue um pagamento com cart\u00e3o com nossa API de terminais.","url":"\/point-of-sale\/basic-tapi-integration\/make-a-payment","required":true},{"title":"Fundamentos da API de terminais","description":"Conhe\u00e7a nossa API de terminais.","url":"\/point-of-sale\/design-your-integration\/terminal-api","required":true},{"title":"Exibir notifica\u00e7\u00f5es","description":"Mantenha sua equipe informada sobre o andamento da transa\u00e7\u00e3o.","url":"\/point-of-sale\/design-your-integration\/notifications\/display-notifications","required":false},{"title":"Gere recibos","description":"Aprenda a gerar recibos de transa\u00e7\u00e3o.","url":"\/point-of-sale\/basic-tapi-integration\/generate-receipts","required":false}],"last_edit_on":"30-03-2020 17:08"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/design-your-integration\/notifications\/event-notifications","title":"Notifica\u00e7\u00f5es de eventos","content":"De tempos em tempos, um dos terminais da Adyen encontram um problema ou precisam realizar manuten\u00e7\u00e3o. Quando isso acontece, o terminal gera uma notifica\u00e7\u00e3o de evento. Voc\u00ea pode opcionalmente apresentar esta notifica\u00e7\u00e3o em sua caixa registradora para informar a equipe da loja sobre a disponibilidade e o estado do terminal.\nAqui descrevemos como voc\u00ea exp\u00f5e um endpoint no servidor e configura notifica\u00e7\u00f5es de eventos. Seu servidor receber\u00e1 webhooks que incluem um EventToNotify. Isso indica o estado do terminal e pode ser usado para apresentar uma mensagem na sua caixa registradora.\nTamb\u00e9m fornecemos uma lista de tipos de EventToNotify poss\u00edveis e exemplos de cada um.\nConfigurar notifica\u00e7\u00f5es de eventos\nEtapa 1: Expor um endpoint em seu servidor\nAs notifica\u00e7\u00f5es de eventos s\u00e3o enviadas como HTTP callbacks (webhooks) para um endpoint no seu servidor. Para receber notifica\u00e7\u00f5es, verifique se voc\u00ea possui um servidor com:\n\nUm endpoint que pode receber uma chamada JSON.\nUma porta TCP aberta para tr\u00e1fego HTTP (443, 8443 ou 8843).\n\nPara teste, voc\u00ea tamb\u00e9m pode usar uma porta HTTP (80, 8080 ou 8888).\n\nUm nome de usu\u00e1rio e senha para autentica\u00e7\u00e3o b\u00e1sica.\n\nEtapa 2: Configurar notifica\u00e7\u00f5es na sua \u00e1rea de cliente\nO pr\u00f3ximo passo \u00e9 inserir os detalhes do seu servidor na sua \u00c1rea do Cliente e selecionar informa\u00e7\u00f5es adicionais que voc\u00ea deseja receber nas notifica\u00e7\u00f5es. Voc\u00ea pode configurar as notifica\u00e7\u00f5es no n\u00edvel de company account ou merchant account.\n\nFa\u00e7a login em sua Customer Area. Para configurar notifica\u00e7\u00f5es no n\u00edvel de merchant accoout, mude para o n\u00edvel de conta desejada.\nV\u00e1 para Developers > Webhooks e selecione + Webhook.\nN\u00e3o lado de Terminal API details, selecione Add.\nNa se\u00e7\u00e3o Transport:\n\nDigite o URL do servidos. Verifique se \u00e9 um URL public.\nDigita a SSL (TLS) Version do seu servidor.\nMarque a caixa de sele\u00e7\u00e3o como Active.\n\nNa se\u00e7\u00e3o Authentication, digite o nome de usu\u00e1rio e a senha do servidor para autentica\u00e7\u00e3o b\u00e1sica.\nInclu\u00edmos esses detalhes no cabe\u00e7alho da solicita\u00e7\u00e3o de notifica\u00e7\u00e3o para autentica\u00e7\u00e3o no seu servidor.\nNa se\u00e7\u00e3o Additional settings, ative Event notification.\nSelecione Test Configuration e verifique se a notifica\u00e7\u00e3o foi recebida no seu terminal.\nSe o seu terminal recebeu a notifica\u00e7\u00e3o, selecione Save Configuration.\n\nAgora, as notifica\u00e7\u00f5es de eventos ser\u00e3o enviadas para o terminal especificado.\nTipos de notifica\u00e7\u00e3o de eventos\nCada notifica\u00e7\u00e3o cont\u00e9m um EventToNotify. Voc\u00ea pode usar isso para apresentar uma mensagem na sua caixa registradora informando a equipe da loja sobre o estado do terminal.\n\n\n\nEvento\nDescri\u00e7\u00e3o\n\n\n\n\nShutdown\nO terminal est\u00e1 desligando.\n\n\nBeginMaintenance\nO terminal est\u00e1 desligando.\n\n\nEndMaintenance\nA manuten\u00e7\u00e3o do terminal est\u00e1 terminanda.\n\n\nOutOfOrder\nO terminal est\u00e1 inacess\u00edvel.\n\n\nInitialised\nO terminal foi inicializado e est\u00e1 pronto para as transa\u00e7\u00f5es.\n\n\nReject\nUma solicita\u00e7\u00e3o foi rejeitada. Uma explica\u00e7\u00e3o do erro deve ser fornecida no elemento EventDetails.\n\n\nSaleWakeUp\nO terminal est\u00e1 iniciando uma solicita\u00e7\u00e3o de pagamento. O elemento EventDetails cont\u00e9m o n\u00famero de refer\u00eancia que foi inserido no terminal.\n\n\n\nExemplos de notifica\u00e7\u00f5es de eventos s\u00e3o fornecidos abaixo.\nExemplos\nShutdown\n{\n \"SaleToPOIRequest\":{\n \"EventNotification\":{\n \"EventDetails\":\"newstate=IDLE&oldstate=START\",\n \"EventToNotify\":\"Shutdown\",\n \"TimeStamp\":\"2019-08-07T10:16:10.000Z\"\n },\n \"MessageHeader\":{\n \"SaleID\":\"POSSystemID12345\",\n \"ProtocolVersion\":\"3.0\",\n \"MessageType\":\"Notification\",\n \"POIID\":\"V400m-324688179\",\n \"MessageClass\":\"Event\",\n \"MessageCategory\":\"Event\",\n \"DeviceID\":\"1517998561\"\n }\n }\n}\nBeginMaintenance\n{\n \"SaleToPOIRequest\":{\n \"EventNotification\":{\n \"EventDetails\":\"newstate=IDLE&oldstate=START\",\n \"EventToNotify\":\"BeginMaintenance\",\n \"TimeStamp\":\"2019-08-07T10:16:10.000Z\"\n },\n \"MessageHeader\":{\n \"SaleID\":\"POSSystemID12345\",\n \"ProtocolVersion\":\"3.0\",\n \"MessageType\":\"Notification\",\n \"POIID\":\"V400m-324688179\",\n \"MessageClass\":\"Event\",\n \"MessageCategory\":\"Event\",\n \"DeviceID\":\"1517998562\"\n }\n }\n}\nEndMaintenance\n{\n \"SaleToPOIRequest\":{\n \"EventNotification\":{\n \"EventDetails\":\"newstate=IDLE&oldstate=START\",\n \"EventToNotify\":\"EndMaintenance\",\n \"TimeStamp\":\"2019-08-07T10:16:10.000Z\"\n },\n \"MessageHeader\":{\n \"SaleID\":\"POSSystemID12345\",\n \"ProtocolVersion\":\"3.0\",\n \"MessageType\":\"Notification\",\n \"POIID\":\"V400m-324688179\",\n \"MessageClass\":\"Event\",\n \"MessageCategory\":\"Event\",\n \"DeviceID\":\"1517998561\"\n }\n }\n}\nOutOfOrder\n{\n \"SaleToPOIRequest\":{\n \"EventNotification\":{\n \"EventDetails\":\"newstate=IDLE&oldstate=START\",\n \"EventToNotify\":\"OutOfOrder\",\n \"TimeStamp\":\"2019-08-07T10:16:10.000Z\"\n },\n \"MessageHeader\":{\n \"SaleID\":\"POSSystemID12345\",\n \"ProtocolVersion\":\"3.0\",\n \"MessageType\":\"Notification\",\n \"POIID\":\"V400m-324688179\",\n \"MessageClass\":\"Event\",\n \"MessageCategory\":\"Event\",\n \"DeviceID\":\"1517998563\"\n }\n }\n}\nInitialised\n{\n \"SaleToPOIRequest\":{\n \"EventNotification\":{\n \"EventDetails\":\"newstate=IDLE&oldstate=START\",\n \"EventToNotify\":\"Initialised\",\n \"TimeStamp\":\"2019-08-07T10:16:10.000Z\"\n },\n \"MessageHeader\":{\n \"SaleID\":\"POSSystemID12345\",\n \"ProtocolVersion\":\"3.0\",\n \"MessageType\":\"Notification\",\n \"POIID\":\"V400m-324688179\",\n \"MessageClass\":\"Event\",\n \"MessageCategory\":\"Event\",\n \"DeviceID\":\"1517998564\"\n }\n }\n}\nReject\n{\n \"SaleToPOIRequest\":{\n \"EventNotification\":{\n \"EventDetails\":\"newstate=IDLE&oldstate=START\",\n \"EventToNotify\":\"Reject\",\n \"TimeStamp\":\"2019-08-07T10:16:10.000Z\"\n },\n \"MessageHeader\":{\n \"SaleID\":\"POSSystemID12345\",\n \"ProtocolVersion\":\"3.0\",\n \"MessageType\":\"Notification\",\n \"POIID\":\"V400m-324688179\",\n \"MessageClass\":\"Event\",\n \"MessageCategory\":\"Event\",\n \"DeviceID\":\"1517998565\"\n }\n }\n}\nSaleWakeUp\n{\n \"SaleToPOIRequest\":{\n \"EventNotification\":{\n \"EventDetails\":\"0123456789\",\n \"EventToNotify\":\"SaleWakeUp\",\n \"TimeStamp\":\"2019-11-15T10:16:10.000Z\"\n },\n \"MessageHeader\":{\n \"SaleID\":\"POSSystemID12345\",\n \"ProtocolVersion\":\"3.0\",\n \"MessageType\":\"Notification\",\n \"POIID\":\"V400m-324688179\",\n \"MessageClass\":\"Event\",\n \"MessageCategory\":\"Event\",\n \"DeviceID\":\"1517998561\"\n }\n }\n}","type":"page","locale":"pt","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Design your integration","lvl3":"Notifications and webhooks","lvl4":"Notifica\u00e7\u00f5es de eventos"},"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\/design-your-integration","lvl3":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/design-your-integration\/notifications","lvl4":"\/pt\/point-of-sale\/design-your-integration\/notifications\/event-notifications"},"levels":5,"category":"In-person payments","category_color":"green","tags":["Notifica\u00e7\u00f5es","eventos"]}}