{"title":"Desativar ou sacar o saldo do cart\u00e3o vale presente","category":"default","creationDate":1776961627,"content":"<p>Quando o saldo de um cart\u00e3o vale presente estiver abaixo de um determinado valor ou quando houver suspeita de fraude, conv\u00e9m interromper o uso do cart\u00e3o. Neste caso, voc\u00ea pode:<\/p>\n<ul>\n<li>Fazer um <a href=\"#cashing-back-gift-card\">pedido de cashback<\/a> para retirar fundos do cart\u00e3o vale presente e devolver a quantia ao cliente em dinheiro. Se voc\u00ea sacar o saldo total, o cart\u00e3o n\u00e3o estar\u00e1 mais ativo e n\u00e3o poder\u00e1 ser usado novamente.<\/li>\n<li>\u2022 Fa\u00e7a uma <a href=\"#deactivate-gift-card\">solicita\u00e7\u00e3o de desativa\u00e7\u00e3o<\/a> para desativar o cart\u00e3o sem realizar o saque do valor total. Voc\u00ea s\u00f3 pode fazer isso em cart\u00e3o vale presente fornecidos pela Givex.<\/li>\n<\/ul>\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\">Adicionado o m\u00e9todo de pagamento escolhido \u00e0 sua conta Adyen <\/a>.<\/li>\n<li>\n<h2 id=\"cashing-back-gift-card\">Cashback para um cart\u00e3o vale presente<\/h2>\n<p>Suas op\u00e7\u00f5es com uma solicita\u00e7\u00e3o de cashback dependem do fornecedor do cart\u00e3o vale presente, das regras da bandeira e da lei aplic\u00e1vel. Se os cashbacks forem permitidos, normalmente voc\u00ea poder\u00e1 sacar apenas o valor total restante no cart\u00e3o. Mas se ocart\u00e3o vale presente foi fornecido pela Givex, \u00e9 poss\u00edvel, em alguns casos, dar o cashback de um valor parcial.<\/p>\n<\/li>\n<\/ul>\n<p>Os fundos retirados do cart\u00e3o vale presente podem ser devolvidos ao cliente em dinheiro ou transferidos para seu cart\u00e3o de cr\u00e9dito ou d\u00e9bito, mediante <a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/refund-payment#unreferenced-refund\">um cashback n\u00e3o referenciado<\/a>.<\/p>\n<h3>Etapa 1: realizando uma solicita\u00e7\u00e3o de cashback<\/h3>\n<p>Para reembolsar um cart\u00e3o vale presente:<\/p>\n<ol>\n<li><a href=\"\/pt\/point-of-sale\/what-we-support\/payment-methods\/gift-cards-terminal-api\/query-the-balance\">Verifique o saldo<\/a> restante no cart\u00e3o vale presente.<\/li>\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>Payment<\/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><code>POIID<\/code>: ID exclusivo do terminal. Isso indica para qual terminal a transa\u00e7\u00e3o ser\u00e1 roteada.<\/li>\n<\/ul>\n<!-- list separator -->\n<\/li>\n<li>\n<p><code>PaymentRequest<\/code>: O corpo da solicita\u00e7\u00e3o para a solicita\u00e7\u00e3o de cashback deve incluir:<\/p>\n<ul>\n<li><code>SaleData.SaleTransactionID.TimeStamp<\/code>: Data e hora da solicita\u00e7\u00e3o de cashback, 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>.<\/li>\n<li><code>SaleData.SaleTransactionID.TransactionID<\/code>: Sua refer\u00eancia exclusiva para esta solicita\u00e7\u00e3o de cashback.<\/li>\n<li><code>SaleData.SaleReferenceID<\/code>: Par\u00e2metro opcional para fornecer o n\u00famero do seu pedido. Voc\u00ea pode usar isso para conectar transa\u00e7\u00f5es de diferentes cart\u00e3o vale presente ao mesmo pedido. Em sua <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>, este aparecer\u00e1 como <strong>Merchant Order<\/strong> para a transa\u00e7\u00e3o.<\/li>\n<li><code>SaleData.SaleToAcquirerData<\/code>: <strong>redemptionType=cashback<\/strong><\/li>\n<li><code>PaymentTransaction.AmountsReq<\/code>: A <code>Currency<\/code> e o <code>RequestedAmount<\/code> que ser\u00e3o devolvidos ao cliente. Para sacar o valor total, voc\u00ea pode especificar esse valor exato ou especificar um valor zero (<strong>0<\/strong>).<\/li>\n<li><code>PaymentData.PaymentType<\/code>: <strong>Normal<\/strong><\/li>\n<li><code>PaymentData.PaymentInstrumentData.PaymentInstrumentType<\/code>: <strong>StoredValue<\/strong><\/li>\n<li>\n<p><code>PaymentData.PaymentInstrumentData.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;\">Leitura 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 markdown=\"1\"><code>EntryMode<\/code>: <strong>Scanned<\/strong><\/li><li markdown=\"1\"><code>StoredValueID<\/code>: N\u00famero do cart\u00e3o vale presente.<\/li><li markdown=\"1\"><code>ExpiryDate<\/code>: Data de validade do cart\u00e3o 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 markdown=\"1\"><code>EntryMode<\/code>: <strong>MagStripe<\/strong><\/li><li markdown=\"1\"><code>StoredValueID<\/code>: <strong>xxxxxxxxxxxxxxxxxxx<\/strong>.<\/li><li markdown=\"1\">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<\/ul>\n<\/li>\n<\/ul>\n<p>O exemplo abaixo mostra como voc\u00ea iniciaria uma solicita\u00e7\u00e3o de cashback de <strong>GBP&nbsp;4,50<\/strong> para um cart\u00e3o vale presente que j\u00e1 teve suas informa\u00e7\u00f5es digitalizadas.<\/p>\n<div class=\"notices blue\">\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>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"''\" :id=\"'cashback-and-cash-out-gift-cards_0'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"JSON\",\"content\":\"{\\n  \\\"SaleToPOIRequest\\\": {\\n    \\\"MessageHeader\\\": {\\n      \\\"ProtocolVersion\\\": \\\"3.0\\\",\\n      \\\"MessageClass\\\": \\\"Service\\\",\\n      \\\"MessageCategory\\\": \\\"Payment\\\",\\n      \\\"MessageType\\\": \\\"Request\\\",\\n      \\\"ServiceID\\\": \\\"9269\\\",\\n      \\\"SaleID\\\": \\\"POSTerminal\\\",\\n      \\\"POIID\\\": \\\"V400m-324688179\\\"\\n    },\\n    \\\"PaymentRequest\\\": {\\n      \\\"SaleData\\\": {\\n        \\\"SaleTransactionID\\\": {\\n          \\\"TransactionID\\\": \\\"44750\\\",\\n          \\\"TimeStamp\\\": \\\"2019-06-22T12:55:20+00:00\\\"\\n        },\\n        \\\"SaleReferenceID\\\": \\\"YOUR_ORDER_REFERENCE\\\",\\n        \\\"SaleToAcquirerData\\\": \\\"redemptionType=cashback\\\"\\n      },\\n      \\\"PaymentTransaction\\\": {\\n        \\\"AmountsReq\\\": {\\n          \\\"Currency\\\": \\\"GBP\\\",\\n          \\\"RequestedAmount\\\": 4.50\\n        }\\n      },\\n      \\\"PaymentData\\\": {\\n        \\\"PaymentType\\\": \\\"Normal\\\",\\n        \\\"PaymentInstrumentData\\\": {\\n          \\\"PaymentInstrumentType\\\": \\\"StoredValue\\\",\\n          \\\"StoredValueAccountID\\\": {\\n            \\\"StoredValueAccountType\\\": \\\"GiftCard\\\",\\n            \\\"StoredValueProvider\\\": \\\"svs\\\",\\n            \\\"IdentificationType\\\": \\\"PAN\\\",\\n            \\\"EntryMode\\\": [\\n              \\\"Scanned\\n            ],\\n            \\\"StoredValueID\\\": \\\"6006491260550218066\\\",\\n            \\\"ExpiryDate\\\": \\\"1122\\\"\\n          }\\n        }\\n      }\\n    }\\n  }\\n}\"},{\"language\":\"java\",\"tabTitle\":\"Java\",\"content\":\"String serviceID = \\\"YOUR_UNIQUE_ATTEMPT_ID\\\";\\nString saleID = \\\"YOUR_CASH_REGISTER_ID\\\";\\nString POIID = \\\"YOUR_TERMINAL_ID\\\";\\nString transactionID = \\\"YOUR_UNIQUE_TRANSACTION_ID\\\";\\n\\nSaleToPOIRequest saleToPOIRequest = new SaleToPOIRequest();\\nMessageHeader messageHeader = new MessageHeader();\\nmessageHeader.setProtocolVersion(\\\"3.0\\\");\\nmessageHeader.setMessageClass( MessageClassType.SERVICE );\\nmessageHeader.setMessageCategory( MessageCategoryType.PAYMENT );\\nmessageHeader.setMessageType( MessageType.REQUEST );\\nmessageHeader.setServiceID(serviceID);\\nmessageHeader.setSaleID(saleID);\\nmessageHeader.setPOIID(POIID);\\nsaleToPOIRequest.setMessageHeader(messageHeader);\\n\\nPaymentRequest paymentRequest = new PaymentRequest();\\nSaleData saleData = new SaleData();\\nTransactionIdentification saleTransactionID = new TransactionIdentification();\\nsaleTransactionID.setTransactionID(transactionID);\\nsaleTransactionID.setTimeStamp(DatatypeFactory.newInstance().newXMLGregorianCalendar(new GregorianCalendar()));\\nsaleData.setSaleTransactionID(saleTransactionID);\\nsaleData.setSaleReferenceID(\\\"YOUR_ORDER_REFERENCE\\\");\\nsaleData.setSaleToAcquirerData(\\\"redemptionType=cashback\\\");\\npaymentRequest.setSaleData(saleData);\\n\\nPaymentTransaction paymentTransaction = new PaymentTransaction();\\nAmountsReq amountsReq = new AmountsReq();\\namountsReq.setCurrency(\\\"GBP\\\");\\namountsReq.setRequestedAmount( BigDecimal.valueOf(4.50) );\\npaymentTransaction.setAmountsReq(amountsReq);\\npaymentRequest.setPaymentTransaction(paymentTransaction);\\n\\nPaymentData paymentData = new PaymentData();\\npaymentData.setPaymentType( PaymentType.NORMAL );\\nPaymentInstrumentData paymentInstrumentData = new PaymentInstrumentData();\\npaymentInstrumentData.setPaymentInstrumentType( PaymentInstrumentType.STORED_VALUE );\\nStoredValueAccountID storedValueAccountID = new StoredValueAccountID();\\nstoredValueAccountID.setStoredValueAccountType( StoredValueAccountType.GIFT_CARD );\\nstoredValueAccountID.setStoredValueProvider(\\\"svs\\\");\\nstoredValueAccountID.setIdentificationType( IdentificationType.PAN );\\nstoredValueAccountID.getEntryMode().add( EntryModeType.SCANNED );\\nstoredValueAccountID.setStoredValueID(\\\"6006491260550218066\\\");\\nstoredValueAccountID.setExpiryDate(\\\"1122\\\");\\npaymentInstrumentData.setStoredValueAccountID(storedValueAccountID);\\npaymentData.setPaymentInstrumentData(paymentInstrumentData);\\npaymentRequest.setPaymentData(paymentData);\\nsaleToPOIRequest.setPaymentRequest(paymentRequest);\\nterminalAPIRequest.setSaleToPOIRequest(saleToPOIRequest);\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<\/ol>\n<p>A solicita\u00e7\u00e3o de cashback \u00e9 enviada \u00e0 plataforma de pagamentos da Adyen para processamento. Depois de processada, sua integra\u00e7\u00e3o receber\u00e1 o resultado do cashback.<\/p>\n<h3>Etapa 2: recebendo o resultado do cashback<\/h3>\n<p>Depois de processada, sua integra\u00e7\u00e3o recebe uma resposta contendo o resultado do reembolso. Este \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 solicita\u00e7\u00e3o de cashback for bem-sucedida:<\/p>\n<ul>\n<li>\n<p>Voc\u00ea recebe uma resposta com um objeto <code>PaymentResponse<\/code> que inclui:<\/p>\n<ul>\n<li><code>POIData.POITransactionID.TransactionID<\/code>: <a href=\"\/pt\/point-of-sale\/design-your-integration\/terminal-api#transaction-identifier\">Identificador de transa\u00e7\u00e3o<\/a> para o cashback.<\/li>\n<li><code>PaymentReceipt<\/code>: Objeto que cont\u00e9m dados que voc\u00ea pode usar para <a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/generate-receipts\">gerar um recibo<\/a>.<\/li>\n<li><code>Response.Result<\/code>: <strong>Success<\/strong><\/li>\n<\/ul>\n<p>O exemplo abaixo indica uma solicita\u00e7\u00e3o de cashback bem-sucedida, onde <strong>GBP&nbsp;4,50<\/strong> foram removidos do saldo do cart\u00e3o presente.<\/p>\n<div class=\"notices blue\">\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>\n<pre><code class=\"language-json\">{\n    \"SaleToPOIResponse\":{\n        \"PaymentResponse\":{\n            \"POIData\":{\n                \"POITransactionID\":{\n                    \"TimeStamp\":\"2019-06-22T12:55:24.000Z\",\n                    \"TransactionID\":\"u6W7001529672124004.9815296721273135\"\n                }\n            },\n            \"SaleData\":{\n                \"SaleTransactionID\":{\n                    \"TimeStamp\":\"2019-06-22T12:55:20.000Z\",\n                    \"TransactionID\":\"44742\"\n                },\n                \"SaleReferenceID\":\"YOUR_ORDER_REFERENCE\"\n            },\n            \"PaymentReceipt\":[...],\n            \"PaymentResult\":{\n                \"PaymentAcquirerData\":{\n                    \"AcquirerPOIID\":\"V400m-324688179\",\n                    \"AcquirerTransactionID\":{\n                        \"TimeStamp\":\"2019-06-22T12:55:24.000Z\",\n                        \"TransactionID\":\"44750\"\n                    },\n                    \"MerchantID\":\"TestMerchantPOS\"\n                },\n                \"PaymentInstrumentData\":{\n                    \"StoredValueAccountID\":{\n                        \"IdentificationType\":\"PAN\",\n                        \"EntryMode\":[\n                            \"MagStripe\"\n                        ],\n                        \"StoredValueID\":\"9826150911219687\",\n                        \"StoredValueAccountType\":\"GiftCard\",\n                        \"StoredValueProvider\":\"svs\",\n                        \"ExpiryDate\":\"1122\"\n                    },\n                    \"PaymentInstrumentType\":\"StoredValue\"\n                },\n                \"AmountsResp\":{\n                    \"AuthorizedAmount\":4.50,\n                    \"Currency\":\"GBP\"\n                },\n                \"PaymentType\":\"Normal\"\n            },\n            \"Response\":{\n                \"Result\":\"Success\",\n                \"AdditionalResponse\":\"...\"\n            }\n        },\n        \"MessageHeader\":{\n            \"ProtocolVersion\":\"3.0\",\n            \"SaleID\":\"POSTerminal\",\n            \"MessageClass\":\"Service\",\n            \"MessageCategory\":\"Payment\",\n            \"ServiceID\":\"9269\",\n            \"POIID\":\"V400m-324688179\",\n            \"MessageType\":\"Response\"\n        }\n    }\n}<\/code><\/pre>\n<\/li>\n<\/ul>\n<p>A equipe da loja pode entregar os fundos retirados do cart\u00e3o ao cliente em dinheiro.<\/p>\n<h2 id=\"deactivate-gift-card\">Desativando o cart\u00e3o vale presente<\/h2>\n<p>Se o cart\u00e3o vale presente foi emitido pela Givex, voc\u00ea pode fazer uma solicitar a desativa\u00e7\u00e3o do cart\u00e3o.<\/p>\n<h3>Etapa 1: fazendo a solicita\u00e7\u00e3o de desativa\u00e7\u00e3o<\/h3>\n<p>Para desativar 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><code>POIID<\/code>: ID exclusivo do terminal. Isso indica para qual terminal a transa\u00e7\u00e3o ser\u00e1 roteada.<\/li>\n<\/ul>\n<!-- list separator -->\n<\/li>\n<li>\n<p><code>StoredValueRequest<\/code>: O corpo da solicita\u00e7\u00e3o para a solicita\u00e7\u00e3o de desativa\u00e7\u00e3o deve incluir<\/p>\n<ul>\n<li><code>SaleData.SaleTransactionID.TransactionID<\/code>: Sua refer\u00eancia exclusiva para esta solicita\u00e7\u00e3o de desativa\u00e7\u00e3o.<\/li>\n<li><code>SaleData.SaleTransactionID.TimeStamp<\/code>: Data e hora da solicita\u00e7\u00e3o de desativa\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>.<\/li>\n<li><code>StoredValueData.StoredValueTransactionType<\/code>: <strong>Unload<\/strong><\/li>\n<li>\n<p><code>StoredValueData.StoredValue.StoredValueAccountID<\/code>: Os detalhes do cart\u00e3o vale presente:<\/p>\n<ul>\n<li>\n<p><code>StoredValueAccountType<\/code>: <strong>GiftCard<\/strong><\/p>\n<\/li>\n<li>\n<p><code>StoredValueProvider<\/code>: O emissor do cart\u00e3o vale presente: <strong>givex<\/strong>, <strong>svs<\/strong>, ou <strong>valuelink<\/strong><\/p>\n<\/li>\n<li>\n<p><code>IdentificationType<\/code>: <strong>PAN<\/strong><\/p>\n<\/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;\">Leitura 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 markdown=\"1\"><code>EntryMode<\/code>: <strong>Scanned<\/strong><\/li><li markdown=\"1\"><code>StoredValueID<\/code>: N\u00famero do cart\u00e3o vale presente.<\/li><li markdown=\"1\"><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 markdown=\"1\"><code>EntryMode<\/code>: <strong>MagStripe<\/strong><\/li><li markdown=\"1\"><code>StoredValueID<\/code>: <strong>xxxxxxxxxxxxxxxxxxx<\/strong>.<\/li><li markdown=\"1\">N\u00e3o inclua o <code>ExpiryDate<\/code> par\u00e2metro.<\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<!-- list separator -->\n<\/li>\n<li>\n<p><code>ItemCount<\/code>: <strong>0<\/strong><\/p>\n<\/li>\n<li>\n<p><code>Currency<\/code>: Moeda escolhida para o cart\u00e3o vale presente.<\/p>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>O exemplo abaixo mostra como voc\u00ea solicitaria a desativa\u00e7\u00e3o de um cart\u00e3o que j\u00e1 teve suas informa\u00e7\u00f5es digitalizadas.<\/p>\n<div class=\"notices blue\">\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>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"''\" :id=\"'deactivate_0'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"JSON\",\"content\":\"{\\n  \\\"SaleToPOIRequest\\\": {\\n    \\\"MessageHeader\\\": {\\n      \\\"ProtocolVersion\\\": \\\"3.0\\\",\\n      \\\"MessageClass\\\": \\\"Service\\\",\\n      \\\"MessageCategory\\\": \\\"StoredValue\\\",\\n      \\\"MessageType\\\": \\\"Request\\\",\\n      \\\"ServiceID\\\": \\\"9270\\\",\\n      \\\"SaleID\\\": \\\"POSSystemID12345\\\",\\n      \\\"POIID\\\": \\\"P400Plus-275008713\\\"\\n    },\\n    \\\"StoredValueRequest\\\": {\\n      \\\"SaleData\\\": {\\n        \\\"SaleTransactionID\\\": {\\n          \\\"TransactionID\\\": \\\"44743\\\",\\n          \\\"TimeStamp\\\": \\\"2019-05-17T14:13:03+00:00\\\"\\n        }\\n      },\\n      \\\"StoredValueData\\\": [\\n        {\\n          \\\"StoredValueTransactionType\\\": \\\"Unload\\\",\\n          \\\"StoredValueAccountID\\\": {\\n            \\\"StoredValueAccountType\\\": \\\"GiftCard\\\",\\n            \\\"StoredValueProvider\\\": \\\"givex\\\",\\n            \\\"IdentificationType\\\": \\\"PAN\\\",\\n            \\\"EntryMode\\\": [\\n              \\\"Scanned\\\"\\n            ],\\n            \\\"StoredValueID\\\": \\\"6006491260550218066\\\",\\n            \\\"ExpiryDate\\\": \\\"1122\\\"\\n          },\\n          \\\"ItemAmount\\\": 0,\\n          \\\"Currency\\\": \\\"GBP\\\"\\n        }\\n      ]\\n    }\\n  }\\n}\"},{\"language\":\"java\",\"tabTitle\":\"Java\",\"content\":\"String serviceID = \\\"YOUR_UNIQUE_ATTEMPT_ID\\\";\\nString saleID = \\\"YOUR_CASH_REGISTER_ID\\\";\\nString POIID = \\\"YOUR_TERMINAL_ID\\\";\\nString transactionID = \\\"YOUR_UNIQUE_TRANSACTION_ID\\\";\\n\\nSaleToPOIRequest saleToPOIRequest = new SaleToPOIRequest();\\nMessageHeader messageHeader = new MessageHeader();\\nmessageHeader.setProtocolVersion(\\\"3.0\\\");\\nmessageHeader.setMessageClass( MessageClassType.SERVICE );\\nmessageHeader.setMessageCategory( MessageCategoryType.STORED_VALUE );\\nmessageHeader.setMessageType( MessageType.REQUEST );\\nmessageHeader.setServiceID(serviceID);\\nmessageHeader.setSaleID(saleID);\\nmessageHeader.setPOIID(POIID);\\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.UNLOAD );\\nStoredValueAccountID storedValueAccountID = new StoredValueAccountID();\\nstoredValueAccountID.setStoredValueAccountType( StoredValueAccountType.GIFT_CARD );\\nstoredValueAccountID.setStoredValueProvider(\\\"givex\\\");\\nstoredValueAccountID.setIdentificationType( IdentificationType.PAN );\\nstoredValueAccountID.getEntryMode().add( EntryModeType.SCANNED );\\nstoredValueAccountID.setStoredValueID(\\\"6006491260550218066\\\");\\nstoredValueAccountID.setExpiryDate(\\\"1122\\\");\\nstoredValueData.setStoredValueAccountID(storedValueAccountID);\\nstoredValueData.setItemAmount( BigDecimal.valueOf(0) );\\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 desativa\u00e7\u00e3o \u00e9 enviada \u00e0 plataforma de pagamentos da Adyen para processamento. Depois de processada, sua integra\u00e7\u00e3o receber\u00e1 uma resposta indicando se o cart\u00e3o vale presente foi desativado.<\/p>\n<h3>Etapa 2: Recebendo resposta de desativa\u00e7\u00e3o<\/h3>\n<p>Depois de processada, sua integra\u00e7\u00e3o recebe uma resposta contendo o resultado da solicita\u00e7\u00e3o. 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 o cart\u00e3o estiver desativado:<\/p>\n<ul>\n<li>\n<p>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 de transa\u00e7\u00e3o <\/a> for the deactivation.<\/p>\n<\/li>\n<li>\n<p><code>StoredValueResult<\/code><\/p>\n<ul>\n<li><code>StoredValueTransactionType<\/code>: <strong>Unload<\/strong><\/li>\n<li>\n<p><code>StoredValueAccountStatus.CurrentBalance<\/code>: Saldo atual no cart\u00e3o vale presente, que \u00e9 <strong>0<\/strong> porque o cart\u00e3o foi desativado.<\/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 a solicita\u00e7\u00e3o de desativa\u00e7\u00e3o foi bem-sucedida e o cart\u00e3o <strong>6006491260550218157<\/strong> foi desativado. Agora este cart\u00e3o tem um saldo de <strong>GBP&nbsp;0<\/strong>.<\/p>\n<div class=\"notices blue\">\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>\n<pre><code class=\"language-json\">{\n  \"SaleToPOIResponse\":{\n    \"StoredValueResponse\":{\n      \"POIData\":{\n        \"POITransactionID\":{\n          \"TimeStamp\":\"2019-05-17T14:13:03.000Z\",\n          \"TransactionID\":\"oLkO001526566383000.9815265664093834\"\n        }\n      },\n      ...\n      \"StoredValueResult\":[\n        {\n          \"StoredValueTransactionType\":\"Unload\",\n          \"ItemAmount\":0,\n          \"StoredValueAccountStatus\":{\n            \"StoredValueAccountID\":{\n              \"IdentificationType\":\"PAN\",\n              \"EntryMode\":[\n                \"MagStripe\"\n              ],\n              \"StoredValueID\":\"6006491260550218157\",\n              \"StoredValueAccountType\":\"GiftCard\",\n              \"ExpiryDate\":\"1122\"\n            },\n            \"CurrentBalance\":0\n          },\n          \"Currency\":\"GBP\"\n        }\n      ],\n      \"Response\":{\n        \"Result\":\"Success\",\n        \"AdditionalResponse\":\"...\"\n      }\n    },\n    \"MessageHeader\":{\n      \"ProtocolVersion\":\"3.0\",\n      \"SaleID\":\"POSSystemID12345\",\n      \"MessageClass\":\"Service\",\n      \"MessageCategory\":\"StoredValue\",\n      \"ServiceID\":\"9270\",\n      \"POIID\":\"V400m-324688179\",\n      \"MessageType\":\"Response\"\n    }\n  }\n}<\/code><\/pre>\n<h2 id=\"see-also\">See also<\/h2>\n<\/li>\n<\/ul>\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\/activate\"\n                        target=\"_self\"\n                        >\n                    Ative um cart\u00e3o vale presente\n                <\/a><\/li><li><a href=\"\/point-of-sale\/what-we-support\/payment-methods\/gift-cards-terminal-api\/payment\"\n                        target=\"_self\"\n                        >\n                     Efetue um pagamento com um cart\u00e3o vale presente ativado\n                <\/a><\/li><li><a href=\"\/point-of-sale\/what-we-support\/payment-methods\/gift-cards-terminal-api\/query-the-balance\"\n                        target=\"_self\"\n                        >\n                    Verifique o saldo existente em um cart\u00e3o vale presente\n                <\/a><\/li><li><a href=\"\/point-of-sale\/what-we-support\/payment-methods\/gift-cards-terminal-api\/load-a-balance\"\n                        target=\"_self\"\n                        >\n                    Carregar um cart\u00e3o vale presente com cr\u00e9dito adicional\n                <\/a><\/li><li><a href=\"\/point-of-sale\/what-we-support\/payment-methods\/gift-cards-terminal-api\/refund-gift-cards\"\n                        target=\"_self\"\n                        >\n                    Fa\u00e7a 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                    Desative ou saque 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\/deactivate","articleFields":{"description":"Desative ou saque o saldo existente de um cart\u00e3o vale presente em seu terminal.","id":"39949870","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"04-06-2020 17:41"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/alternative-payment-methods\/gift-cards-terminal-api\/deactivate","title":"Desativar ou sacar o saldo do cart\u00e3o vale presente","content":"Quando o saldo de um cart\u00e3o vale presente estiver abaixo de um determinado valor ou quando houver suspeita de fraude, conv\u00e9m interromper o uso do cart\u00e3o. Neste caso, voc\u00ea pode:\n\nFazer um pedido de cashback para retirar fundos do cart\u00e3o vale presente e devolver a quantia ao cliente em dinheiro. Se voc\u00ea sacar o saldo total, o cart\u00e3o n\u00e3o estar\u00e1 mais ativo e n\u00e3o poder\u00e1 ser usado novamente.\n\u2022 Fa\u00e7a uma solicita\u00e7\u00e3o de desativa\u00e7\u00e3o para desativar o cart\u00e3o sem realizar o saque do valor total. Voc\u00ea s\u00f3 pode fazer isso em cart\u00e3o vale presente fornecidos pela Givex.\n\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.\nAdicionado o m\u00e9todo de pagamento escolhido \u00e0 sua conta Adyen .\n\nCashback para um cart\u00e3o vale presente\nSuas op\u00e7\u00f5es com uma solicita\u00e7\u00e3o de cashback dependem do fornecedor do cart\u00e3o vale presente, das regras da bandeira e da lei aplic\u00e1vel. Se os cashbacks forem permitidos, normalmente voc\u00ea poder\u00e1 sacar apenas o valor total restante no cart\u00e3o. Mas se ocart\u00e3o vale presente foi fornecido pela Givex, \u00e9 poss\u00edvel, em alguns casos, dar o cashback de um valor parcial.\n\n\nOs fundos retirados do cart\u00e3o vale presente podem ser devolvidos ao cliente em dinheiro ou transferidos para seu cart\u00e3o de cr\u00e9dito ou d\u00e9bito, mediante um cashback n\u00e3o referenciado.\nEtapa 1: realizando uma solicita\u00e7\u00e3o de cashback\nPara reembolsar um cart\u00e3o vale presente:\n\nVerifique o saldo restante no cart\u00e3o vale presente.\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: Payment\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\nPOIID: ID exclusivo do terminal. Isso indica para qual terminal a transa\u00e7\u00e3o ser\u00e1 roteada.\n\n\n\n\nPaymentRequest: O corpo da solicita\u00e7\u00e3o para a solicita\u00e7\u00e3o de cashback deve incluir:\n\nSaleData.SaleTransactionID.TimeStamp: Data e hora da solicita\u00e7\u00e3o de cashback, no formato UTC.\nSaleData.SaleTransactionID.TransactionID: Sua refer\u00eancia exclusiva para esta solicita\u00e7\u00e3o de cashback.\nSaleData.SaleReferenceID: Par\u00e2metro opcional para fornecer o n\u00famero do seu pedido. Voc\u00ea pode usar isso para conectar transa\u00e7\u00f5es de diferentes cart\u00e3o vale presente ao mesmo pedido. Em sua Customer Area, este aparecer\u00e1 como Merchant Order para a transa\u00e7\u00e3o.\nSaleData.SaleToAcquirerData: redemptionType=cashback\nPaymentTransaction.AmountsReq: A Currency e o RequestedAmount que ser\u00e3o devolvidos ao cliente. Para sacar o valor total, voc\u00ea pode especificar esse valor exato ou especificar um valor zero (0).\nPaymentData.PaymentType: Normal\nPaymentData.PaymentInstrumentData.PaymentInstrumentType: StoredValue\n\nPaymentData.PaymentInstrumentData.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\nLeitura 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 presente.\n\n\nSwipe or MKE\nEntryMode: MagStripeStoredValueID: xxxxxxxxxxxxxxxxxxx.N\u00e3o inclua o ExpiryDate par\u00e2metro.\n\n\n\n\n\n\n\n\n\nO exemplo abaixo mostra como voc\u00ea iniciaria uma solicita\u00e7\u00e3o de cashback de GBP&nbsp;4,50 para um cart\u00e3o vale presente que j\u00e1 teve suas informa\u00e7\u00f5es digitalizadas.\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 cashback \u00e9 enviada \u00e0 plataforma de pagamentos da Adyen para processamento. Depois de processada, sua integra\u00e7\u00e3o receber\u00e1 o resultado do cashback.\nEtapa 2: recebendo o resultado do cashback\nDepois de processada, sua integra\u00e7\u00e3o recebe uma resposta contendo o resultado do reembolso. Este \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 solicita\u00e7\u00e3o de cashback for bem-sucedida:\n\n\nVoc\u00ea recebe uma resposta com um objeto PaymentResponse que inclui:\n\nPOIData.POITransactionID.TransactionID: Identificador de transa\u00e7\u00e3o para o cashback.\nPaymentReceipt: Objeto que cont\u00e9m dados que voc\u00ea pode usar para gerar um recibo.\nResponse.Result: Success\n\nO exemplo abaixo indica uma solicita\u00e7\u00e3o de cashback bem-sucedida, onde GBP&nbsp;4,50 foram removidos do saldo do cart\u00e3o presente.\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    \"SaleToPOIResponse\":{\n        \"PaymentResponse\":{\n            \"POIData\":{\n                \"POITransactionID\":{\n                    \"TimeStamp\":\"2019-06-22T12:55:24.000Z\",\n                    \"TransactionID\":\"u6W7001529672124004.9815296721273135\"\n                }\n            },\n            \"SaleData\":{\n                \"SaleTransactionID\":{\n                    \"TimeStamp\":\"2019-06-22T12:55:20.000Z\",\n                    \"TransactionID\":\"44742\"\n                },\n                \"SaleReferenceID\":\"YOUR_ORDER_REFERENCE\"\n            },\n            \"PaymentReceipt\":[...],\n            \"PaymentResult\":{\n                \"PaymentAcquirerData\":{\n                    \"AcquirerPOIID\":\"V400m-324688179\",\n                    \"AcquirerTransactionID\":{\n                        \"TimeStamp\":\"2019-06-22T12:55:24.000Z\",\n                        \"TransactionID\":\"44750\"\n                    },\n                    \"MerchantID\":\"TestMerchantPOS\"\n                },\n                \"PaymentInstrumentData\":{\n                    \"StoredValueAccountID\":{\n                        \"IdentificationType\":\"PAN\",\n                        \"EntryMode\":[\n                            \"MagStripe\"\n                        ],\n                        \"StoredValueID\":\"9826150911219687\",\n                        \"StoredValueAccountType\":\"GiftCard\",\n                        \"StoredValueProvider\":\"svs\",\n                        \"ExpiryDate\":\"1122\"\n                    },\n                    \"PaymentInstrumentType\":\"StoredValue\"\n                },\n                \"AmountsResp\":{\n                    \"AuthorizedAmount\":4.50,\n                    \"Currency\":\"GBP\"\n                },\n                \"PaymentType\":\"Normal\"\n            },\n            \"Response\":{\n                \"Result\":\"Success\",\n                \"AdditionalResponse\":\"...\"\n            }\n        },\n        \"MessageHeader\":{\n            \"ProtocolVersion\":\"3.0\",\n            \"SaleID\":\"POSTerminal\",\n            \"MessageClass\":\"Service\",\n            \"MessageCategory\":\"Payment\",\n            \"ServiceID\":\"9269\",\n            \"POIID\":\"V400m-324688179\",\n            \"MessageType\":\"Response\"\n        }\n    }\n}\n\n\nA equipe da loja pode entregar os fundos retirados do cart\u00e3o ao cliente em dinheiro.\nDesativando o cart\u00e3o vale presente\nSe o cart\u00e3o vale presente foi emitido pela Givex, voc\u00ea pode fazer uma solicitar a desativa\u00e7\u00e3o do cart\u00e3o.\nEtapa 1: fazendo a solicita\u00e7\u00e3o de desativa\u00e7\u00e3o\nPara desativar 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\nPOIID: ID exclusivo do terminal. Isso indica para qual terminal a transa\u00e7\u00e3o ser\u00e1 roteada.\n\n\n\n\nStoredValueRequest: O corpo da solicita\u00e7\u00e3o para a solicita\u00e7\u00e3o de desativa\u00e7\u00e3o deve incluir\n\nSaleData.SaleTransactionID.TransactionID: Sua refer\u00eancia exclusiva para esta solicita\u00e7\u00e3o de desativa\u00e7\u00e3o.\nSaleData.SaleTransactionID.TimeStamp: Data e hora da solicita\u00e7\u00e3o de desativa\u00e7\u00e3o, no formato UTC.\nStoredValueData.StoredValueTransactionType: Unload\n\nStoredValueData.StoredValue.StoredValueAccountID: Os detalhes do cart\u00e3o vale presente:\n\n\nStoredValueAccountType: GiftCard\n\n\nStoredValueProvider: O emissor do cart\u00e3o vale presente: givex, svs, ou valuelink\n\n\nIdentificationType: PAN\n\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\nLeitura 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\nItemCount: 0\n\n\nCurrency: Moeda escolhida para o cart\u00e3o vale presente.\n\n\n\n\n\n\nO exemplo abaixo mostra como voc\u00ea solicitaria a desativa\u00e7\u00e3o de um cart\u00e3o que j\u00e1 teve suas informa\u00e7\u00f5es digitalizadas.\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 desativa\u00e7\u00e3o \u00e9 enviada \u00e0 plataforma de pagamentos da Adyen para processamento. Depois de processada, sua integra\u00e7\u00e3o receber\u00e1 uma resposta indicando se o cart\u00e3o vale presente foi desativado.\nEtapa 2: Recebendo resposta de desativa\u00e7\u00e3o\nDepois de processada, sua integra\u00e7\u00e3o recebe uma resposta contendo o resultado da solicita\u00e7\u00e3o. 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 o cart\u00e3o estiver desativado:\n\n\nVoc\u00ea receber\u00e1 uma resposta com um objeto StoredValueResponse que inclui:\n\n\nPOIData.POITransactionID.TransactionID: Identificador de transa\u00e7\u00e3o  for the deactivation.\n\n\nStoredValueResult\n\nStoredValueTransactionType: Unload\n\nStoredValueAccountStatus.CurrentBalance: Saldo atual no cart\u00e3o vale presente, que \u00e9 0 porque o cart\u00e3o foi desativado.\n\n\n\n\n\nResponse.Result: Success\n\n\nO exemplo abaixo indica que a solicita\u00e7\u00e3o de desativa\u00e7\u00e3o foi bem-sucedida e o cart\u00e3o 6006491260550218157 foi desativado. Agora este cart\u00e3o tem um saldo de GBP&nbsp;0.\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  \"SaleToPOIResponse\":{\n    \"StoredValueResponse\":{\n      \"POIData\":{\n        \"POITransactionID\":{\n          \"TimeStamp\":\"2019-05-17T14:13:03.000Z\",\n          \"TransactionID\":\"oLkO001526566383000.9815265664093834\"\n        }\n      },\n      ...\n      \"StoredValueResult\":[\n        {\n          \"StoredValueTransactionType\":\"Unload\",\n          \"ItemAmount\":0,\n          \"StoredValueAccountStatus\":{\n            \"StoredValueAccountID\":{\n              \"IdentificationType\":\"PAN\",\n              \"EntryMode\":[\n                \"MagStripe\"\n              ],\n              \"StoredValueID\":\"6006491260550218157\",\n              \"StoredValueAccountType\":\"GiftCard\",\n              \"ExpiryDate\":\"1122\"\n            },\n            \"CurrentBalance\":0\n          },\n          \"Currency\":\"GBP\"\n        }\n      ],\n      \"Response\":{\n        \"Result\":\"Success\",\n        \"AdditionalResponse\":\"...\"\n      }\n    },\n    \"MessageHeader\":{\n      \"ProtocolVersion\":\"3.0\",\n      \"SaleID\":\"POSSystemID12345\",\n      \"MessageClass\":\"Service\",\n      \"MessageCategory\":\"StoredValue\",\n      \"ServiceID\":\"9270\",\n      \"POIID\":\"V400m-324688179\",\n      \"MessageType\":\"Response\"\n    }\n  }\n}\nSee also\n\n\n\n\n                    Ative um cart\u00e3o vale presente\n                \n                     Efetue um pagamento com um cart\u00e3o vale presente ativado\n                \n                    Verifique o saldo existente em um cart\u00e3o vale presente\n                \n                    Carregar um cart\u00e3o vale presente com cr\u00e9dito adicional\n                \n                    Fa\u00e7a um reembolso n\u00e3o referenciado para um cart\u00e3o vale presente\n                \n                    Desative ou saque 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":"Desativar ou sacar o saldo do 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\/deactivate"},"levels":5,"category":"In-person payments","category_color":"green","tags":["Desativar","sacar","saldo","cart\u00e3o","presente"]},"articleFiles":{"cashback-and-cash-out-gift-cards_0.json":"<p alt=\"\">cashback-and-cash-out-gift-cards_0.json<\/p>","deactivate_0.json":"<p alt=\"\">deactivate_0.json<\/p>"}}
