{"title":"Envie Tender options","category":"default","creationDate":1776961627,"content":"<div class=\"additional-info-block output-inline\">\n<h5 class=\"article__heading additional-info-block__title\">Using our Standalone solution?<\/h5><div class=\"additional-info-block__body\"><p>Com nossa <a href=\"\/pt\/point-of-sale\/standalone\">solu\u00e7\u00e3o n\u00e3o integrada<\/a>, o suporte pode configurar tender options e condi\u00e7\u00f5es de transa\u00e7\u00e3o para sua conta.<\/p><\/div><\/div>\n\n<p>Tender options s\u00e3o par\u00e2metros que alteram a forma como o <a href=\"\/pt\/get-started-with-adyen\/adyen-glossary\/#tender\">tender<\/a> \u00e9 processado. Por exemplo, a tender option <code>AskGratuity<\/code> aciona o terminal de pagamento para solicitar uma gorjeta ao cliente.<\/p>\n<p>Voc\u00ea envias as tender options em suas solicita\u00e7\u00f5es de pagamento da API do terminal usando o campo <code>SaleToAcquirerData<\/code>.<\/p>\n<h3>Outras maneiras de alterar o processamento de transa\u00e7\u00f5es<\/h3>\n<p>Al\u00e9m de enviar tender options, h\u00e1 outras maneiras de influenciar o processamento da transa\u00e7\u00e3o. Voc\u00ea pode:<\/p>\n<ul>\n<li>Envie uma condi\u00e7\u00e3o de transa\u00e7\u00e3o em sua solicita\u00e7\u00e3o de pagamento. Isso for\u00e7a o terminal de pagamento a aceitar um m\u00e9todo de entrada de cart\u00e3o espec\u00edfico para esse pagamento. Isso \u00e9 usado para <a href=\"\/pt\/point-of-sale\/enter-payment-manually\">pagamentos com venda digitada (MKE)<\/a>.<\/li>\n<li>Configure tender options e condi\u00e7\u00f5es de transa\u00e7\u00e3o padr\u00e3o. TO terminal as utilizar\u00e1 para cada pagamento. Pe\u00e7a ajuda \u00e0 nossa\u00a0<a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a>.<\/li>\n<\/ul>\n<h2 id=\"list-of-tender-options\">Lista de tender options<\/h2>\n<p>Estas s\u00e3o as tender options que voc\u00ea pode <a href=\"#pass-tender-options\">passar no campo <code>SaleToAcquirerData<\/code><\/a>:<\/p>\n<table><thead><tr class=\"header\"><th>Nome<\/th><th>Descri\u00e7ao<\/th><\/tr><\/thead><tbody>\n<tr><td>\n<p><code>AllowPartialAuthorisation<\/code><\/p>\n<\/td><td>\n<p>Sinaliza que uma aprova\u00e7\u00e3o parcial \u00e9 permitida e \u00e9 poss\u00edvel que o valor autorizado seja menor que o valor solicitado.<\/p>\n<\/td><\/tr>\n<tr><td>\n<p><code>AskGiving<\/code><\/p>\n<\/td><td>\n<p>Aciona o terminal para perguntar se o cliente deseja <a href=\"\/point-of-sale\/donate\">doar<\/a>para institui\u00e7\u00f5es de caridade.<\/p>\n<\/td><\/tr>\n<tr><td>\n<p><code>AskGratuity<\/code><\/p>\n<\/td><td>\n<p>Ativa o terminal para perguntar se o cliente deseja dar gorjeta.<\/p>\n<\/td><\/tr>\n<tr><td>\n<p><code>BypassPin<\/code><\/p>\n<\/td><td>\n<p>Ignora a entrada do PIN quando o cliente diz que n\u00e3o sabe o PIN do cart\u00e3o e voc\u00ea sabe que ele \u00e9 o titular leg\u00edtimo do cart\u00e3o ou deseja oferecer o benef\u00edcio da d\u00favida.Este \u00e9 o processo: <ol><li>Os funcion\u00e1rios da sua loja cancelam a transa\u00e7\u00e3o existente e iniciam uma nova transa\u00e7\u00e3o atrav\u00e9s da caixa registradora.<\/li><\/ol><\/p>\n<\/td> <li>\n<p>O cliente pressiona a tecla verde (CONFIRMAR) quando solicita um PIN e fornece uma assinatura.<\/p>\n<\/li> <li>\n<p>Os funcion\u00e1rios da sua loja verificam e aprovam a assinatura.<\/p>\n<\/li><p>Como \u00e9 de se espera que o portador do cart\u00e3o conhe\u00e7a o PIN do cart\u00e3o, recomendamos verificar a assinatura e o nome do titular do cart\u00e3o com alguma forma de identifica\u00e7\u00e3o.<\/p><\/tr>\n<tr><td>\n<p><code>ForcedDecline<\/code><\/p>\n<\/td><td>\n<p>For\u00e7a a transa\u00e7\u00e3o a ser recusada, por exemplo, se houver suspeita de fraude.<\/p>\n<\/td><\/tr>\n<tr><td>\n<p><code>MOTO<\/code><\/p>\n<\/td><td>\n<p>Aciona transa\u00e7\u00f5es de pedidos por correio ou telefone no terminal de pagamento da caixa registradora. As transa\u00e7\u00f5es MOTO s\u00e3o\u00a0<a href=\"\/get-started-with-adyen\/adyen-glossary\/#card-not-present-cnp\">transa\u00e7\u00f5es sem cart\u00e3o<\/a>, em que os detalhes do pagamento s\u00e3o apresentados a um\u00a0<a href=\"\/get-started-with-adyen\/adyen-glossary\/#merchant\">comerciante<\/a>\u00a0por um\u00a0<a href=\"\/get-started-with-adyen\/adyen-glossary\/#shopper\">cliente<\/a>\u00a0por correio, fax, ou telefone.<\/p>\n<\/td><\/tr>\n<tr><td>\n<p><code>ReceiptHandler<\/code><\/p>\n<\/td><td>\n<p>Especifica que a caixa registradora manipula e imprime recibos. Se omitido, \u00e9 necess\u00e1rio que o terminal de pagamento imprima o recibo. Se n\u00e3o houver uma unidade de impressora, a transa\u00e7\u00e3o falhar\u00e1.<\/p>\n<\/td><\/tr>\n<tr><td>\n<p><code>SkipAIDPriority<\/code><\/p>\n<\/td><td>\n<p>Pule a prioridade do identificador de aplicativo (AID) que foi definida na sua \u00e1rea de cliente. Isso permite que um cliente selecione sua aplica\u00e7\u00e3o preferida (forma de pagamento).<\/p>\n<\/td><\/tr><\/tbody><\/table>\n<h2 id=\"pass-tender-options\">Especificar tender options<\/h2>\n<p>Para especificar as tender options que voc\u00ea deseja usar (consulte a <a href=\"#list-of-tender-options\">lista<\/a>):<\/p>\n<ul>\n<li>\n<p>Fa\u00e7a um <code>PaymentRequest<\/code> que contenha um campo <code>SaletoAcquirerData<\/code> com um ou mais valores separados por v\u00edrgula especificados em um dos seguintes formatos:<\/p>\n<ul>\n<li>\n<p>Op\u00e7\u00e3o  1: Um objeto JSON <code>{\"tenderOption\": \"option\"}<\/code> convertido em uma sequ\u00eancia codificada Base64.<br \/>\nPor exemplo, voc\u00ea codifica <code>{\"tenderOption\": \"AskGratuity,ReceiptHandler\"}<\/code> para Base64 e passa o resultado:<br \/>\n<code>\"SaleToAcquirerData\": \"eyJ0ZW5kZXJPcHRpb24iOiAiQXNrR3JhdHVpdHksUmVjZWlwdEhhbmRsZXIifQ==\"<\/code><\/p>\n<\/li>\n<li>\n<p>Op\u00e7\u00e3o 2: <strong>tenderOption=option<\/strong>.<br \/>\nPor exemplo: <code>\"SaleToAcquirerData\": \"tenderOption=AskGratuity,ReceiptHandler\"<\/code><\/p>\n<\/li>\n<\/ul>\n<p>O formato que voc\u00ea usa aqui tamb\u00e9m ser\u00e1 o formato <code>AdditionalResponse<\/code> que voc\u00ea receber\u00e1.<\/p>\n<p>O exemplo a seguir mostra como voc\u00ea envia as Tender options <code>AskGratuity<\/code> e <code>ReceiptHandler<\/code> para o terminal. A resposta mostra que o cliente adicionou uma gorjeta.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"''\" :id=\"'tender-options_1'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"JSON\",\"content\":\"{\\n    \\\"SaleToPOIRequest\\\":{\\n        \\\"PaymentRequest\\\":{\\n            \\\"SaleData\\\":{\\n                \\\"SaleTransactionID\\\":{\\n                    \\\"TransactionID\\\":\\\"733\\\",\\n                    \\\"TimeStamp\\\":\\\"2022-03-16T07:51:15.685Z\\\"\\n                },\\n                \\\"SaleToAcquirerData\\\":\\\"tenderOption=AskGratuity,ReceiptHandler\\\"\\n            },\\n            \\\"PaymentTransaction\\\":{\\n                \\\"AmountsReq\\\":{\\n                    \\\"Currency\\\":\\\"EUR\\\",\\n                    \\\"RequestedAmount\\\":155.75\\n                }\\n            }\\n        },\\n        \\\"MessageHeader\\\":{\\n            \\\"ProtocolVersion\\\":\\\"3.0\\\",\\n            \\\"MessageClass\\\":\\\"Service\\\",\\n            \\\"MessageCategory\\\":\\\"Payment\\\",\\n            \\\"MessageType\\\":\\\"Request\\\",\\n            \\\"ServiceID\\\":\\\"0110123015\\\",\\n            \\\"SaleID\\\":\\\"POSSystemID12345\\\",\\n            \\\"POIID\\\":\\\"M400-260193322\\\"\\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.setSaleToAcquirerData(\\\"tenderOption=AskGratuity,ReceiptHandler\\\");\\npaymentRequest.setSaleData(saleData);\\n\\nPaymentTransaction paymentTransaction = new PaymentTransaction();\\nAmountsReq amountsReq = new AmountsReq();\\namountsReq.setCurrency(\\\"EUR\\\");\\namountsReq.setRequestedAmount( BigDecimal.valueOf(155.75) );\\npaymentTransaction.setAmountsReq(amountsReq);\\npaymentRequest.setPaymentTransaction(paymentTransaction);\\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<h3>Combinando tender options e outros par\u00e2metros<\/h3>\n<p>Al\u00e9m das tender options, existem outros par\u00e2metros que tamb\u00e9m s\u00e3o passados no campo <code>SaleToAcquirerData<\/code>. FPor exemplo, voc\u00ea pode usar par\u00e2metros para o <a href=\"\/pt\/point-of-sale\/shopper-recognition\">reconhecimento do comprador<\/a> ou <a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/pass-application-information\">transmiss\u00e3o de informa\u00e7\u00f5es da aplica\u00e7\u00e3o<\/a>.<\/p>\n<p>Para combinar tender options e outros par\u00e2metros, use um dos seguintes m\u00e9todos:<\/p>\n<ul>\n<li>\n<p>Op\u00e7\u00e3o 1: Crie um objeto JSON, codifique-o para Base64 e especifique a sequ\u00eancia resultante.<\/p>\n<p>Este \u00e9 um objeto JSON de amostra:<\/p>\n<pre><code class=\"language-json\">{\n    \"tenderOption\": \"AskGratuity\",\n    \"shopperEmail\": \"s.hopper@mail.com\",\n    \"shopperReference\": \"YOUR_UNIQUE_SHOPPER_ID\",\n    \"recurringContract\": \"RECURRING,ONECLICK\"\n}<\/code><\/pre>\n<p>Ap\u00f3s converter o objeto JSON em uma cadeia codificada em Base64, \u00e9 assim que voc\u00ea o transmite:<\/p>\n<pre><code class=\"language-raw\">\"SaleToAcquirerData\": \"ewogICJ0ZW5kZXJPcHRpb24iOiAiQXNrR3JhdHVpdHkiLAogICJzaG9wcGVyRW1haWwiOiAicy5ob3BwZXJAbWFpbC5jb20iLAogICJzaG9wcGVyUmVmZXJlbmNlIjogIllPVVJfVU5JUVVFX1NIT1BQRVJfSUQiLAogICJyZWN1cnJpbmdDb250cmFjdCI6ICJSRUNVUlJJTkcsT05FQ0xJQ0siCn0=\"<\/code><\/pre>\n<\/li>\n<li>\n<p>Op\u00e7\u00e3o 2: especifique todos os valores em pares de valores-chave codificados em formul\u00e1rio (usando <strong>&amp;<\/strong> como separador). Por exemplo:<\/p>\n<pre><code class=\"language-raw\">\"SaleToAcquirerData\": \"tenderOption=AskGratuity&amp;shopperEmail=s.hopper@gmai&amp;shopperReference=YOUR_UNIQUE_SHOPPER_ID&amp;recurringProcessingModel=UnscheduledCardOnFile\"<\/code><\/pre>\n<\/li>\n<\/ul>\n<h2>Veja tamb\u00e9m<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/point-of-sale\/error-scenarios\"\n                        target=\"_self\"\n                        >\n                    Lidando com erros\n                <\/a><\/li><li><a href=\"\/point-of-sale\/enter-payment-manually\"\n                        target=\"_self\"\n                        >\n                    Venda digitada (MKE)\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/add-data\/tender-options","articleFields":{"description":"Use par\u00e2metros para alterar como uma transa\u00e7\u00e3o \u00e9 processada.","id":"24217621","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"30-04-2020 17:07"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/add-data\/tender-options","title":"Envie Tender options","content":"\nUsing our Standalone solution?Com nossa solu\u00e7\u00e3o n\u00e3o integrada, o suporte pode configurar tender options e condi\u00e7\u00f5es de transa\u00e7\u00e3o para sua conta.\n\nTender options s\u00e3o par\u00e2metros que alteram a forma como o tender \u00e9 processado. Por exemplo, a tender option AskGratuity aciona o terminal de pagamento para solicitar uma gorjeta ao cliente.\nVoc\u00ea envias as tender options em suas solicita\u00e7\u00f5es de pagamento da API do terminal usando o campo SaleToAcquirerData.\nOutras maneiras de alterar o processamento de transa\u00e7\u00f5es\nAl\u00e9m de enviar tender options, h\u00e1 outras maneiras de influenciar o processamento da transa\u00e7\u00e3o. Voc\u00ea pode:\n\nEnvie uma condi\u00e7\u00e3o de transa\u00e7\u00e3o em sua solicita\u00e7\u00e3o de pagamento. Isso for\u00e7a o terminal de pagamento a aceitar um m\u00e9todo de entrada de cart\u00e3o espec\u00edfico para esse pagamento. Isso \u00e9 usado para pagamentos com venda digitada (MKE).\nConfigure tender options e condi\u00e7\u00f5es de transa\u00e7\u00e3o padr\u00e3o. TO terminal as utilizar\u00e1 para cada pagamento. Pe\u00e7a ajuda \u00e0 nossa\u00a0Support Team.\n\nLista de tender options\nEstas s\u00e3o as tender options que voc\u00ea pode passar no campo SaleToAcquirerData:\nNomeDescri\u00e7ao\n\nAllowPartialAuthorisation\n\nSinaliza que uma aprova\u00e7\u00e3o parcial \u00e9 permitida e \u00e9 poss\u00edvel que o valor autorizado seja menor que o valor solicitado.\n\n\nAskGiving\n\nAciona o terminal para perguntar se o cliente deseja doarpara institui\u00e7\u00f5es de caridade.\n\n\nAskGratuity\n\nAtiva o terminal para perguntar se o cliente deseja dar gorjeta.\n\n\nBypassPin\n\nIgnora a entrada do PIN quando o cliente diz que n\u00e3o sabe o PIN do cart\u00e3o e voc\u00ea sabe que ele \u00e9 o titular leg\u00edtimo do cart\u00e3o ou deseja oferecer o benef\u00edcio da d\u00favida.Este \u00e9 o processo: Os funcion\u00e1rios da sua loja cancelam a transa\u00e7\u00e3o existente e iniciam uma nova transa\u00e7\u00e3o atrav\u00e9s da caixa registradora.\n \nO cliente pressiona a tecla verde (CONFIRMAR) quando solicita um PIN e fornece uma assinatura.\n \nOs funcion\u00e1rios da sua loja verificam e aprovam a assinatura.\nComo \u00e9 de se espera que o portador do cart\u00e3o conhe\u00e7a o PIN do cart\u00e3o, recomendamos verificar a assinatura e o nome do titular do cart\u00e3o com alguma forma de identifica\u00e7\u00e3o.\n\nForcedDecline\n\nFor\u00e7a a transa\u00e7\u00e3o a ser recusada, por exemplo, se houver suspeita de fraude.\n\n\nMOTO\n\nAciona transa\u00e7\u00f5es de pedidos por correio ou telefone no terminal de pagamento da caixa registradora. As transa\u00e7\u00f5es MOTO s\u00e3o\u00a0transa\u00e7\u00f5es sem cart\u00e3o, em que os detalhes do pagamento s\u00e3o apresentados a um\u00a0comerciante\u00a0por um\u00a0cliente\u00a0por correio, fax, ou telefone.\n\n\nReceiptHandler\n\nEspecifica que a caixa registradora manipula e imprime recibos. Se omitido, \u00e9 necess\u00e1rio que o terminal de pagamento imprima o recibo. Se n\u00e3o houver uma unidade de impressora, a transa\u00e7\u00e3o falhar\u00e1.\n\n\nSkipAIDPriority\n\nPule a prioridade do identificador de aplicativo (AID) que foi definida na sua \u00e1rea de cliente. Isso permite que um cliente selecione sua aplica\u00e7\u00e3o preferida (forma de pagamento).\n\nEspecificar tender options\nPara especificar as tender options que voc\u00ea deseja usar (consulte a lista):\n\n\nFa\u00e7a um PaymentRequest que contenha um campo SaletoAcquirerData com um ou mais valores separados por v\u00edrgula especificados em um dos seguintes formatos:\n\n\nOp\u00e7\u00e3o  1: Um objeto JSON {\"tenderOption\": \"option\"} convertido em uma sequ\u00eancia codificada Base64.\nPor exemplo, voc\u00ea codifica {\"tenderOption\": \"AskGratuity,ReceiptHandler\"} para Base64 e passa o resultado:\n\"SaleToAcquirerData\": \"eyJ0ZW5kZXJPcHRpb24iOiAiQXNrR3JhdHVpdHksUmVjZWlwdEhhbmRsZXIifQ==\"\n\n\nOp\u00e7\u00e3o 2: tenderOption=option.\nPor exemplo: \"SaleToAcquirerData\": \"tenderOption=AskGratuity,ReceiptHandler\"\n\n\nO formato que voc\u00ea usa aqui tamb\u00e9m ser\u00e1 o formato AdditionalResponse que voc\u00ea receber\u00e1.\nO exemplo a seguir mostra como voc\u00ea envia as Tender options AskGratuity e ReceiptHandler para o terminal. A resposta mostra que o cliente adicionou uma gorjeta.\n\n\n\n\n\nCombinando tender options e outros par\u00e2metros\nAl\u00e9m das tender options, existem outros par\u00e2metros que tamb\u00e9m s\u00e3o passados no campo SaleToAcquirerData. FPor exemplo, voc\u00ea pode usar par\u00e2metros para o reconhecimento do comprador ou transmiss\u00e3o de informa\u00e7\u00f5es da aplica\u00e7\u00e3o.\nPara combinar tender options e outros par\u00e2metros, use um dos seguintes m\u00e9todos:\n\n\nOp\u00e7\u00e3o 1: Crie um objeto JSON, codifique-o para Base64 e especifique a sequ\u00eancia resultante.\nEste \u00e9 um objeto JSON de amostra:\n{\n    \"tenderOption\": \"AskGratuity\",\n    \"shopperEmail\": \"s.hopper@mail.com\",\n    \"shopperReference\": \"YOUR_UNIQUE_SHOPPER_ID\",\n    \"recurringContract\": \"RECURRING,ONECLICK\"\n}\nAp\u00f3s converter o objeto JSON em uma cadeia codificada em Base64, \u00e9 assim que voc\u00ea o transmite:\n\"SaleToAcquirerData\": \"ewogICJ0ZW5kZXJPcHRpb24iOiAiQXNrR3JhdHVpdHkiLAogICJzaG9wcGVyRW1haWwiOiAicy5ob3BwZXJAbWFpbC5jb20iLAogICJzaG9wcGVyUmVmZXJlbmNlIjogIllPVVJfVU5JUVVFX1NIT1BQRVJfSUQiLAogICJyZWN1cnJpbmdDb250cmFjdCI6ICJSRUNVUlJJTkcsT05FQ0xJQ0siCn0=\"\n\n\nOp\u00e7\u00e3o 2: especifique todos os valores em pares de valores-chave codificados em formul\u00e1rio (usando &amp; como separador). Por exemplo:\n\"SaleToAcquirerData\": \"tenderOption=AskGratuity&amp;shopperEmail=s.hopper@gmai&amp;shopperReference=YOUR_UNIQUE_SHOPPER_ID&amp;recurringProcessingModel=UnscheduledCardOnFile\"\n\n\nVeja tamb\u00e9m\n\n\n                    Lidando com erros\n                \n                    Venda digitada (MKE)\n                \n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Adicionar informa\u00e7\u00f5es a um pagamento","lvl3":"Envie Tender options"},"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\/add-data","lvl3":"\/pt\/point-of-sale\/add-data\/tender-options"},"levels":4,"category":"In-person payments","category_color":"green","tags":["Envie","Tender","options"]},"articleFiles":{"tender-options_1.json":"<p alt=\"\">tender-options_1.json<\/p>"}}