{"title":"Realizar pagamentos com cart\u00e3o vale presente","category":"default","creationDate":1776961627,"content":"<p>Depois de ativar um <a href=\"\/pt\/point-of-sale\/what-we-support\/payment-methods\/gift-cards-terminal-api\/activate\">cart\u00e3o vale presente<\/a>, voc\u00ea poder\u00e1 efetuar pagamentos com o cart\u00e3o.<\/p>\n<p>Efetuar um pagamento com cart\u00e3o vale presente \u00e9 semelhante a um <a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/make-a-payment\">pagamento com cart\u00e3o de cr\u00e9dito ou d\u00e9bito<\/a>, mas voc\u00ea precisar\u00e1 fornecer alguns detalhes adicionais relacionados ao cart\u00e3o vale presente. Voc\u00ea pode coletar essas informa\u00e7\u00f5es fazendo a leitura do cart\u00e3o vale presente ou inserindo as informa\u00e7\u00f5es manualmente em sua caixa registradora ou terminal. Quando essa solicita\u00e7\u00e3o de pagamento for processada, voc\u00ea receber\u00e1 o resultado do pagamento.<br \/>\nSe o saldo do cart\u00e3o vale presente n\u00e3o cobrir o valor integral do pagamento, voc\u00ea poder\u00e1 fazer pagamentos parciais.<\/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\">Adicionado o m\u00e9todo de pagamento escolhido \u00e0 sua conta Adyen <\/a>.<\/li>\n<\/ul>\n<h2 id=\"make-payment-request\">Etapa 1: fa\u00e7a a solicita\u00e7\u00e3o de pagamento<\/h2>\n<p>Para iniciar um pagamento com 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 enviada para a solicita\u00e7\u00e3o de pagamento deve incluir:<\/p>\n<ul>\n<li><code>SaleData.SaleTransactionID.TransactionID<\/code>: Sua refer\u00eancia exclusiva para esta solicita\u00e7\u00e3o.<\/li>\n<li><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>.<\/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 diferentes de um cart\u00e3o vale presente no mesmo pedido. 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 <strong>Merchant Order<\/strong> para a transa\u00e7\u00e3o.<\/li>\n<li><code>PaymentTransaction.AmountsReq.Currency<\/code>: A <a href=\"\/pt\/development-resources\/currency-codes\">moeda<\/a> escolhdia para a transa\u00e7\u00e3o.<\/li>\n<li><code>PaymentTransaction.AmountsReq.RequestedAmount<\/code>: O valor da transa\u00e7\u00e3o.<\/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;\">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 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 iniciaria um pagamento de <strong>GBP&nbsp;10,99<\/strong> com 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=\"'payment_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\\\":\\\"9267\\\",\\n            \\\"SaleID\\\":\\\"POSSystemID12345\\\",\\n            \\\"POIID\\\":\\\"V400m-324688179\\\"\\n        },\\n        \\\"PaymentRequest\\\":{\\n            \\\"SaleData\\\":{\\n                \\\"SaleTransactionID\\\":{\\n                    \\\"TransactionID\\\":\\\"44740\\\",\\n                    \\\"TimeStamp\\\":\\\"2019-03-26T09:13:41+00:00\\\"\\n                },\\n                \\\"SaleReferenceID\\\":\\\"Order12345-1\\\",\\n                \\\"SaleToAcquirerData\\\":\\\"tenderOption=AllowPartialAuthorisation\\\"\\n            },\\n            \\\"PaymentTransaction\\\":{\\n                \\\"AmountsReq\\\":{\\n                    \\\"Currency\\\":\\\"EUR\\\",\\n                    \\\"RequestedAmount\\\":25.99\\n                }\\n            },\\n            \\\"PaymentData\\\":{\\n                \\\"PaymentInstrumentData\\\":{\\n                    \\\"PaymentInstrumentType\\\":\\\"StoredValue\\\",\\n                    \\\"StoredValueAccountID\\\":{\\n                        \\\"StoredValueAccountType\\\":\\\"GiftCard\\\",\\n                        \\\"StoredValueProvider\\\":\\\"svs\\\",\\n                        \\\"IdentificationType\\\":\\\"PAN\\\",\\n                        \\\"EntryMode\\\":[\\n                            \\\"Scanned\\\"\\n                        ],\\n                        \\\"StoredValueID\\\":\\\"9826150911219687\\\",\\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);\\npaymentRequest.setSaleData(saleData);\\n\\nPaymentTransaction paymentTransaction = new PaymentTransaction();\\nAmountsReq amountsReq = new AmountsReq();\\namountsReq.setCurrency(\\\"GBP\\\");\\namountsReq.setRequestedAmount( BigDecimal.valueOf(100.99) );\\npaymentTransaction.setAmountsReq(amountsReq);\\npaymentRequest.setPaymentTransaction(paymentTransaction);\\nPaymentData paymentData = new PaymentData();\\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 pagamento \u00e9 enviada \u00e0 plataforma de pagamentos da Adyen para processamento.<\/p>\n<h2 id=\"make-payment-result\">Etapa 2: recebendo o resultado do pagamento<\/h2>\n<p>Depois de processada, sua integra\u00e7\u00e3o recebe o resultado do pagamento. 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 pagamento com cart\u00e3o vale presente for bem-sucedido:<\/p>\n<ul>\n<li><strong>Approved<\/strong> ser\u00e1 exibido na tela do terminal.<\/li>\n<li>\n<p>Voc\u00ea recebe uma resposta que cont\u00e9m um objeto <code>PaymentResponse<\/code>. Isso 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> 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>PaymentResponse.Response.Result<\/code>: <strong>Success<\/strong><\/li>\n<\/ul>\n<p>O exemplo abaixo indica que o pagamento com cart\u00e3o vale presente foi bem-sucedido.<\/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#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-03-26T09:22:16.000Z\",\n                    \"TransactionID\":\"oLkO001522056136000.9815220561432452\"\n                }\n            },\n            \"SaleData\":{\n                \"SaleTransactionID\":{\n                    \"TimeStamp\":\"2019-03-26T09:22:21.000Z\",\n                    \"TransactionID\":\"44740\"\n                }\n            },\n            \"PaymentReceipt\":[...],\n            \"PaymentResult\":{\n                \"PaymentAcquirerData\":{\n                    \"AcquirerPOIID\":\"V400m-324688179\",\n                    \"AcquirerTransactionID\":{\n                        \"TimeStamp\":\"2019-03-26T09:22:16.000Z\",\n                        \"TransactionID\":\"9815220561432452\"\n                    },\n                    \"MerchantID\":\"TestMerchantPOS\"\n                },\n                \"PaymentInstrumentData\":{\n                    \"StoredValueAccountID\":{\n                        \"IdentificationType\":\"PAN\",\n                        \"EntryMode\":[\n                            \"Scanned\"\n                        ],\n                        \"StoredValueID\":\"9826150911219687\",\n                        \"StoredValueAccountType\":\"GiftCard\",\n                        \"StoredValueProvider\":\"svs\",\n                        \"ExpiryDate\":\"1122\"\n                    },\n                    \"PaymentInstrumentType\":\"StoredValue\"\n                },\n                \"AmountsResp\":{\n                    \"AuthorizedAmount\":10.99,\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\":\"POSSystemID12345\",\n            \"MessageClass\":\"Service\",\n            \"MessageCategory\":\"Payment\",\n            \"ServiceID\":\"9267\",\n            \"POIID\":\"V400m-324688179\",\n            \"MessageType\":\"Response\"\n        }\n    }\n}<\/code><\/pre>\n<\/li>\n<\/ul>\n<p>Voc\u00ea pode visualizar os detalhes dos pagamentos com cart\u00e3o vale presente na sua <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>, em, <strong>Transactions<\/strong> &gt; <strong>Payments<\/strong>.<\/p>\n<h2 id=\"partial-authorisation\">Realizando pagamentos parciais<\/h2>\n<p>Se o saldo do cart\u00e3o vale presente for menor que o valor da compra, voc\u00ea poder\u00e1 permitir que o cliente pague uma parte com o cart\u00e3o vale presente e a outra parte com outro cart\u00e3o ou em dinheiro. Em cada solicita\u00e7\u00e3o de pagamento parcial, voc\u00ea adiciona uma <a href=\"\/pt\/point-of-sale\/tender-options#page-introduction\">tender option<\/a>, para indicar que \u00e9 um pagamento parcial e uma refer\u00eancia que permite conectar os pagamentos parciais ao mesmo pedido.<\/p>\n<p>Para efetuar pagamentos parciais pora uma \u00fanica venda:<\/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> do cart\u00e3o vale presente.<\/li>\n<li>\n<p>Fa\u00e7a uma <a href=\"#make-payment-request\">solicita\u00e7\u00e3o de pagamento com cart\u00e3o vale presente<\/a> para o saldo existente no cart\u00e3o, e uma <a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/make-a-payment\">solicita\u00e7\u00e3o de pagamento regular<\/a> para  restante do valor da compra. Em cada uma dessas solicita\u00e7\u00f5es, especifique adicionalmente:<\/p>\n<ul>\n<li><code>SaleData.SaleToAcquirerData<\/code>: <strong>tenderOption=AllowPartialAuthorisation<\/strong><\/li>\n<li><code>SaleData.SaleReferenceID<\/code>: Refer\u00eancia exclusiva, como o n\u00famero de um pedido mais um n\u00famero de sequ\u00eancia, que permite identificar pagamentos parciais que ser\u00e3o realizados juntos. Por exemplo, se o n\u00famero do pedido for <em>Order12345<\/em>, especifique <strong>Order12345-1<\/strong> na primeira solicita\u00e7\u00e3o de pagamento parcial e <strong>Order12345-2<\/strong> na segunda solicita\u00e7\u00e3o de pagamento parcial. Em sua <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>, isso aparecer\u00e1 como <strong>Merchant Order<\/strong> para o pagamento.<\/li>\n<\/ul>\n<p>Este exemplo mostra esses par\u00e2metros adicionais em uma solicita\u00e7\u00e3o de pagamento parcial com cart\u00e3o vale presente.<\/p>\n<pre><code class=\"language-json\">{\n    \"SaleToPOIRequest\":{\n        \"MessageHeader\":{\n        ...\n        },\n        \"PaymentRequest\":{\n            \"SaleData\":{\n                \"SaleTransactionID\":{\n                    \"TransactionID\":\"44740\",\n                    \"TimeStamp\":\"2019-03-26T09:13:41+00:00\"\n                },\n                \"SaleToAcquirerData\":\"tenderOption=AllowPartialAuthorisation\",\n                \"SaleReferenceID\":\"YOUR_ORDER_REFERENCE\"\n            },\n            \"PaymentTransaction\":{\n                ...\n            },\n            \"PaymentData\":{\n                \"PaymentInstrumentData\":{\n                    \"PaymentInstrumentType\":\"StoredValue\",\n                    \"StoredValueAccountID\":{\n                        ...\n                    }\n                }\n            }\n        }\n    }\n}<\/code><\/pre>\n<\/li>\n<\/ol>\n<p>Os pedidos de pagamento s\u00e3o enviados para a plataforma de pagamentos da Adyen para processamento. Depois de processada, sua integra\u00e7\u00e3o recebe o resultado do pagamento.<\/p>\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\/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>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\/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><a href=\"\/point-of-sale\/what-we-support\/payment-methods\/gift-cards-terminal-api\/refund-gift-cards\" 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 reembolso para um cart\u00e3o vale presente<\/h6><p>Fa\u00e7a um reembolso n\u00e3o referenciado para 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\/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\/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\/payment","articleFields":{"description":"Fa\u00e7a pagamentos com cart\u00e3o vale presente no terminal.","id":"36196864","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"01-06-2020 17:30"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/alternative-payment-methods\/gift-cards-terminal-api\/payment","title":"Realizar pagamentos com cart\u00e3o vale presente","content":"Depois de ativar um cart\u00e3o vale presente, voc\u00ea poder\u00e1 efetuar pagamentos com o cart\u00e3o.\nEfetuar um pagamento com cart\u00e3o vale presente \u00e9 semelhante a um pagamento com cart\u00e3o de cr\u00e9dito ou d\u00e9bito, mas voc\u00ea precisar\u00e1 fornecer alguns detalhes adicionais relacionados ao cart\u00e3o vale presente. Voc\u00ea pode coletar essas informa\u00e7\u00f5es fazendo a leitura do cart\u00e3o vale presente ou inserindo as informa\u00e7\u00f5es manualmente em sua caixa registradora ou terminal. Quando essa solicita\u00e7\u00e3o de pagamento for processada, voc\u00ea receber\u00e1 o resultado do pagamento.\nSe o saldo do cart\u00e3o vale presente n\u00e3o cobrir o valor integral do pagamento, voc\u00ea poder\u00e1 fazer pagamentos parciais.\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 a solicita\u00e7\u00e3o de pagamento\nPara iniciar um pagamento com 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 enviada para a solicita\u00e7\u00e3o de pagamento deve incluir:\n\nSaleData.SaleTransactionID.TransactionID: Sua refer\u00eancia exclusiva para esta solicita\u00e7\u00e3o.\nSaleData.SaleTransactionID.TimeStamp: Data e hora da solicita\u00e7\u00e3o, no formato UTC.\nSaleData.SaleReferenceID: Par\u00e2metro opcional para fornecer o n\u00famero do seu pedido. Voc\u00ea pode usar isso para conectar transa\u00e7\u00f5es diferentes de um cart\u00e3o vale presente no mesmo pedido. Na Customer Area, este aparecer\u00e1 como Merchant Order para a transa\u00e7\u00e3o.\nPaymentTransaction.AmountsReq.Currency: A moeda escolhdia para a transa\u00e7\u00e3o.\nPaymentTransaction.AmountsReq.RequestedAmount: O valor da transa\u00e7\u00e3o.\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\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\n\n\nO exemplo abaixo mostra como voc\u00ea iniciaria um pagamento de GBP&nbsp;10,99 com 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 pagamento \u00e9 enviada \u00e0 plataforma de pagamentos da Adyen para processamento.\nEtapa 2: recebendo o resultado do pagamento\nDepois de processada, sua integra\u00e7\u00e3o recebe o resultado do pagamento. 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 pagamento com cart\u00e3o vale presente for bem-sucedido:\n\nApproved ser\u00e1 exibido na tela do terminal.\n\nVoc\u00ea recebe uma resposta que cont\u00e9m um objeto PaymentResponse. Isso inclui:\n\nPOIData.POITransactionID.TransactionID: Identificador de transa\u00e7\u00e3o Objeto que cont\u00e9m dados que voc\u00ea pode usar para gerar um recibo.\nPaymentResponse.Response.Result: Success\n\nO exemplo abaixo indica que o pagamento com cart\u00e3o vale presente foi bem-sucedido.\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        \"PaymentResponse\":{\n            \"POIData\":{\n                \"POITransactionID\":{\n                    \"TimeStamp\":\"2019-03-26T09:22:16.000Z\",\n                    \"TransactionID\":\"oLkO001522056136000.9815220561432452\"\n                }\n            },\n            \"SaleData\":{\n                \"SaleTransactionID\":{\n                    \"TimeStamp\":\"2019-03-26T09:22:21.000Z\",\n                    \"TransactionID\":\"44740\"\n                }\n            },\n            \"PaymentReceipt\":[...],\n            \"PaymentResult\":{\n                \"PaymentAcquirerData\":{\n                    \"AcquirerPOIID\":\"V400m-324688179\",\n                    \"AcquirerTransactionID\":{\n                        \"TimeStamp\":\"2019-03-26T09:22:16.000Z\",\n                        \"TransactionID\":\"9815220561432452\"\n                    },\n                    \"MerchantID\":\"TestMerchantPOS\"\n                },\n                \"PaymentInstrumentData\":{\n                    \"StoredValueAccountID\":{\n                        \"IdentificationType\":\"PAN\",\n                        \"EntryMode\":[\n                            \"Scanned\"\n                        ],\n                        \"StoredValueID\":\"9826150911219687\",\n                        \"StoredValueAccountType\":\"GiftCard\",\n                        \"StoredValueProvider\":\"svs\",\n                        \"ExpiryDate\":\"1122\"\n                    },\n                    \"PaymentInstrumentType\":\"StoredValue\"\n                },\n                \"AmountsResp\":{\n                    \"AuthorizedAmount\":10.99,\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\":\"POSSystemID12345\",\n            \"MessageClass\":\"Service\",\n            \"MessageCategory\":\"Payment\",\n            \"ServiceID\":\"9267\",\n            \"POIID\":\"V400m-324688179\",\n            \"MessageType\":\"Response\"\n        }\n    }\n}\n\n\nVoc\u00ea pode visualizar os detalhes dos pagamentos com cart\u00e3o vale presente na sua Customer Area, em, Transactions &gt; Payments.\nRealizando pagamentos parciais\nSe o saldo do cart\u00e3o vale presente for menor que o valor da compra, voc\u00ea poder\u00e1 permitir que o cliente pague uma parte com o cart\u00e3o vale presente e a outra parte com outro cart\u00e3o ou em dinheiro. Em cada solicita\u00e7\u00e3o de pagamento parcial, voc\u00ea adiciona uma tender option, para indicar que \u00e9 um pagamento parcial e uma refer\u00eancia que permite conectar os pagamentos parciais ao mesmo pedido.\nPara efetuar pagamentos parciais pora uma \u00fanica venda:\n\nVerifique o saldo do cart\u00e3o vale presente.\n\nFa\u00e7a uma solicita\u00e7\u00e3o de pagamento com cart\u00e3o vale presente para o saldo existente no cart\u00e3o, e uma solicita\u00e7\u00e3o de pagamento regular para  restante do valor da compra. Em cada uma dessas solicita\u00e7\u00f5es, especifique adicionalmente:\n\nSaleData.SaleToAcquirerData: tenderOption=AllowPartialAuthorisation\nSaleData.SaleReferenceID: Refer\u00eancia exclusiva, como o n\u00famero de um pedido mais um n\u00famero de sequ\u00eancia, que permite identificar pagamentos parciais que ser\u00e3o realizados juntos. Por exemplo, se o n\u00famero do pedido for Order12345, especifique Order12345-1 na primeira solicita\u00e7\u00e3o de pagamento parcial e Order12345-2 na segunda solicita\u00e7\u00e3o de pagamento parcial. Em sua Customer Area, isso aparecer\u00e1 como Merchant Order para o pagamento.\n\nEste exemplo mostra esses par\u00e2metros adicionais em uma solicita\u00e7\u00e3o de pagamento parcial com cart\u00e3o vale presente.\n{\n    \"SaleToPOIRequest\":{\n        \"MessageHeader\":{\n        ...\n        },\n        \"PaymentRequest\":{\n            \"SaleData\":{\n                \"SaleTransactionID\":{\n                    \"TransactionID\":\"44740\",\n                    \"TimeStamp\":\"2019-03-26T09:13:41+00:00\"\n                },\n                \"SaleToAcquirerData\":\"tenderOption=AllowPartialAuthorisation\",\n                \"SaleReferenceID\":\"YOUR_ORDER_REFERENCE\"\n            },\n            \"PaymentTransaction\":{\n                ...\n            },\n            \"PaymentData\":{\n                \"PaymentInstrumentData\":{\n                    \"PaymentInstrumentType\":\"StoredValue\",\n                    \"StoredValueAccountID\":{\n                        ...\n                    }\n                }\n            }\n        }\n    }\n}\n\n\nOs pedidos de pagamento s\u00e3o enviados para a plataforma de pagamentos da Adyen para processamento. Depois de processada, sua integra\u00e7\u00e3o recebe o resultado do pagamento.\nPr\u00f3ximos passos\n\nConsulte o saldo do cart\u00e3o vale presenteEfetue um pagamento com um cart\u00e3o vale presente ativado.Carregar um cart\u00e3o vale presenteColoque um cr\u00e9dito adicional em um cart\u00e3o vale presente.Realizar um reembolso para um cart\u00e3o vale presenteFa\u00e7a um reembolso n\u00e3o referenciado para um cart\u00e3o vale presente.\n\nVeja tamb\u00e9m\n\n\n                    Ative 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":"Realizar pagamentos com 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\/payment"},"levels":5,"category":"In-person payments","category_color":"green","tags":["Realizar","pagamentos","cart\u00e3o","presente"]},"articleFiles":{"payment_0.json":"<p alt=\"\">payment_0.json<\/p>"}}