{"title":"Ativando um cart\u00e3o vale presente","category":"default","creationDate":1776961627,"content":"<p>Ao emitir um novo cart\u00e3o vale presente para um cliente, voc\u00ea precisar\u00e1 fazer uma solicita\u00e7\u00e3o de ativa\u00e7\u00e3o antes que o cart\u00e3o possa ser usado para transa\u00e7\u00f5es. Ao ativar o cart\u00e3o vale presente, voc\u00ea tamb\u00e9m poder\u00e1 carregar um saldo inicial.<\/p>\n<p>A ativa\u00e7\u00e3o do cart\u00e3o vale presente tamb\u00e9m \u00e9 uma ferramenta de prote\u00e7\u00e3o contra fraudes. Se o cart\u00e3o n\u00e3o estiver ativo, ele n\u00e3o poder\u00e1 ser resgatado.<\/p>\n<p>Quando a solicita\u00e7\u00e3o de ativa\u00e7\u00e3o \u00e9 processada, voc\u00ea recebe um resultado indicando se a ativa\u00e7\u00e3o foi bem-sucedida.<\/p>\n<h2>Antes de come\u00e7ar<\/h2>\n<p>Antes de realizar transa\u00e7\u00f5es com cart\u00e3o vale presente, certifique-se de:<\/p>\n<ul>\n<li>Ler e entender nossos <a href=\"\/pt\/point-of-sale\/design-your-integration\/terminal-api\">fundamentos da API de terminais<\/a>.<\/li>\n<li>Criar uma integra\u00e7\u00e3o que pode <a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/make-a-payment\">efetuar um pagamento<\/a>.<\/li>\n<li>Concluir o processo de integra\u00e7\u00e3o com seu provedor de cart\u00e3o vale presente.<\/li>\n<li><a href=\"\/pt\/point-of-sale\/what-we-support\/payment-methods\/add-payment-methods\">Adicionar o m\u00e9todo de pagamento de sua escolha \u00e0 sua conta Adyen<\/a>.<\/li>\n<\/ul>\n<h2>Etapa 1: fa\u00e7a a solicita\u00e7\u00e3o de ativa\u00e7\u00e3o<\/h2>\n<p>Para ativar um cart\u00e3o vale presente:<\/p>\n<ul>\n<li>\n<p>Fa\u00e7a uma solicita\u00e7\u00e3o POST para o <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><code>MessageHeader<\/code>: Segue a estrutura da <code>MessageHeader<\/code> padr\u00e3o, explicada nos <a href=\"\/pt\/point-of-sale\/design-your-integration\/terminal-api#request-message-header\">fundamentos da API de terminais<\/a>, que incluem:<\/p>\n<ul>\n<li><code>ProtocolVersion<\/code>: <strong>3.0<\/strong><\/li>\n<li><code>MessageCategory<\/code>: <strong>StoredValue<\/strong><\/li>\n<li><code>MessageType<\/code>: <strong>Request<\/strong><\/li>\n<li><code>SaleID<\/code>: Seu ID exclusivo para a caixa registradora.<\/li>\n<li><code>ServiceID<\/code>: Seu ID exclusivo para esta tentativa de transa\u00e7\u00e3o. Este precisa ser \u00fanico nas \u00faltimas 48 horas<\/li>\n<li>\n<p><code>POIID<\/code>: ID exclusivo do terminal. Isso indica para qual terminal a transa\u00e7\u00e3o ser\u00e1 roteada.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p><code>StoredValueRequest<\/code>: O corpo da solicita\u00e7\u00e3o enviada para a solicita\u00e7\u00e3o de ativa\u00e7\u00e3o deve incluir:<\/p>\n<ul>\n<li>\n<p><code>SaleData.SaleTransactionID.TransactionID<\/code>: Sua refer\u00eancia exclusiva para esta solicita\u00e7\u00e3o.<\/p>\n<\/li>\n<li>\n<p><code>SaleData.SaleTransactionID.TimeStamp<\/code>: Data e hora da solicita\u00e7\u00e3o, no <a href=\"https:\/\/en.wikipedia.org\/wiki\/ISO_8601#Coordinated_Universal_Time_(UTC)\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">formato UTC<\/a>.<\/p>\n<\/li>\n<li>\n<p><code>StoredValueData.StoredValueTransactionType<\/code>: <strong>Activate<\/strong><\/p>\n<\/li>\n<li>\n<p><code>StoredValueData.StoredValueAccountID<\/code>: Os detalhes do cart\u00e3o vale presente:<\/p>\n<ul>\n<li><code>StoredValueAccountType<\/code>: <strong>GiftCard<\/strong><\/li>\n<li><code>StoredValueProvider<\/code>: O emissor do cart\u00e3o vale presente: <strong>givex<\/strong>, <strong>svs<\/strong>, ou <strong>valuelink<\/strong><\/li>\n<li><code>IdentificationType<\/code>: <strong>PAN<\/strong><\/li>\n<li>\n<p><code>EntryMode<\/code>, <code>StoredValueID<\/code> e <code>ExpiryDate<\/code>: Esses par\u00e2metros dependem do  <a href=\"\/pt\/point-of-sale\/what-we-support\/payment-methods\/gift-cards-terminal-api#card-entry\">metodo de leitura do cart\u00e3o<\/a> que voc\u00ea est\u00e1 usando.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Entrada do cart\u00e3o<\/th>\n<th style=\"text-align: left;\">Par\u00e2metros<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Scan<\/td>\n<td style=\"text-align: left;\"><ul><li><code>EntryMode<\/code>: <strong>Scanned<\/strong><\/li><li><code>StoredValueID<\/code>: N\u00famero do cart\u00e3o vale presente.<\/li><li><code>ExpiryDate<\/code>: Data de validade do cart\u00e3o vale presente.<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Swipe or MKE<\/td>\n<td style=\"text-align: left;\"><ul><li><code>EntryMode<\/code>: <strong>MagStripe<\/strong><\/li><li><code>StoredValueID<\/code>: <strong>xxxxxxxxxxxxxxxxxxx<\/strong>.<\/li><li>N\u00e3o inclua o <code>ExpiryDate<\/code> par\u00e2metro.<\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p><code>StoredValueData.ItemAmount<\/code>: Saldo inicial sendo carregado no cart\u00e3o vale presente<\/p>\n<\/li>\n<li>\n<p><code>StoredValueData.Currency<\/code>: Moeda do saldo inicial.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>O exemplo abaixo mostra como voc\u00ea ativaria um cart\u00e3o vale presente utilizando a  leitura por scanner, adicionando um saldo inicial de  <strong>GBP&nbsp;10,00<\/strong>.<\/p>\n<div class=\"sc-notice info\"><div>\n<p>Para obter mais informa\u00e7\u00f5es sobre a estrutura de solicita\u00e7\u00e3o da API de terminais, consulte os <a href=\"\/pt\/point-of-sale\/design-your-integration\/terminal-api#requests\">fundamentos da API de terminais<\/a>.<\/p>\n<\/div><\/div>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"''\" :id=\"'activate1.scan'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"JSON\",\"content\":\"{\\n    \\\"SaleToPOIRequest\\\":{\\n        \\\"MessageHeader\\\":{\\n            \\\"MessageType\\\":\\\"Request\\\",\\n            \\\"MessageClass\\\":\\\"Service\\\",\\n            \\\"MessageCategory\\\":\\\"StoredValue\\\",\\n            \\\"SaleID\\\":\\\"POSSystemID12345\\\",\\n            \\\"POIID\\\":\\\"V400m-324688179\\\",\\n            \\\"ProtocolVersion\\\":\\\"3.0\\\",\\n            \\\"ServiceID\\\":\\\"9264\\\"\\n        },\\n        \\\"StoredValueRequest\\\":{\\n            \\\"SaleData\\\":{\\n                \\\"SaleTransactionID\\\":{\\n                    \\\"TransactionID\\\":\\\"44738\\\",\\n                    \\\"TimeStamp\\\":\\\"2019-09-29T14:44:32+00:00\\\"\\n                },\\n                \\\"SaleToAcquirerData\\\":\\\"ssc=1111\\\"\\n            },\\n            \\\"StoredValueData\\\":[\\n                {\\n                    \\\"StoredValueTransactionType\\\":\\\"Activate\\\",\\n                    \\\"StoredValueAccountID\\\":{\\n                        \\\"StoredValueAccountType\\\":\\\"GiftCard\\\",\\n                        \\\"StoredValueProvider\\\":\\\"svs\\\",\\n                        \\\"IdentificationType\\\":\\\"PAN\\\",\\n                        \\\"EntryMode\\\":[\\n                            \\\"Scanned\\\"\\n                        ],\\n                        \\\"StoredValueID\\\":\\\"6006491260550218066\\\",\\n                        \\\"ExpiryDate\\\":\\\"1122\\\"\\n                    },\\n                    \\\"ItemAmount\\\":10.00,\\n                    \\\"Currency\\\":\\\"GBP\\\"\\n                }\\n            ]\\n        }\\n    }\\n}\"},{\"language\":\"java\",\"tabTitle\":\"Java\",\"content\":\"String saleID = \\\"YOUR_CASH_REGISTER_ID\\\";\\nString POIID = \\\"YOUR_TERMINAL_ID\\\";\\nString serviceID = \\\"YOUR_UNIQUE_ATTEMPT_ID\\\";\\nString transactionID = \\\"YOUR_UNIQUE_TRANSACTION_ID\\\";\\n\\nSaleToPOIRequest saleToPOIRequest = new SaleToPOIRequest();\\nMessageHeader messageHeader = new MessageHeader();\\nmessageHeader.setMessageType( MessageType.REQUEST );\\nmessageHeader.setMessageClass( MessageClassType.SERVICE );\\nmessageHeader.setMessageCategory( MessageCategoryType.STORED_VALUE );\\nmessageHeader.setSaleID(saleID);\\nmessageHeader.setPOIID(POIID);\\nmessageHeader.setProtocolVersion(\\\"3.0\\\");\\nmessageHeader.setServiceID(serviceID);\\nsaleToPOIRequest.setMessageHeader(messageHeader);\\n\\nStoredValueRequest storedValueRequest = new StoredValueRequest();\\nSaleData saleData = new SaleData();\\nTransactionIdentification saleTransactionID = new TransactionIdentification();\\nsaleTransactionID.setTransactionID(transactionID);\\nsaleTransactionID.setTimeStamp(DatatypeFactory.newInstance().newXMLGregorianCalendar(new GregorianCalendar()));\\nsaleData.setSaleTransactionID(saleTransactionID);\\nstoredValueRequest.setSaleData(saleData);\\n\\nStoredValueData storedValueData = new StoredValueData();\\nstoredValueData.setStoredValueTransactionType( StoredValueTransactionType.ACTIVATE );\\nStoredValueAccountID storedValueAccountID = new StoredValueAccountID();\\nstoredValueAccountID.setStoredValueAccountType( StoredValueAccountType.GIFT_CARD );\\nstoredValueAccountID.setStoredValueProvider(\\\"svs\\\");\\nstoredValueAccountID.setIdentificationType( IdentificationType.PAN );\\nstoredValueAccountID.getEntryMode().add( EntryModeType.SCANNED );\\nstoredValueAccountID.setExpiryDate(\\\"1122\\\");\\nstoredValueAccountID.setStoredValueID(\\\"6006491260550218066\\\");\\nstoredValueData.setStoredValueAccountID(storedValueAccountID);\\nstoredValueData.setItemAmount( BigDecimal.valueOf(10.00) );\\nstoredValueData.setCurrency(\\\"GBP\\\");\\nstoredValueRequest.setStoredValueData(storedValueData);\\nsaleToPOIRequest.setStoredValueRequest(storedValueRequest);\\nterminalAPIRequest.setSaleToPOIRequest(saleToPOIRequest);\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<\/ul>\n<p>A solicita\u00e7\u00e3o de ativa\u00e7\u00e3o \u00e9 enviada \u00e0 plataforma de pagamentos da Adyen para processamento.<\/p>\n<h2>Etapa 2: recebendo o resultado da ativa\u00e7\u00e3o<\/h2>\n<p>Depois de processada, sua integra\u00e7\u00e3o recebe um resultado de ativa\u00e7\u00e3o indicando se o cart\u00e3o vale presente foi ativado com sucesso. Isso \u00e9 fornecido em uma resposta de API s\u00edncrona, a menos que sua integra\u00e7\u00e3o use <a href=\"\/pt\/point-of-sale\/design-your-integration\/choose-your-architecture\/cloud#async\">comunica\u00e7\u00f5es em nuvem ass\u00edncronas<\/a>.<\/p>\n<div class=\"notices yellow\">\n<p>Se sua integra\u00e7\u00e3o usar comunica\u00e7\u00f5es em nuvem ass\u00edncronas, voc\u00ea receber\u00e1 o resultado em uma <a href=\"\/pt\/point-of-sale\/design-your-integration\/notifications\/display-notifications#tender-final\">notifica\u00e7\u00e3o de exibi\u00e7\u00e3o TENDER_FINAL<\/a><\/p>\n<\/div>\n<p>Se a ativa\u00e7\u00e3o for bem-sucedida:<\/p>\n<ul>\n<li>\n<p>\u2022   Voc\u00ea receber\u00e1 uma resposta com um objeto <code>StoredValueResponse<\/code> que inclui:<\/p>\n<ul>\n<li>\n<p><code>POIData.POITransactionID.TransactionID<\/code>: <a href=\"\/pt\/point-of-sale\/design-your-integration\/terminal-api#transaction-identifier\">Identificador da transa\u00e7\u00e3o<\/a> para a ativa\u00e7\u00e3o do cart\u00e3o vale presente.<\/p>\n<\/li>\n<li>\n<p><code>StoredValueResult<\/code>:<\/p>\n<ul>\n<li><code>StoredValueTransactionType<\/code>: <strong>Activate<\/strong><\/li>\n<li>\n<p><code>ItemAmount<\/code> e <code>Currency<\/code>: saldo atual e moeda associados ao cart\u00e3o.<\/p>\n <!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p><code>Response.Result<\/code>: <strong>Success<\/strong><\/p>\n<\/li>\n<\/ul>\n<p>O exemplo abaixo indica que o cart\u00e3o vale presente foi ativado com sucesso, e o cart\u00e3o foi carregado com um saldo inicial de  <strong>GBP&nbsp;10,00<\/strong>.<\/p>\n<div class=\"notices blue\">\n<p>Para obter mais informa\u00e7\u00f5es sobre a estrutura de resposta da API de terminais, consulte os <a href=\"\/pt\/point-of-sale\/design-your-integration\/terminal-api#responses\">fundamentos da API de terminais<\/a>.<\/p>\n<\/div>\n<pre><code class=\"language-json\">{\n  \"SaleToPOIResponse\":{\n    \"StoredValueResponse\":{\n      \"POIData\":{\n        \"POITransactionID\":{\n          \"TimeStamp\":\"2019-03-26T09:31:29.000Z\",\n          \"TransactionID\":\"oLkO001522056689002.9815220566972551\"\n        }\n      },\n      ...\n      \"StoredValueResult\":[\n        {\n          \"StoredValueTransactionType\":\"Activate\",\n          \"ItemAmount\":10.00,\n          \"Currency\":\"GBP\"\n        }\n      ],\n      \"Response\":{\n        \"Result\":\"Success\"\n      }\n    },\n    \"MessageHeader\":{\n      \"ProtocolVersion\":\"3.0\",\n      \"SaleID\":\"POSSystemID12345\",\n      \"MessageClass\":\"Service\",\n      \"MessageCategory\":\"StoredValue\",\n      \"ServiceID\":\"9264\",\n      \"POIID\":\"V400m-324688179\",\n      \"MessageType\":\"Response\"\n    }\n  }\n}<\/code><\/pre>\n<\/li>\n<\/ul>\n<h2>Next steps<\/h2>\n<div class=\"next-steps\" id=\"next-steps\" >\n<a href=\"\/point-of-sale\/what-we-support\/payment-methods\/gift-cards-terminal-api\/payment\" class=\"next-steps__step\" style=\"width:29%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Efetue um pagamento com um cart\u00e3o vale presente<\/h6><p>Efetue um pagamento com um cart\u00e3o vale presente ativado.<\/p><\/div><\/p><\/a><a href=\"\/point-of-sale\/what-we-support\/payment-methods\/gift-cards-terminal-api\/query-the-balance\" class=\"next-steps__step\" style=\"width:29%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Consulte o saldo do cart\u00e3o vale presente<\/h6><p>Verifique o saldo restante em um cart\u00e3o vale presente.<\/p><\/div><\/p><\/a><a href=\"\/point-of-sale\/what-we-support\/payment-methods\/gift-cards-terminal-api\/load-a-balance\" class=\"next-steps__step\" style=\"width:29%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Carregar um cart\u00e3o vale presente<\/h6><p>Coloque um cr\u00e9dito adicional em um cart\u00e3o vale presente.<\/p><\/div><\/p><\/a><\/div>\n\n<h2 id=\"see-also\">Veja tamb\u00e9m<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/point-of-sale\/what-we-support\/payment-methods\/gift-cards-terminal-api\/refund-gift-cards\"\n                        target=\"_self\"\n                        >\n                    Fazer um reembolso n\u00e3o referenciado para um cart\u00e3o vale presente\n                <\/a><\/li><li><a href=\"\/point-of-sale\/what-we-support\/payment-methods\/gift-cards-terminal-api\/deactivate\"\n                        target=\"_self\"\n                        >\n                    Desativar ou sacar o saldo de um cart\u00e3o vale presente\n                <\/a><\/li><li><a href=\"\/point-of-sale\/what-we-support\/payment-methods\/gift-cards-terminal-api\/void\"\n                        target=\"_self\"\n                        >\n                    Desfazer uma transa\u00e7\u00e3o realizada para um cart\u00e3o vale presente nas \u00faltimas 24 horas\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/alternative-payment-methods\/gift-cards-terminal-api\/activate","articleFields":{"description":"Ative o cart\u00e3o vale presente em seu terminal para que o cliente possa us\u00e1-lo.","id":"36196904","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"03-04-2020 18:12"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/alternative-payment-methods\/gift-cards-terminal-api\/activate","title":"Ativando um cart\u00e3o vale presente","content":"Ao emitir um novo cart\u00e3o vale presente para um cliente, voc\u00ea precisar\u00e1 fazer uma solicita\u00e7\u00e3o de ativa\u00e7\u00e3o antes que o cart\u00e3o possa ser usado para transa\u00e7\u00f5es. Ao ativar o cart\u00e3o vale presente, voc\u00ea tamb\u00e9m poder\u00e1 carregar um saldo inicial.\nA ativa\u00e7\u00e3o do cart\u00e3o vale presente tamb\u00e9m \u00e9 uma ferramenta de prote\u00e7\u00e3o contra fraudes. Se o cart\u00e3o n\u00e3o estiver ativo, ele n\u00e3o poder\u00e1 ser resgatado.\nQuando a solicita\u00e7\u00e3o de ativa\u00e7\u00e3o \u00e9 processada, voc\u00ea recebe um resultado indicando se a ativa\u00e7\u00e3o foi bem-sucedida.\nAntes de come\u00e7ar\nAntes de realizar transa\u00e7\u00f5es com cart\u00e3o vale presente, certifique-se de:\n\nLer e entender nossos fundamentos da API de terminais.\nCriar uma integra\u00e7\u00e3o que pode efetuar um pagamento.\nConcluir o processo de integra\u00e7\u00e3o com seu provedor de cart\u00e3o vale presente.\nAdicionar o m\u00e9todo de pagamento de sua escolha \u00e0 sua conta Adyen.\n\nEtapa 1: fa\u00e7a a solicita\u00e7\u00e3o de ativa\u00e7\u00e3o\nPara ativar um cart\u00e3o vale presente:\n\n\nFa\u00e7a uma solicita\u00e7\u00e3o POST para o endpoint da API de terminais , especificando:\n\n\nMessageHeader: Segue a estrutura da MessageHeader padr\u00e3o, explicada nos fundamentos da API de terminais, que incluem:\n\nProtocolVersion: 3.0\nMessageCategory: StoredValue\nMessageType: Request\nSaleID: Seu ID exclusivo para a caixa registradora.\nServiceID: Seu ID exclusivo para esta tentativa de transa\u00e7\u00e3o. Este precisa ser \u00fanico nas \u00faltimas 48 horas\n\nPOIID: ID exclusivo do terminal. Isso indica para qual terminal a transa\u00e7\u00e3o ser\u00e1 roteada.\n\n\n\n\n\nStoredValueRequest: O corpo da solicita\u00e7\u00e3o enviada para a solicita\u00e7\u00e3o de ativa\u00e7\u00e3o deve incluir:\n\n\nSaleData.SaleTransactionID.TransactionID: Sua refer\u00eancia exclusiva para esta solicita\u00e7\u00e3o.\n\n\nSaleData.SaleTransactionID.TimeStamp: Data e hora da solicita\u00e7\u00e3o, no formato UTC.\n\n\nStoredValueData.StoredValueTransactionType: Activate\n\n\nStoredValueData.StoredValueAccountID: Os detalhes do cart\u00e3o vale presente:\n\nStoredValueAccountType: GiftCard\nStoredValueProvider: O emissor do cart\u00e3o vale presente: givex, svs, ou valuelink\nIdentificationType: PAN\n\nEntryMode, StoredValueID e ExpiryDate: Esses par\u00e2metros dependem do  metodo de leitura do cart\u00e3o que voc\u00ea est\u00e1 usando.\n\n\n\nEntrada do cart\u00e3o\nPar\u00e2metros\n\n\n\n\nScan\nEntryMode: ScannedStoredValueID: N\u00famero do cart\u00e3o vale presente.ExpiryDate: Data de validade do cart\u00e3o vale presente.\n\n\nSwipe or MKE\nEntryMode: MagStripeStoredValueID: xxxxxxxxxxxxxxxxxxx.N\u00e3o inclua o ExpiryDate par\u00e2metro.\n\n\n\n\n\n\n\nStoredValueData.ItemAmount: Saldo inicial sendo carregado no cart\u00e3o vale presente\n\n\nStoredValueData.Currency: Moeda do saldo inicial.\n\n\n\n\n\nO exemplo abaixo mostra como voc\u00ea ativaria um cart\u00e3o vale presente utilizando a  leitura por scanner, adicionando um saldo inicial de  GBP&nbsp;10,00.\n\nPara obter mais informa\u00e7\u00f5es sobre a estrutura de solicita\u00e7\u00e3o da API de terminais, consulte os fundamentos da API de terminais.\n\n\n\n\n\n\nA solicita\u00e7\u00e3o de ativa\u00e7\u00e3o \u00e9 enviada \u00e0 plataforma de pagamentos da Adyen para processamento.\nEtapa 2: recebendo o resultado da ativa\u00e7\u00e3o\nDepois de processada, sua integra\u00e7\u00e3o recebe um resultado de ativa\u00e7\u00e3o indicando se o cart\u00e3o vale presente foi ativado com sucesso. Isso \u00e9 fornecido em uma resposta de API s\u00edncrona, a menos que sua integra\u00e7\u00e3o use comunica\u00e7\u00f5es em nuvem ass\u00edncronas.\n\nSe sua integra\u00e7\u00e3o usar comunica\u00e7\u00f5es em nuvem ass\u00edncronas, voc\u00ea receber\u00e1 o resultado em uma notifica\u00e7\u00e3o de exibi\u00e7\u00e3o TENDER_FINAL\n\nSe a ativa\u00e7\u00e3o for bem-sucedida:\n\n\n\u2022   Voc\u00ea receber\u00e1 uma resposta com um objeto StoredValueResponse que inclui:\n\n\nPOIData.POITransactionID.TransactionID: Identificador da transa\u00e7\u00e3o para a ativa\u00e7\u00e3o do cart\u00e3o vale presente.\n\n\nStoredValueResult:\n\nStoredValueTransactionType: Activate\n\nItemAmount e Currency: saldo atual e moeda associados ao cart\u00e3o.\n \n\n\n\n\nResponse.Result: Success\n\n\nO exemplo abaixo indica que o cart\u00e3o vale presente foi ativado com sucesso, e o cart\u00e3o foi carregado com um saldo inicial de  GBP&nbsp;10,00.\n\nPara obter mais informa\u00e7\u00f5es sobre a estrutura de resposta da API de terminais, consulte os fundamentos da API de terminais.\n\n{\n  \"SaleToPOIResponse\":{\n    \"StoredValueResponse\":{\n      \"POIData\":{\n        \"POITransactionID\":{\n          \"TimeStamp\":\"2019-03-26T09:31:29.000Z\",\n          \"TransactionID\":\"oLkO001522056689002.9815220566972551\"\n        }\n      },\n      ...\n      \"StoredValueResult\":[\n        {\n          \"StoredValueTransactionType\":\"Activate\",\n          \"ItemAmount\":10.00,\n          \"Currency\":\"GBP\"\n        }\n      ],\n      \"Response\":{\n        \"Result\":\"Success\"\n      }\n    },\n    \"MessageHeader\":{\n      \"ProtocolVersion\":\"3.0\",\n      \"SaleID\":\"POSSystemID12345\",\n      \"MessageClass\":\"Service\",\n      \"MessageCategory\":\"StoredValue\",\n      \"ServiceID\":\"9264\",\n      \"POIID\":\"V400m-324688179\",\n      \"MessageType\":\"Response\"\n    }\n  }\n}\n\n\nNext steps\n\nEfetue um pagamento com um cart\u00e3o vale presenteEfetue um pagamento com um cart\u00e3o vale presente ativado.Consulte o saldo do cart\u00e3o vale presenteVerifique o saldo restante em um cart\u00e3o vale presente.Carregar um cart\u00e3o vale presenteColoque um cr\u00e9dito adicional em um cart\u00e3o vale presente.\n\nVeja tamb\u00e9m\n\n\n                    Fazer um reembolso n\u00e3o referenciado para um cart\u00e3o vale presente\n                \n                    Desativar ou sacar o saldo de um cart\u00e3o vale presente\n                \n                    Desfazer uma transa\u00e7\u00e3o realizada para um cart\u00e3o vale presente nas \u00faltimas 24 horas\n                \n","type":"page","locale":"pt","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Alternative payment methods","lvl3":"Cart\u00f5es vale presente para seu terminal","lvl4":"Ativando um cart\u00e3o vale presente"},"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\/alternative-payment-methods","lvl3":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/alternative-payment-methods\/gift-cards-terminal-api","lvl4":"\/pt\/point-of-sale\/alternative-payment-methods\/gift-cards-terminal-api\/activate"},"levels":5,"category":"In-person payments","category_color":"green","tags":["Ativando","cart\u00e3o","presente"]},"articleFiles":{"activate1.scan.json":"<p alt=\"\">activate1.scan.json<\/p>","activate1.swipe.json":"<p alt=\"\">activate1.swipe.json<\/p>"}}
