{"title":"Reembolsar um cart\u00e3o vale presente","category":"default","creationDate":1776961627,"content":"<p>Se voc\u00ea quiser devolver fundos ao cart\u00e3o vale presente de um cliente, voc\u00ea poder\u00e1 fazer uma solicita\u00e7\u00e3o de revers\u00e3o ou reembolso:<\/p>\n<ul>\n<li>\n<p><strong>Estorno<\/strong>: Se voc\u00ea quiser estornar um pagamento feito com o cart\u00e3o vale presente, fa\u00e7a uma solicita\u00e7\u00e3o de estorno com refer\u00eancia ao pagamento original. \u00c9 o que chamamos de \"reembolso referenciado\" e \u00e9 descrito em <a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/refund-payment#referenced-refund\">Reembolsar um pagamento<\/a>. Voc\u00ea tamb\u00e9m pode fazer (m\u00faltiplos) reembolsos parciais usando solicita\u00e7\u00f5es de estorno.<\/p>\n<\/li>\n<li>\n<p><strong>Reembolso<\/strong>: Se voc\u00ea n\u00e3o puder vincular o reembolso a um pagamento feito com o cart\u00e3o vale presente, por exemplo, no caso de uma \"devolu\u00e7\u00e3o de mercadoria\" , quando o cliente devolver um presente indesejado, fa\u00e7a uma solicita\u00e7\u00e3o de reembolso. \u00c9 o que descrevemos aqui nesta p\u00e1gina.<\/p>\n<\/li>\n<\/ul>\n<p>Quando a solicita\u00e7\u00e3o foi processada, voc\u00ea receber\u00e1 um resultado indicando se o reembolso foi bem sucedido.<\/p>\n<div class=\"notices yellow\">\n<p>Se voc\u00ea quiser devolver o saldo de um cart\u00e3o vale presente a um cliente em dinheiro, voc\u00ea dever\u00e1 realizar uma <a href=\"\/pt\/point-of-sale\/what-we-support\/payment-methods\/gift-cards-terminal-api\/deactivate#cashing-back-gift-card\">solicita\u00e7\u00e3o de cashback<\/a> .<\/p>\n<\/div>\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<\/ul>\n<h2>Etapa 1: fa\u00e7a uma solicita\u00e7\u00e3o de reembolso<\/h2>\n<p>Para emitir um reembolso para 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>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 reembolso deve incluir:<\/p>\n<ul>\n<li><code>SaleData.SaleTransactionID.TransactionID<\/code>: Sua refer\u00eancia exclusiva para esta solicita\u00e7\u00e3o de reembolso.<\/li>\n<li><code>SaleData.SaleTransactionID.TimeStamp<\/code>: Data e hora da solicita\u00e7\u00e3o de pagamento, 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.SaleReferenceID<\/code>: Sua refer\u00eancia ao pedido pelo qual voc\u00ea deseja fazer um reembolso. Na <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 o <strong>Merchant Order<\/strong> para a transa\u00e7\u00e3o.<\/li>\n<li><code>PaymentTransaction.AmountsReq<\/code>: The <code>Currency<\/code> e <code>RequestedAmount<\/code> sendo reembolsados no cart\u00e3o vale presente.<\/li>\n<li><code>PaymentData.PaymentType<\/code>: <strong>Refund<\/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 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<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>O exemplo abaixo mostra como voc\u00ea emitiria um reembolso de <strong>GBP&nbsp;30,00<\/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=\"'refund-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\\\":\\\"9268\\\",\\n            \\\"SaleID\\\":\\\"POSSystem\\\",\\n            \\\"POIID\\\":\\\"V400m-324688179\\\"\\n        },\\n        \\\"PaymentRequest\\\":{\\n            \\\"SaleData\\\":{\\n                \\\"SaleTransactionID\\\":{\\n                    \\\"TransactionID\\\":\\\"44741\\\",\\n                    \\\"TimeStamp\\\":\\\"2019-06-22T12:20:27+00:00\\\"\\n                },\\n                \\\"SaleReferenceID\\\":\\\"YOUR_ORDER_REFERENCE\\\"\\n            },\\n            \\\"PaymentTransaction\\\":{\\n                \\\"AmountsReq\\\":{\\n                    \\\"Currency\\\":\\\"GBP\\\",\\n                    \\\"RequestedAmount\\\":30\\n                }\\n            },\\n            \\\"PaymentData\\\":{\\n                \\\"PaymentType\\\":\\\"Refund\\\",\\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\\\");\\npaymentRequest.setSaleData(saleData);\\n\\nPaymentTransaction paymentTransaction = new PaymentTransaction();\\nAmountsReq amountsReq = new AmountsReq();\\namountsReq.setCurrency(\\\"GBP\\\");\\namountsReq.setRequestedAmount( BigDecimal.valueOf(30) );\\npaymentTransaction.setAmountsReq(amountsReq);\\npaymentRequest.setPaymentTransaction(paymentTransaction);\\n\\nPaymentData paymentData = new PaymentData();\\npaymentData.setPaymentType( PaymentType.REFUND );\\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<\/ul>\n<p>A solicita\u00e7\u00e3o de reembolso \u00e9 enviada \u00e0 plataforma de pagamentos da Adyen para processamento.<\/p>\n<h2>Etapa 2: recebendo o resultado do reembolso<\/h2>\n<p>Depois de processada, sua integra\u00e7\u00e3o recebe 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 reembolso 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 reembolso.<\/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 que o reembolso de <strong>GBP&nbsp;30,00<\/strong> foi emitido com sucesso para o cart\u00e3o vale 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:20:31.000Z\",\n                    \"TransactionID\":\"u6W7001529670031000.9815296700362966\"\n                }\n            },\n            \"SaleData\":{\n                \"SaleTransactionID\":{\n                    \"TimeStamp\":\"2019-06-22T12:20:27.000Z\",\n                    \"TransactionID\":\"44741\"\n                },\n                \"SaleReferenceID\":\"SalesRefABC\"\n            },\n            \"PaymentReceipt\":[...],\n            \"PaymentResult\":{\n                \"PaymentAcquirerData\":{\n                    \"AcquirerPOIID\":\"V400m-324688179\",\n                    \"AcquirerTransactionID\":{\n                        \"TimeStamp\":\"2019-06-22T12:20:31.000Z\",\n                        \"TransactionID\":\"9815296700362966\"\n                    },\n                    \"MerchantID\":\"TestMerchantPOS\"\n                },\n                \"PaymentInstrumentData\":{\n                    \"StoredValueAccountID\":{\n                        \"IdentificationType\":\"PAN\",\n                        \"EntryMode\":[\n                            \"MagStripe\"\n                        ],\n                        \"StoredValueID\":\"603628173862001915498\",\n                        \"StoredValueAccountType\":\"GiftCard\",\n                        \"StoredValueProvider\":\"givex\",\n                        \"ExpiryDate\":\"1249\"\n                    },\n                    \"PaymentInstrumentType\":\"StoredValue\"\n                },\n                \"AmountsResp\":{\n                    \"AuthorizedAmount\":30.00,\n                    \"Currency\":\"GBP\"\n                },\n                \"PaymentType\":\"Refund\"\n            },\n            \"Response\":{\n                \"Result\":\"Success\",\n                \"AdditionalResponse\":\"...\"\n            }\n        },\n        \"MessageHeader\":{\n            \"ProtocolVersion\":\"3.0\",\n            \"SaleID\":\"POSSystem\",\n            \"MessageClass\":\"Service\",\n            \"MessageCategory\":\"Payment\",\n            \"ServiceID\":\"9268\",\n            \"POIID\":\"V400m-324688179\",\n            \"MessageType\":\"Response\"\n        }\n    }\n}<\/code><\/pre>\n<\/li>\n<\/ul>\n<h2>Pr\u00f3ximos passos<\/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\">Realizar um pagamento com cart\u00e3o vale presente<\/h6><p>Fa\u00e7a um pagamento com um cart\u00e3o vale presente ativo.<\/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\">Verificar o saldo do cart\u00e3o vale presente<\/h6><p>Verifique o saldo existente em um cart\u00e3o vale presente.<\/p><\/div><\/p><\/a><a href=\"\/point-of-sale\/what-we-support\/payment-methods\/gift-cards-terminal-api\/deactivate\" class=\"next-steps__step\" style=\"width:29%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Desativar ou realizar um saque<\/h6><p>Desative ou saque o saldo existente em um cart\u00e3o vale presente.<\/p><\/div><\/p><\/a><\/div>\n\n<h2 id=\"see-also\">See also<\/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\/activate\"\n                        target=\"_self\"\n                        >\n                    Ativar 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 cr\u00e9dito adicional no 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\/refund-gift-cards","articleFields":{"description":"Fa\u00e7a um reembolso n\u00e3o referenciado para um cart\u00e3o vale presente em seu terminal.","id":"39952811","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"06-04-2020 20:45"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/alternative-payment-methods\/gift-cards-terminal-api\/refund-gift-cards","title":"Reembolsar um cart\u00e3o vale presente","content":"Se voc\u00ea quiser devolver fundos ao cart\u00e3o vale presente de um cliente, voc\u00ea poder\u00e1 fazer uma solicita\u00e7\u00e3o de revers\u00e3o ou reembolso:\n\n\nEstorno: Se voc\u00ea quiser estornar um pagamento feito com o cart\u00e3o vale presente, fa\u00e7a uma solicita\u00e7\u00e3o de estorno com refer\u00eancia ao pagamento original. \u00c9 o que chamamos de \"reembolso referenciado\" e \u00e9 descrito em Reembolsar um pagamento. Voc\u00ea tamb\u00e9m pode fazer (m\u00faltiplos) reembolsos parciais usando solicita\u00e7\u00f5es de estorno.\n\n\nReembolso: Se voc\u00ea n\u00e3o puder vincular o reembolso a um pagamento feito com o cart\u00e3o vale presente, por exemplo, no caso de uma \"devolu\u00e7\u00e3o de mercadoria\" , quando o cliente devolver um presente indesejado, fa\u00e7a uma solicita\u00e7\u00e3o de reembolso. \u00c9 o que descrevemos aqui nesta p\u00e1gina.\n\n\nQuando a solicita\u00e7\u00e3o foi processada, voc\u00ea receber\u00e1 um resultado indicando se o reembolso foi bem sucedido.\n\nSe voc\u00ea quiser devolver o saldo de um cart\u00e3o vale presente a um cliente em dinheiro, voc\u00ea dever\u00e1 realizar uma solicita\u00e7\u00e3o de cashback .\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\nEtapa 1: fa\u00e7a uma solicita\u00e7\u00e3o de reembolso\nPara emitir um reembolso para 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: 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 reembolso deve incluir:\n\nSaleData.SaleTransactionID.TransactionID: Sua refer\u00eancia exclusiva para esta solicita\u00e7\u00e3o de reembolso.\nSaleData.SaleTransactionID.TimeStamp: Data e hora da solicita\u00e7\u00e3o de pagamento, no formato UTC.\nSaleData.SaleReferenceID: Sua refer\u00eancia ao pedido pelo qual voc\u00ea deseja fazer um reembolso. Na Customer Area, este aparecer\u00e1 como o Merchant Order para a transa\u00e7\u00e3o.\nPaymentTransaction.AmountsReq: The Currency e RequestedAmount sendo reembolsados no cart\u00e3o vale presente.\nPaymentData.PaymentType: Refund\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 vale 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 emitiria um reembolso de GBP&nbsp;30,00 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 reembolso \u00e9 enviada \u00e0 plataforma de pagamentos da Adyen para processamento.\nEtapa 2: recebendo o resultado do reembolso\nDepois de processada, sua integra\u00e7\u00e3o recebe 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 reembolso 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 reembolso.\nPaymentReceipt: Objeto que cont\u00e9m dados que voc\u00ea pode usar para gerar um recibo.\nResponse.Result: Success\n\nO exemplo abaixo indica que o reembolso de GBP&nbsp;30,00 foi emitido com sucesso para o cart\u00e3o vale 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:20:31.000Z\",\n                    \"TransactionID\":\"u6W7001529670031000.9815296700362966\"\n                }\n            },\n            \"SaleData\":{\n                \"SaleTransactionID\":{\n                    \"TimeStamp\":\"2019-06-22T12:20:27.000Z\",\n                    \"TransactionID\":\"44741\"\n                },\n                \"SaleReferenceID\":\"SalesRefABC\"\n            },\n            \"PaymentReceipt\":[...],\n            \"PaymentResult\":{\n                \"PaymentAcquirerData\":{\n                    \"AcquirerPOIID\":\"V400m-324688179\",\n                    \"AcquirerTransactionID\":{\n                        \"TimeStamp\":\"2019-06-22T12:20:31.000Z\",\n                        \"TransactionID\":\"9815296700362966\"\n                    },\n                    \"MerchantID\":\"TestMerchantPOS\"\n                },\n                \"PaymentInstrumentData\":{\n                    \"StoredValueAccountID\":{\n                        \"IdentificationType\":\"PAN\",\n                        \"EntryMode\":[\n                            \"MagStripe\"\n                        ],\n                        \"StoredValueID\":\"603628173862001915498\",\n                        \"StoredValueAccountType\":\"GiftCard\",\n                        \"StoredValueProvider\":\"givex\",\n                        \"ExpiryDate\":\"1249\"\n                    },\n                    \"PaymentInstrumentType\":\"StoredValue\"\n                },\n                \"AmountsResp\":{\n                    \"AuthorizedAmount\":30.00,\n                    \"Currency\":\"GBP\"\n                },\n                \"PaymentType\":\"Refund\"\n            },\n            \"Response\":{\n                \"Result\":\"Success\",\n                \"AdditionalResponse\":\"...\"\n            }\n        },\n        \"MessageHeader\":{\n            \"ProtocolVersion\":\"3.0\",\n            \"SaleID\":\"POSSystem\",\n            \"MessageClass\":\"Service\",\n            \"MessageCategory\":\"Payment\",\n            \"ServiceID\":\"9268\",\n            \"POIID\":\"V400m-324688179\",\n            \"MessageType\":\"Response\"\n        }\n    }\n}\n\n\nPr\u00f3ximos passos\n\nRealizar um pagamento com cart\u00e3o vale presenteFa\u00e7a um pagamento com um cart\u00e3o vale presente ativo.Verificar o saldo do cart\u00e3o vale presenteVerifique o saldo existente em um cart\u00e3o vale presente.Desativar ou realizar um saqueDesative ou saque o saldo existente em um cart\u00e3o vale presente.\n\nSee also\n\n\n                    Ativar um cart\u00e3o vale presente\n                \n                    Carregar cr\u00e9dito adicional no 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":"Reembolsar 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\/refund-gift-cards"},"levels":5,"category":"In-person payments","category_color":"green","tags":["Reembolsar","cart\u00e3o","presente"]},"articleFiles":{"refund-gift-cards_0.json":"<p alt=\"\">refund-gift-cards_0.json<\/p>"}}
