{"title":"Adicionar informa\u00e7\u00f5es a um pagamento","category":"default","creationDate":1776961627,"content":"<p>Em uma solicita\u00e7\u00e3o b\u00e1sica de pagamento da API de terminais, voc\u00ea s\u00f3 precisa especificar o valor, a moeda, o ID e a data e hora da transa\u00e7\u00e3o. Mas talvez voc\u00ea queira adicionar as informa\u00e7\u00f5es que deseja aplicar \u00e0 sua solicita\u00e7\u00e3o ou salvar na plataforma de pagamentos da Adyen. O campo <code>SaleToAcquirerData<\/code> permite que voc\u00ea fa\u00e7a isso. Nesse campo, voc\u00ea pode adicionar todos os tipos de elementos de dados:<\/p>\n<ul>\n<li><a href=\"#application-info\">Informa\u00e7\u00f5es da aplica\u00e7\u00e3o<\/a> que podemos usar para fins de solu\u00e7\u00e3o de problemas.<\/li>\n<li><a href=\"#metadata\">Metadata<\/a> de sua pr\u00f3pria escolha que voc\u00ea deseja conectar ao pagamento.<\/li>\n<li><a href=\"#shopper-recognition\">Dados para permitir o reconhecimento do cliente e tokeniza\u00e7\u00e3o<\/a>.<\/li>\n<li><a href=\"#tender-options\">Op\u00e7\u00f5es Tender<\/a> para influenciar como a transa\u00e7\u00e3o \u00e9 processada.<\/li>\n<li><a href=\"#additional-data-elements\">Dados adicionais<\/a> para casos de uso comuns. Por exemplo, para pagamentos divididos e pr\u00e9-autoriza\u00e7\u00e3o.<\/li>\n<\/ul>\n<p>Consulte <a href=\"\/pt\/point-of-sale\/add-data\/sale-to-acquirer-data\">exemplos de SaleToAcquirerData<\/a> para ver como s\u00e3o esses elementos de dados. Abaixo, os descrevemos com mais detalhes e explicamos como adicionar uma combina\u00e7\u00e3o de elementos de dados \u00e0 sua solicita\u00e7\u00e3o de pagamento.<\/p>\n<h3 id=\"application-info\">Informa\u00e7\u00f5es da aplica\u00e7\u00e3o<\/h3>\n<p>As informa\u00e7\u00f5es da aplica\u00e7\u00e3o consistem em elementos de dados que identificam o software usado para fazer solicita\u00e7\u00f5es de pagamento para a plataforma de pagamentos da Adyen. Quando voc\u00ea inclui informa\u00e7\u00f5es da aplica\u00e7\u00e3o em suas solicita\u00e7\u00f5es de pagamento, podemos analisar e solucionar problemas de pagamentos com mais efici\u00eancia e fornecer uma melhor experi\u00eancia de suporte.<\/p>\n<p>FPara obter mais informa\u00e7\u00f5es, consulte <a href=\"\/pt\/point-of-sale\/add-data\/pass-application-information\">Enviar informa\u00e7\u00f5es da aplica\u00e7\u00e3o<\/a>.<\/p>\n<h3 id=\"metadata\">Metadata<\/h3>\n<p>Metadata s\u00e3o elementos de dados que voc\u00ea mesmo cria. Quando voc\u00ea adiciona metadados \u00e0 sua solicita\u00e7\u00e3o de pagamento, eles s\u00e3o ecoados na resposta para que voc\u00ea possa conectar a transa\u00e7\u00e3o aos seus metadata. Por exemplo, para adicionar um n\u00famero de turno e um ID de funcion\u00e1rio a um pagamento. Voc\u00ea pode criar at\u00e9 20 campos metadata, onde o m\u00e1ximo do campo de nome \u00e9 20 caracteres e o valor m\u00e1ximo 80 caracteres.<\/p>\n<p>Para tamb\u00e9m receber metadata em seus relat\u00f3rios de liquida\u00e7\u00e3o, entre em contato com nossa <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>.<\/p>\n<h3 id=\"shopper-recognition\">Dados para permitir o reconhecimento do cliente e tokeniza\u00e7\u00e3o<\/h3>\n<p>Com base nos identificadores de clientes que voc\u00ea recebe na resposta de pagamento, \u00e9 poss\u00edvel vincular o pagamento a um cliente. Isso permite que voc\u00ea personalize a experi\u00eancia de compra ou fa\u00e7a pagamentos recorrentes usando um token em vez de detalhes reais do cart\u00e3o. Mas primeiro voc\u00ea precisa criar esses identificadores de clientes e armazen\u00e1-los na plataforma de pagamentos da Adyen. Para fazer isso, voc\u00ea inclui elementos de dados como <code>shopperEmail<\/code>, <code>shopperReference<\/code>, e <code>recurringProcessingModel<\/code> no campo <code>SaleToAcquirerData<\/code> de seu pedido de pagamento inicial.<\/p>\n<p>Para obter mais informa\u00e7\u00f5es, consulte <a href=\"\/pt\/point-of-sale\/shopper-recognition\">Reconhecimento de clientes e tokeniza\u00e7\u00e3o<\/a>.<\/p>\n<h3 id=\"tender-options\">Op\u00e7\u00f5es Tender<\/h3>\n<p>By adding one or more tender options to a payment request, you influence how that transaction is processed. Por exemplo, voc\u00ea pode enviar a  op\u00e7\u00e3o tende <code>AskGratuity<\/code> para mostrar op\u00e7\u00f5es de gorjeta no terminal de pagamento.<\/p>\n<p>Para obter mais inform\u00e7\u00f5es, consulte <a href=\"\/pt\/point-of-sale\/add-data\/tender-options\">Enviar op\u00e7\u00f5eas tender<\/a>.<\/p>\n<h3 id=\"additional-data-elements\">Dados adicionais<\/h3>\n<p>Existem muitos elementos de dados adicionais que voc\u00ea pode adicionar \u00e0s suas solicita\u00e7\u00f5es de pagamento. A lista \u00e9 longa e crescente, por isso n\u00e3o podemos mencionar todas elas aqui. Veja, por exemplo, <a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/Payment\/latest\/authorise__reqParam_additionalData\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Dados adicionais em nosso API Explorer<\/a>. Muitos desses elementos tamb\u00e9m se aplicam a pagamentos na loja.<\/p>\n<h2>AIncluindo elementos de dados em sua solicita\u00e7\u00e3o<\/h2>\n<p>Existem duas maneiras de transmitir elementos de dados no campio <code>SaleToAcquirerData<\/code> da sua solicita\u00e7\u00e3o de pagamento:<\/p>\n<ul>\n<li><strong>Option 1<\/strong>: Como um objeto JSON convertido em uma sequ\u00eancia codificada em Base64.<\/li>\n<li><strong>Option 2<\/strong>: Como pares de valores-chave codificados em formul\u00e1rio (usando <strong>&amp;<\/strong> como separador).<\/li>\n<\/ul>\n<p>Consulte <a href=\"\/pt\/point-of-sale\/add-data\/sale-to-acquirer-data\">exemplos de SaleToAcquirerData<\/a> para ver como s\u00e3o esses formatos.<\/p>\n<p>O formato do <code>SaleToAcquirerData<\/code> determina o formato do <code>AdditionalResponse<\/code> que voc\u00ea recebe.<\/p>\n<h2 id=\"receive-additional-data\">Recebendo a resposta adicional<\/h2>\n<p>A <code>AdditionalResponse<\/code> em sua resposta de pagamento retorna informa\u00e7\u00f5es resultantes do processamento de sua solicita\u00e7\u00e3o de pagamento. Ele tamb\u00e9m ecoa algumas das informa\u00e7\u00f5es que voc\u00ea adicionou \u00e0 sua solicita\u00e7\u00e3o de pagamento, para que voc\u00ea possa us\u00e1-las na sua l\u00f3gica de neg\u00f3cios.<\/p>\n<p>A resposta adicional pode conter muitos campos de dados, mas talvez voc\u00ea n\u00e3o precise de todos eles. Para selecionar os dados que voc\u00ea deseja:<\/p>\n<ol>\n<li>Na sua \u00e1rea de cliente, acesse  <strong>Developers<\/strong> &gt; <strong>API URLs<\/strong>.<\/li>\n<li>Selecione as op\u00e7\u00f5es para o tipo de dados que voc\u00ea deseja receber.<\/li>\n<\/ol>\n<p>O formato da <code>AdditionalResponse<\/code> corresponde ao formato da <code>SaleToAcquirerData<\/code> na solicita\u00e7\u00e3o de pagamento: Um objeto JSON codificado em Base64 ou pares de valores-chave codificados em formul\u00e1rio.<br \/>\nSe a solicita\u00e7\u00e3o n\u00e3o contiver nenhuma <code>SaleToAcquirerData<\/code>, a <code>AdditionalResponse<\/code> estar\u00e1 no formato de pares de valores-chave.<\/p>\n<h2 id=\"base64-json\">Op\u00e7\u00e3o 1: enviar elementos de dados como JSON codificado em Base64<\/h2>\n<p>Este exemplo mostra como adicionar elementos de dados \u00e0 sua solicita\u00e7\u00e3o de pagamento como um objeto JSON convertido em uma sequ\u00eancia codificada em Base64:<\/p>\n<ol>\n<li>\n<p>Crie um objeto JSON com os elementos de dados que voc\u00ea deseja transmitir.<\/p>\n<p>Neste exemplo, usamos um conjunto limitado de dados:<\/p>\n<ul>\n<li>Todas as informa\u00e7\u00f5es da aplica\u00e7\u00e3o.<\/li>\n<li>E-mail e refer\u00eancia do cliente.<\/li>\n<li>Duas op\u00e7\u00f5es tender : <code>ReceiptHandler<\/code> para imprimir o recibo na caixa registradora e <code>AskGratuity<\/code> para pedir uma gorjeta.<\/li>\n<\/ul>\n<p>Portanto, o objeto JSON ficar\u00e1 assim:<\/p>\n<pre><code class=\"language-json\">{\n    \"applicationInfo\": {\n        \"merchantApplication\": {\n            \"name\": \"Acme Adyen Connector\",\n            \"version\": \"2.0\"\n        },\n        \"externalPlatform\": {\n            \"integrator\": \"Retail Consultancy Co.\",\n            \"name\": \"Acme Corporate POS\",\n            \"version\": \"1.0.2\"\n        },\n        \"merchantDevice\": {\n            \"os\": \"Windows 10 Pro\",\n            \"osVersion\": \"1909\",\n            \"reference\": \"CASH_REGISTER_1234\"\n        }\n    },\n    \"shopperEmail\": \"S.Hopper@gmail.com\",\n    \"shopperReference\": \"CUST01_34582\",\n    \"tenderOption\": \"ReceiptHandler,AskGratuity\"\n}<\/code><\/pre>\n<\/li>\n<li>\n<p>Codifique o objeto JSON para Base64.<\/p>\n<pre><code class=\"language-raw\">ICAgIHsKICAgICAgICAiYXBwbGljYXRpb25JbmZvIjogewogICAgICAgICAgICAibWVyY2hhbnRBc\nHBsaWNhdGlvbiI6IHsKICAgICAgICAgICAgICAgICJuYW1lIjogIkFjbWUgQWR5ZW4gQ29ubmVjdG\n9yIiwKICAgICAgICAgICAgICAgICJ2ZXJzaW9uIjogIjIuMCIKICAgICAgICAgICAgfSwKICAgICA\ngICAgICAgImV4dGVybmFsUGxhdGZvcm0iOiB7CiAgICAgICAgICAgICAgICAiaW50ZWdyYXRvciI6\nICJSZXRhaWwgQ29uc3VsdGFuY3kgQ28uIiwKICAgICAgICAgICAgICAgICJuYW1lIjogIkFjbWUgQ\n29ycG9yYXRlIFBPUyIsCiAgICAgICAgICAgICAgICAidmVyc2lvbiI6ICIxLjAuMiIKICAgICAgIC\nAgICAgfSwKICAgICAgICAgICAgIm1lcmNoYW50RGV2aWNlIjogewogICAgICAgICAgICAgICAgIm9\nzIjogIldpbmRvd3MgMTAgUHJvIiwKICAgICAgICAgICAgICAgICJvc1ZlcnNpb24iOiAiMTkwOSIs\nCiAgICAgICAgICAgICAgICAicmVmZXJlbmNlIjogIkNBU0hfUkVHSVNURVJfMTIzNCIKICAgICAgI\nCAgICAgfQogICAgICAgIH0sCiAgICAgICAgInNob3BwZXJFbWFpbCI6ICJTLkhvcHBlckBnbWFpbC\n5jb20iLAogICAgICAgICJzaG9wcGVyUmVmZXJlbmNlIjogIkNVU1QwMV8zNDU4MiIsCiAgICAgICA\ngInRlbmRlck9wdGlvbiI6ICJSZWNlaXB0SGFuZGxlcixBc2tHcmF0dWl0eSIKICAgIH0=<\/code><\/pre>\n<\/li>\n<li>\n<p>Crie uma solicita\u00e7\u00e3o de pagamento contendo:<\/p>\n<ul>\n<li><code>SaleData.SaletoAcquirerData<\/code>: O objeto JSON codificado em Base64.<\/li>\n<\/ul>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"''\" :id=\"'pass-add-data-base64'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"JSON\",\"content\":\"{\\n    \\\"SaleToPOIRequest\\\": {\\n        \\\"PaymentRequest\\\": {\\n            \\\"SaleData\\\": {\\n                \\\"SaleToAcquirerData\\\": \\\"ewogICAibWV0YWRhdGEiOnsKICAgICAgImVtcGxveWVlTnVtYmVyIjoiMSIKICAgfSwKICAgInNob3BwZXJTdGF0ZW1lbnQiOiJCb29rIHNob3AgLSBJU0JOIDk3ODA3MDY0MTQwMDQiLAogICAic2hvcHBlckVtYWlsIjoiUy5Ib3BwZXJAZXhhbXBsZS5jb20iLAogICAic2hvcHBlclJlZmVyZW5jZSI6IkNVU1QwMV8zNDU4MiIsCiAgICJ0ZW5kZXJPcHRpb24iOiJSZWNlaXB0SGFuZGxlcixBc2tHcmF0dWl0eSIKfQ==\\\",\\n                \\\"SaleTransactionID\\\": {\\n                    \\\"TransactionID\\\": \\\"27908\\\",\\n                    \\\"TimeStamp\\\": \\\"2020-04-08T12:08:52+00:00\\\"\\n                }\\n            },\\n            \\\"PaymentTransaction\\\": {\\n                \\\"AmountsReq\\\": {\\n                    \\\"Currency\\\": \\\"EUR\\\",\\n                    \\\"RequestedAmount\\\": 10.99\\n                }\\n            }\\n        },\\n        \\\"MessageHeader\\\": {\\n            \\\"ProtocolVersion\\\": \\\"3.0\\\",\\n            \\\"MessageClass\\\": \\\"Service\\\",\\n            \\\"MessageCategory\\\": \\\"Payment\\\",\\n            \\\"MessageType\\\": \\\"Request\\\",\\n            \\\"ServiceID\\\": \\\"692\\\",\\n            \\\"SaleID\\\": \\\"POSSystemID12346\\\",\\n            \\\"POIID\\\": \\\"e280-346403161\\\"\\n        }\\n    }\\n}\"},{\"language\":\"java\",\"tabTitle\":\"Java\",\"content\":\"String POIID = \\\"YOUR_TERMINAL_ID\\\";\\nString serviceID = \\\"YOUR_UNIQUE_ATTEMPT_ID\\\";\\nString saleID = \\\"YOUR_CASH_REGISTER_ID\\\";\\nString transactionID = \\\"YOUR_UNIQUE_TRANSACTION_ID\\\";\\n\\nSaleToPOIRequest saleToPOIRequest = new SaleToPOIRequest();\\nMessageHeader messageHeader = new MessageHeader();\\nmessageHeader.setPOIID(POIID);\\nmessageHeader.setMessageClass( MessageClassType.SERVICE );\\nmessageHeader.setMessageType( MessageType.REQUEST );\\nmessageHeader.setProtocolVersion(\\\"3.0\\\");\\nmessageHeader.setServiceID(serviceID);\\nmessageHeader.setSaleID(saleID);\\nmessageHeader.setMessageCategory( MessageCategoryType.PAYMENT );\\nsaleToPOIRequest.setMessageHeader(messageHeader);\\n\\nPaymentRequest paymentRequest = new PaymentRequest();\\nPaymentTransaction paymentTransaction = new PaymentTransaction();\\nAmountsReq amountsReq = new AmountsReq();\\namountsReq.setRequestedAmount( BigDecimal.valueOf(10.99) );\\namountsReq.setCurrency(\\\"EUR\\\");\\npaymentTransaction.setAmountsReq(amountsReq);\\n\\nTransactionConditions transactionConditions = new TransactionConditions();\\npaymentTransaction.setTransactionConditions(transactionConditions);\\npaymentRequest.setPaymentTransaction(paymentTransaction);\\n\\nSaleData saleData = new SaleData();\\nsaleData.setSaleToAcquirerData(\\\"ewogICAibWV0YWRhdGEiOnsKICAgICAgImVtcGxveWVlTnVtYmVyIjoiMSIKICAgfSwKICAgInNob3BwZXJTdGF0ZW1lbnQiOiJCb29rIHNob3AgLSBJU0JOIDk3ODA3MDY0MTQwMDQiLAogICAic2hvcHBlckVtYWlsIjoiUy5Ib3BwZXJAZXhhbXBsZS5jb20iLAogICAic2hvcHBlclJlZmVyZW5jZSI6IkNVU1QwMV8zNDU4MiIsCiAgICJ0ZW5kZXJPcHRpb24iOiJSZWNlaXB0SGFuZGxlcixBc2tHcmF0dWl0eSIKfQ==\\\");\\nsaleData.setTokenRequestedType( TokenRequestedType.CUSTOMER );\\nTransactionIdentification saleTransactionID = new TransactionIdentification();\\nsaleTransactionID.setTransactionID(transactionID);\\nsaleTransactionID.setTimeStamp(DatatypeFactory.newInstance().newXMLGregorianCalendar(new GregorianCalendar()));\\nsaleData.setSaleTransactionID(saleTransactionID);\\npaymentRequest.setSaleData(saleData);\\nsaleToPOIRequest.setPaymentRequest(paymentRequest);\\nterminalAPIRequest.setSaleToPOIRequest(saleToPOIRequest);\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>Observe que a resposta de pagamento possui um <code>AdditionalResponse<\/code> no mesmo formato que o campo <code>SaleToAcquirerData<\/code>: Uma sequ\u00eancia codificada em Base64.<\/p>\n<\/li>\n<li>\n<p>Decodifique a sequ\u00eancia Base64 no campo <code>AdditionalResponse<\/code>da resposta de pagamento.<br \/>\nObserve que este cont\u00e9m:<\/p>\n<ul>\n<li>O <code>shopperReference<\/code> e <code>shopperEmail<\/code> enviados na solicita\u00e7\u00e3o.<\/li>\n<li>Dados resultantes do processamento do pagamento.<\/li>\n<\/ul>\n<pre><code class=\"language-json\">{\n    \"tid\": \"46403161\",\n    \"AID\": \"A000000004101002\",\n    \"transactionType\": \"GOODS_SERVICES\",\n    \"transactionLanguage\": \"fr\",\n    \"backendGiftcardIndicator\": \"false\",\n    \"posadditionalamounts.originalAmountValue\": \"1099\",\n    \"expiryYear\": \"2028\",\n    \"acquirerAccountCode\": \"TestPmmAcquirerAccount\",\n    \"alias\": \"A373176724022941\",\n    \"posAmountGratuityValue\": \"100\",\n    \"gratuityAmount\": \"100\",\n    \"giftcardIndicator\": \"false\",\n    \"authorisedAmountValue\": \"1199\",\n    \"pspReference\": \"8525863405367252\",\n    \"cardHolderName\": \"TC04_MC_Approved_DCC\",\n    \"paymentMethodVariant\": \"mc\",\n    \"refusalReasonRaw\": \"APPROVED\",\n    \"authorisationMid\": \"1000\",\n    \"applicationPreferredName\": \"mc f\",\n    \"acquirerCode\": \"TestPmmAcquirer\",\n    \"store\": \"StoreOne\",\n    \"txtime\": \"12:08:36\",\n    \"iso8601TxDate\": \"2020-04-08T10:08:36.0000000+0000\",\n    \"cardType\": \"mc\",\n    \"posOriginalAmountValue\": \"1099\",\n    \"offline\": \"false\",\n    \"aliasType\": \"Default\",\n    \"recurring.shopperReference\": \"CUST01_34582\",\n    \"txdate\": \"08-04-2020\",\n    \"paymentMethod\": \"mc\",\n    \"cvcResult\": \"0 Unknown\",\n    \"authorisedAmountCurrency\": \"EUR\",\n    \"shopperReference\": \"CUST01_34582\",\n    \"shopperEmail\": \"S.Hopper@gmail.com\",\n    \"tc\": \"C7ADE47CED2E180D\",\n    \"avsResult\": \"0 Unknown\",\n    \"cardIssueNumber\": \"53\",\n    \"mid\": \"1000\",\n    \"merchantReference\": \"27908\",\n    \"transactionReferenceNumber\": \"8525863405367252\",\n    \"applicationLabel\": \"MCDCCFR\",\n    \"expiryMonth\": \"02\",\n    \"cardSummary\": \"9990\",\n    \"posadditionalamounts.originalAmountCurrency\": \"EUR\",\n    \"posAuthAmountCurrency\": \"EUR\",\n    \"cardHolderVerificationMethodResults\": \"440002\",\n    \"authCode\": \"123456\",\n    \"cardIssuerCountryId\": \"840\",\n    \"adjustAuthorisationData\": \"BQABAQB3u8msnEnODzDEMNkLKaNW4MuEMYxLUinFzM3a0t50kcEht\\\/yV2kkt1hxKpESSdAv0H2h1\\\/GwFZefCbCeCAtE3SrvPYlwtI1URWeTzci22YThkc\\\/JzUiPB0M3jf+f0FltPHnBFdsJB6wnKkXMlmdCZzHT209QWl4rgS1+Qq3T0Yuu8\\\/E2crOpg6VRfESWL8U4v5arASY5+p39Z43qjyuJFWIPbMGaMvGKBZGWZtmi8tr9aKUqsYyJ8jADFpuWyid3vo+XFL9LsW0pvc9MphiODyzfzi8azLosLNRuzZBf+B9yKByDKiGpV6CZ59ECi0nNGvM\\\/hYZtuhvHUnANYz6nzECD8IbBX\\\/4pGiYqJUBWd4n8AAAa8+DKQstiNIRJaSl+18GvUnYLpwoyEHsnJTdYQPMtK0RIVC0PZ5R5R\\\/XB9Yw5LfL5n7Owxau91lIiy5DQLUFN9eV2Q0MmTRJTj1jprHRnEIV1haoQqWJbeJVf4fRjmuPuJtg5HnwJXesC\\\/blC8lkvCZ9WIjsliLi2rlQ6HnOQjGyFVndV3a8AhZrkteJ1n8Ik6iaZdUjRUWGXIUpT2F2fvUXUyO4HdVilALhJRSzX+DMOK23NpExIRpUZFj9dJKjmZmIRTwmY6Cm2scR\\\/4hr7jXeFwHYRsDOSWfEy2ZvYlqtYaFoAjiLtq2ujb5kW93uYr1zf2EAHJqkHFFLX1A0QDOXbkx0Fj6Rl27IvYq72Mmzd6tbJFYLcJ73zEkcfFiVS8JEgwvr0\\\/+vdcAKNOhvt\\\/tRPWnfZO0sTD7dR7EvM567UDvxUEhtc2MUhYWlDeiMjkMhANl4Qf1ixMdhHnqvW0D8lKvlZFhKJLH0RmKsmX+ombCp5KlCbucAwUi\\\/Vetq3dGw==\",\n    \"posAmountCashbackValue\": \"0\",\n    \"posEntryMode\": \"ICC\",\n    \"fundingSource\": \"CREDIT\",\n    \"issuerCountry\": \"US\",\n    \"cardScheme\": \"mc\",\n    \"cardBin\": \"541333\",\n    \"posAuthAmountValue\": \"1199\",\n    \"posadditionalamounts.gratuityAmount\": \"100\"\n}<\/code><\/pre>\n<\/li>\n<\/ol>\n<h2 id=\"key-value-pairs\">Op\u00e7\u00e3o 2: enviar elementos de dados como pares de valor-chave<\/h2>\n<p>Este exemplo mostra como adicionar elementos de dados \u00e0 sua solicita\u00e7\u00e3o de pagamento como pares de valor-chave codificado em formul\u00e1rio.<\/p>\n<ol>\n<li>\n<p>Crie uma sequ\u00eancia com os elementos de dados que voc\u00ea deseja passar em pares de valores-chave, usando <strong>&amp;<\/strong> como separador entre os pares.<\/p>\n<p>Neste exemplo, usamos um conjunto limitado de dados:<\/p>\n<ul>\n<li>All application information:<br \/>\n<code>applicationInfo.merchantApplication.name=Acme Adyen Connector<\/code><br \/>\n<code>applicationInfo.merchantApplication.version=2.0<\/code><br \/>\n<code>applicationInfo.externalPlatform.integrator=Retail Consultancy Co.<\/code><br \/>\n<code>applicationInfo.externalPlatform.name=Acme Corporate POS<\/code><br \/>\n<code>applicationInfo.externalPlatform.version=1.0.2<\/code><br \/>\n<code>applicationInfo.merchantDevice.os=Windows 10 Pro<\/code><br \/>\n<code>applicationInfo.merchantDevice.osVersion=1990<\/code><br \/>\n<code>applicationInfo.merchantDevice.reference=CASH_REGISTER_1234<\/code><\/li>\n<li>Shopper email and shopper reference:<br \/>\n<code>shopperEmail=S.Hopper@gmail.com<\/code> and <code>shopperReference=CUST01_34582<\/code><\/li>\n<li>Two tender options to let the POS app handle printing or sending the receipt, and to ask for a tip:<br \/>\n<code>tenderOption=ReceiptHandler,AskGratuity<\/code><\/li>\n<\/ul>\n<p>Portanto, a string ficar\u00e1 assim:<\/p>\n<pre><code class=\"language-raw\">applicationInfo.merchantApplication.name=Acme Adyen Connector&amp;applicationInfo\n.merchantApplication.version=2.0&amp;applicationInfo.externalPlatform.integrator=\nRetail Consultancy Co.&amp;applicationInfo.externalPlatform.name=Acme Corporate P\nOS&amp;applicationInfo.externalPlatform.version=1.0.2&amp;applicationInfo.merchantDev\nice.os=Windows 10 Pro&amp;applicationInfo.merchantDevice.osVersion=1990&amp;applicati\nonInfo.merchantDevice.reference=CASH_REGISTER_1234&amp;shopperEmail=S.Hopper@gmai\nl.com&amp;shopperReference=CUST01_34582&amp;tenderOption=ReceiptHandler,AskGratuity<\/code><\/pre>\n<\/li>\n<li>\n<p>Fa\u00e7a um pedido de pagamento com:<\/p>\n<ul>\n<li><code>SaleData.SaletoAcquirerData<\/code>: Sua sequ\u00eancia de pares de valores-chave codificados em formul\u00e1rio.<\/li>\n<\/ul>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"''\" :id=\"'pass-add-data-key-value'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"JSON\",\"content\":\"{\\n    \\\"SaleToPOIRequest\\\": {\\n        \\\"PaymentRequest\\\": {\\n            \\\"SaleData\\\": {\\n                \\\"SaleToAcquirerData\\\": \\\"metadata.employeeNumber=1&amp;shopperStatement=Book shop - ISBN 9780706414004&amp;shopperEmail=S.Hopper@example.com&amp;shopperReference=CUST01_34582&amp;tenderOption=ReceiptHandler,AskGratuity\\\",\\n                \\\"SaleTransactionID\\\": {\\n                    \\\"TransactionID\\\": \\\"27908\\\",\\n                    \\\"TimeStamp\\\": \\\"2023-01-24T11:56:38.471Z\\\"\\n                }\\n            },\\n            \\\"PaymentTransaction\\\": {\\n                \\\"AmountsReq\\\": {\\n                    \\\"Currency\\\": \\\"EUR\\\",\\n                    \\\"RequestedAmount\\\": 10.99\\n                }\\n            }\\n        },\\n        \\\"MessageHeader\\\": {\\n            \\\"ProtocolVersion\\\": \\\"3.0\\\",\\n            \\\"MessageClass\\\": \\\"Service\\\",\\n            \\\"MessageCategory\\\": \\\"Payment\\\",\\n            \\\"MessageType\\\": \\\"Request\\\",\\n            \\\"ServiceID\\\": \\\"811\\\",\\n            \\\"SaleID\\\": \\\"POSSystemID12346\\\",\\n            \\\"POIID\\\": \\\"e280-346403161\\\"\\n        }\\n    }\\n}\"},{\"language\":\"java\",\"tabTitle\":\"Java\",\"content\":\"String POIID = \\\"YOUR_TERMINAL_ID\\\";\\nString serviceID = \\\"YOUR_UNIQUE_ATTEMPT_ID\\\";\\nString saleID = \\\"YOUR_CASH_REGISTER_ID\\\";\\nString transactionID = \\\"YOUR_UNIQUE_TRANSACTION_ID\\\";\\n\\nSaleToPOIRequest saleToPOIRequest = new SaleToPOIRequest();\\nMessageHeader messageHeader = new MessageHeader();\\nmessageHeader.setPOIID(POIID);\\nmessageHeader.setMessageClass( MessageClassType.SERVICE );\\nmessageHeader.setMessageType( MessageType.REQUEST );\\nmessageHeader.setProtocolVersion(\\\"3.0\\\");\\nmessageHeader.setServiceID(serviceID);\\nmessageHeader.setSaleID(saleID);\\nmessageHeader.setMessageCategory( MessageCategoryType.PAYMENT );\\nsaleToPOIRequest.setMessageHeader(messageHeader);\\n\\nPaymentRequest paymentRequest = new PaymentRequest();\\nPaymentTransaction paymentTransaction = new PaymentTransaction();\\nAmountsReq amountsReq = new AmountsReq();\\namountsReq.setRequestedAmount( BigDecimal.valueOf(10.99) );\\namountsReq.setCurrency(\\\"EUR\\\");\\npaymentTransaction.setAmountsReq(amountsReq);\\n\\nTransactionConditions transactionConditions = new TransactionConditions();\\npaymentTransaction.setTransactionConditions(transactionConditions);\\npaymentRequest.setPaymentTransaction(paymentTransaction);\\n\\nSaleData saleData = new SaleData();\\nsaleData.setSaleToAcquirerData(\\\"metadata.employeeNumber=1&amp;shopperStatement=Book shop - ISBN 9780706414004&amp;shopperEmail=S.Hopper@example.com&amp;shopperReference=CUST01_34582&amp;tenderOption=ReceiptHandler,AskGratuity\\\");\\nsaleData.setTokenRequestedType( TokenRequestedType.CUSTOMER );\\nTransactionIdentification saleTransactionID = new TransactionIdentification();\\nsaleTransactionID.setTransactionID(transactionID);\\nsaleTransactionID.setTimeStamp(DatatypeFactory.newInstance().newXMLGregorianCalendar(new GregorianCalendar()));\\nsaleData.setSaleTransactionID(saleTransactionID);\\npaymentRequest.setSaleData(saleData);\\nsaleToPOIRequest.setPaymentRequest(paymentRequest);\\nterminalAPIRequest.setSaleToPOIRequest(saleToPOIRequest);\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>Observe que a resposta do pagamento tem a <code>AdditionalResponse<\/code> no mesmo formato do <code>SaleToAcquirerData<\/code>: valores-chave codificados em formul\u00e1rio. Este cont\u00e9m:<\/p>\n<ul>\n<li>O <code>shopperReference<\/code> e <code>shopperEmail<\/code> enviados na solicita\u00e7\u00e3o.<\/li>\n<li>Dados resultantes do processamento do pagamento.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\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\/add-data\/sale-to-acquirer-data\"\n                        target=\"_self\"\n                        >\n                    Exemplos de SaleToAcquirerData\n                <\/a><\/li><li><a href=\"\/point-of-sale\/add-data\/pass-application-information\"\n                        target=\"_self\"\n                        >\n                    Enviar informa\u00e7\u00f5es da aplica\u00e7\u00e3o\n                <\/a><\/li><li><a href=\"\/point-of-sale\/add-data\/tender-options\"\n                        target=\"_self\"\n                        >\n                    Enviar tender options\n                <\/a><\/li><li><a href=\"\/point-of-sale\/shopper-recognition\"\n                        target=\"_self\"\n                        >\n                    Reconhecimento de clientes e tokeniza\u00e7\u00e3o\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/add-data","articleFields":{"description":"Envie-nos elementos de dados extras, como informa\u00e7\u00f5es da aplica\u00e7\u00e3o, op\u00e7\u00f5es tender e dados adicionais.","id":"36180508","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"12-06-2020 17:32"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/add-data","title":"Adicionar informa\u00e7\u00f5es a um pagamento","content":"Em uma solicita\u00e7\u00e3o b\u00e1sica de pagamento da API de terminais, voc\u00ea s\u00f3 precisa especificar o valor, a moeda, o ID e a data e hora da transa\u00e7\u00e3o. Mas talvez voc\u00ea queira adicionar as informa\u00e7\u00f5es que deseja aplicar \u00e0 sua solicita\u00e7\u00e3o ou salvar na plataforma de pagamentos da Adyen. O campo SaleToAcquirerData permite que voc\u00ea fa\u00e7a isso. Nesse campo, voc\u00ea pode adicionar todos os tipos de elementos de dados:\n\nInforma\u00e7\u00f5es da aplica\u00e7\u00e3o que podemos usar para fins de solu\u00e7\u00e3o de problemas.\nMetadata de sua pr\u00f3pria escolha que voc\u00ea deseja conectar ao pagamento.\nDados para permitir o reconhecimento do cliente e tokeniza\u00e7\u00e3o.\nOp\u00e7\u00f5es Tender para influenciar como a transa\u00e7\u00e3o \u00e9 processada.\nDados adicionais para casos de uso comuns. Por exemplo, para pagamentos divididos e pr\u00e9-autoriza\u00e7\u00e3o.\n\nConsulte exemplos de SaleToAcquirerData para ver como s\u00e3o esses elementos de dados. Abaixo, os descrevemos com mais detalhes e explicamos como adicionar uma combina\u00e7\u00e3o de elementos de dados \u00e0 sua solicita\u00e7\u00e3o de pagamento.\nInforma\u00e7\u00f5es da aplica\u00e7\u00e3o\nAs informa\u00e7\u00f5es da aplica\u00e7\u00e3o consistem em elementos de dados que identificam o software usado para fazer solicita\u00e7\u00f5es de pagamento para a plataforma de pagamentos da Adyen. Quando voc\u00ea inclui informa\u00e7\u00f5es da aplica\u00e7\u00e3o em suas solicita\u00e7\u00f5es de pagamento, podemos analisar e solucionar problemas de pagamentos com mais efici\u00eancia e fornecer uma melhor experi\u00eancia de suporte.\nFPara obter mais informa\u00e7\u00f5es, consulte Enviar informa\u00e7\u00f5es da aplica\u00e7\u00e3o.\nMetadata\nMetadata s\u00e3o elementos de dados que voc\u00ea mesmo cria. Quando voc\u00ea adiciona metadados \u00e0 sua solicita\u00e7\u00e3o de pagamento, eles s\u00e3o ecoados na resposta para que voc\u00ea possa conectar a transa\u00e7\u00e3o aos seus metadata. Por exemplo, para adicionar um n\u00famero de turno e um ID de funcion\u00e1rio a um pagamento. Voc\u00ea pode criar at\u00e9 20 campos metadata, onde o m\u00e1ximo do campo de nome \u00e9 20 caracteres e o valor m\u00e1ximo 80 caracteres.\nPara tamb\u00e9m receber metadata em seus relat\u00f3rios de liquida\u00e7\u00e3o, entre em contato com nossa Support Team.\nDados para permitir o reconhecimento do cliente e tokeniza\u00e7\u00e3o\nCom base nos identificadores de clientes que voc\u00ea recebe na resposta de pagamento, \u00e9 poss\u00edvel vincular o pagamento a um cliente. Isso permite que voc\u00ea personalize a experi\u00eancia de compra ou fa\u00e7a pagamentos recorrentes usando um token em vez de detalhes reais do cart\u00e3o. Mas primeiro voc\u00ea precisa criar esses identificadores de clientes e armazen\u00e1-los na plataforma de pagamentos da Adyen. Para fazer isso, voc\u00ea inclui elementos de dados como shopperEmail, shopperReference, e recurringProcessingModel no campo SaleToAcquirerData de seu pedido de pagamento inicial.\nPara obter mais informa\u00e7\u00f5es, consulte Reconhecimento de clientes e tokeniza\u00e7\u00e3o.\nOp\u00e7\u00f5es Tender\nBy adding one or more tender options to a payment request, you influence how that transaction is processed. Por exemplo, voc\u00ea pode enviar a  op\u00e7\u00e3o tende AskGratuity para mostrar op\u00e7\u00f5es de gorjeta no terminal de pagamento.\nPara obter mais inform\u00e7\u00f5es, consulte Enviar op\u00e7\u00f5eas tender.\nDados adicionais\nExistem muitos elementos de dados adicionais que voc\u00ea pode adicionar \u00e0s suas solicita\u00e7\u00f5es de pagamento. A lista \u00e9 longa e crescente, por isso n\u00e3o podemos mencionar todas elas aqui. Veja, por exemplo, Dados adicionais em nosso API Explorer. Muitos desses elementos tamb\u00e9m se aplicam a pagamentos na loja.\nAIncluindo elementos de dados em sua solicita\u00e7\u00e3o\nExistem duas maneiras de transmitir elementos de dados no campio SaleToAcquirerData da sua solicita\u00e7\u00e3o de pagamento:\n\nOption 1: Como um objeto JSON convertido em uma sequ\u00eancia codificada em Base64.\nOption 2: Como pares de valores-chave codificados em formul\u00e1rio (usando &amp; como separador).\n\nConsulte exemplos de SaleToAcquirerData para ver como s\u00e3o esses formatos.\nO formato do SaleToAcquirerData determina o formato do AdditionalResponse que voc\u00ea recebe.\nRecebendo a resposta adicional\nA AdditionalResponse em sua resposta de pagamento retorna informa\u00e7\u00f5es resultantes do processamento de sua solicita\u00e7\u00e3o de pagamento. Ele tamb\u00e9m ecoa algumas das informa\u00e7\u00f5es que voc\u00ea adicionou \u00e0 sua solicita\u00e7\u00e3o de pagamento, para que voc\u00ea possa us\u00e1-las na sua l\u00f3gica de neg\u00f3cios.\nA resposta adicional pode conter muitos campos de dados, mas talvez voc\u00ea n\u00e3o precise de todos eles. Para selecionar os dados que voc\u00ea deseja:\n\nNa sua \u00e1rea de cliente, acesse  Developers &gt; API URLs.\nSelecione as op\u00e7\u00f5es para o tipo de dados que voc\u00ea deseja receber.\n\nO formato da AdditionalResponse corresponde ao formato da SaleToAcquirerData na solicita\u00e7\u00e3o de pagamento: Um objeto JSON codificado em Base64 ou pares de valores-chave codificados em formul\u00e1rio.\nSe a solicita\u00e7\u00e3o n\u00e3o contiver nenhuma SaleToAcquirerData, a AdditionalResponse estar\u00e1 no formato de pares de valores-chave.\nOp\u00e7\u00e3o 1: enviar elementos de dados como JSON codificado em Base64\nEste exemplo mostra como adicionar elementos de dados \u00e0 sua solicita\u00e7\u00e3o de pagamento como um objeto JSON convertido em uma sequ\u00eancia codificada em Base64:\n\n\nCrie um objeto JSON com os elementos de dados que voc\u00ea deseja transmitir.\nNeste exemplo, usamos um conjunto limitado de dados:\n\nTodas as informa\u00e7\u00f5es da aplica\u00e7\u00e3o.\nE-mail e refer\u00eancia do cliente.\nDuas op\u00e7\u00f5es tender : ReceiptHandler para imprimir o recibo na caixa registradora e AskGratuity para pedir uma gorjeta.\n\nPortanto, o objeto JSON ficar\u00e1 assim:\n{\n    \"applicationInfo\": {\n        \"merchantApplication\": {\n            \"name\": \"Acme Adyen Connector\",\n            \"version\": \"2.0\"\n        },\n        \"externalPlatform\": {\n            \"integrator\": \"Retail Consultancy Co.\",\n            \"name\": \"Acme Corporate POS\",\n            \"version\": \"1.0.2\"\n        },\n        \"merchantDevice\": {\n            \"os\": \"Windows 10 Pro\",\n            \"osVersion\": \"1909\",\n            \"reference\": \"CASH_REGISTER_1234\"\n        }\n    },\n    \"shopperEmail\": \"S.Hopper@gmail.com\",\n    \"shopperReference\": \"CUST01_34582\",\n    \"tenderOption\": \"ReceiptHandler,AskGratuity\"\n}\n\n\nCodifique o objeto JSON para Base64.\nICAgIHsKICAgICAgICAiYXBwbGljYXRpb25JbmZvIjogewogICAgICAgICAgICAibWVyY2hhbnRBc\nHBsaWNhdGlvbiI6IHsKICAgICAgICAgICAgICAgICJuYW1lIjogIkFjbWUgQWR5ZW4gQ29ubmVjdG\n9yIiwKICAgICAgICAgICAgICAgICJ2ZXJzaW9uIjogIjIuMCIKICAgICAgICAgICAgfSwKICAgICA\ngICAgICAgImV4dGVybmFsUGxhdGZvcm0iOiB7CiAgICAgICAgICAgICAgICAiaW50ZWdyYXRvciI6\nICJSZXRhaWwgQ29uc3VsdGFuY3kgQ28uIiwKICAgICAgICAgICAgICAgICJuYW1lIjogIkFjbWUgQ\n29ycG9yYXRlIFBPUyIsCiAgICAgICAgICAgICAgICAidmVyc2lvbiI6ICIxLjAuMiIKICAgICAgIC\nAgICAgfSwKICAgICAgICAgICAgIm1lcmNoYW50RGV2aWNlIjogewogICAgICAgICAgICAgICAgIm9\nzIjogIldpbmRvd3MgMTAgUHJvIiwKICAgICAgICAgICAgICAgICJvc1ZlcnNpb24iOiAiMTkwOSIs\nCiAgICAgICAgICAgICAgICAicmVmZXJlbmNlIjogIkNBU0hfUkVHSVNURVJfMTIzNCIKICAgICAgI\nCAgICAgfQogICAgICAgIH0sCiAgICAgICAgInNob3BwZXJFbWFpbCI6ICJTLkhvcHBlckBnbWFpbC\n5jb20iLAogICAgICAgICJzaG9wcGVyUmVmZXJlbmNlIjogIkNVU1QwMV8zNDU4MiIsCiAgICAgICA\ngInRlbmRlck9wdGlvbiI6ICJSZWNlaXB0SGFuZGxlcixBc2tHcmF0dWl0eSIKICAgIH0=\n\n\nCrie uma solicita\u00e7\u00e3o de pagamento contendo:\n\nSaleData.SaletoAcquirerData: O objeto JSON codificado em Base64.\n\n\n\n\nObserve que a resposta de pagamento possui um AdditionalResponse no mesmo formato que o campo SaleToAcquirerData: Uma sequ\u00eancia codificada em Base64.\n\n\nDecodifique a sequ\u00eancia Base64 no campo AdditionalResponseda resposta de pagamento.\nObserve que este cont\u00e9m:\n\nO shopperReference e shopperEmail enviados na solicita\u00e7\u00e3o.\nDados resultantes do processamento do pagamento.\n\n{\n    \"tid\": \"46403161\",\n    \"AID\": \"A000000004101002\",\n    \"transactionType\": \"GOODS_SERVICES\",\n    \"transactionLanguage\": \"fr\",\n    \"backendGiftcardIndicator\": \"false\",\n    \"posadditionalamounts.originalAmountValue\": \"1099\",\n    \"expiryYear\": \"2028\",\n    \"acquirerAccountCode\": \"TestPmmAcquirerAccount\",\n    \"alias\": \"A373176724022941\",\n    \"posAmountGratuityValue\": \"100\",\n    \"gratuityAmount\": \"100\",\n    \"giftcardIndicator\": \"false\",\n    \"authorisedAmountValue\": \"1199\",\n    \"pspReference\": \"8525863405367252\",\n    \"cardHolderName\": \"TC04_MC_Approved_DCC\",\n    \"paymentMethodVariant\": \"mc\",\n    \"refusalReasonRaw\": \"APPROVED\",\n    \"authorisationMid\": \"1000\",\n    \"applicationPreferredName\": \"mc f\",\n    \"acquirerCode\": \"TestPmmAcquirer\",\n    \"store\": \"StoreOne\",\n    \"txtime\": \"12:08:36\",\n    \"iso8601TxDate\": \"2020-04-08T10:08:36.0000000+0000\",\n    \"cardType\": \"mc\",\n    \"posOriginalAmountValue\": \"1099\",\n    \"offline\": \"false\",\n    \"aliasType\": \"Default\",\n    \"recurring.shopperReference\": \"CUST01_34582\",\n    \"txdate\": \"08-04-2020\",\n    \"paymentMethod\": \"mc\",\n    \"cvcResult\": \"0 Unknown\",\n    \"authorisedAmountCurrency\": \"EUR\",\n    \"shopperReference\": \"CUST01_34582\",\n    \"shopperEmail\": \"S.Hopper@gmail.com\",\n    \"tc\": \"C7ADE47CED2E180D\",\n    \"avsResult\": \"0 Unknown\",\n    \"cardIssueNumber\": \"53\",\n    \"mid\": \"1000\",\n    \"merchantReference\": \"27908\",\n    \"transactionReferenceNumber\": \"8525863405367252\",\n    \"applicationLabel\": \"MCDCCFR\",\n    \"expiryMonth\": \"02\",\n    \"cardSummary\": \"9990\",\n    \"posadditionalamounts.originalAmountCurrency\": \"EUR\",\n    \"posAuthAmountCurrency\": \"EUR\",\n    \"cardHolderVerificationMethodResults\": \"440002\",\n    \"authCode\": \"123456\",\n    \"cardIssuerCountryId\": \"840\",\n    \"adjustAuthorisationData\": \"BQABAQB3u8msnEnODzDEMNkLKaNW4MuEMYxLUinFzM3a0t50kcEht\\\/yV2kkt1hxKpESSdAv0H2h1\\\/GwFZefCbCeCAtE3SrvPYlwtI1URWeTzci22YThkc\\\/JzUiPB0M3jf+f0FltPHnBFdsJB6wnKkXMlmdCZzHT209QWl4rgS1+Qq3T0Yuu8\\\/E2crOpg6VRfESWL8U4v5arASY5+p39Z43qjyuJFWIPbMGaMvGKBZGWZtmi8tr9aKUqsYyJ8jADFpuWyid3vo+XFL9LsW0pvc9MphiODyzfzi8azLosLNRuzZBf+B9yKByDKiGpV6CZ59ECi0nNGvM\\\/hYZtuhvHUnANYz6nzECD8IbBX\\\/4pGiYqJUBWd4n8AAAa8+DKQstiNIRJaSl+18GvUnYLpwoyEHsnJTdYQPMtK0RIVC0PZ5R5R\\\/XB9Yw5LfL5n7Owxau91lIiy5DQLUFN9eV2Q0MmTRJTj1jprHRnEIV1haoQqWJbeJVf4fRjmuPuJtg5HnwJXesC\\\/blC8lkvCZ9WIjsliLi2rlQ6HnOQjGyFVndV3a8AhZrkteJ1n8Ik6iaZdUjRUWGXIUpT2F2fvUXUyO4HdVilALhJRSzX+DMOK23NpExIRpUZFj9dJKjmZmIRTwmY6Cm2scR\\\/4hr7jXeFwHYRsDOSWfEy2ZvYlqtYaFoAjiLtq2ujb5kW93uYr1zf2EAHJqkHFFLX1A0QDOXbkx0Fj6Rl27IvYq72Mmzd6tbJFYLcJ73zEkcfFiVS8JEgwvr0\\\/+vdcAKNOhvt\\\/tRPWnfZO0sTD7dR7EvM567UDvxUEhtc2MUhYWlDeiMjkMhANl4Qf1ixMdhHnqvW0D8lKvlZFhKJLH0RmKsmX+ombCp5KlCbucAwUi\\\/Vetq3dGw==\",\n    \"posAmountCashbackValue\": \"0\",\n    \"posEntryMode\": \"ICC\",\n    \"fundingSource\": \"CREDIT\",\n    \"issuerCountry\": \"US\",\n    \"cardScheme\": \"mc\",\n    \"cardBin\": \"541333\",\n    \"posAuthAmountValue\": \"1199\",\n    \"posadditionalamounts.gratuityAmount\": \"100\"\n}\n\n\nOp\u00e7\u00e3o 2: enviar elementos de dados como pares de valor-chave\nEste exemplo mostra como adicionar elementos de dados \u00e0 sua solicita\u00e7\u00e3o de pagamento como pares de valor-chave codificado em formul\u00e1rio.\n\n\nCrie uma sequ\u00eancia com os elementos de dados que voc\u00ea deseja passar em pares de valores-chave, usando &amp; como separador entre os pares.\nNeste exemplo, usamos um conjunto limitado de dados:\n\nAll application information:\napplicationInfo.merchantApplication.name=Acme Adyen Connector\napplicationInfo.merchantApplication.version=2.0\napplicationInfo.externalPlatform.integrator=Retail Consultancy Co.\napplicationInfo.externalPlatform.name=Acme Corporate POS\napplicationInfo.externalPlatform.version=1.0.2\napplicationInfo.merchantDevice.os=Windows 10 Pro\napplicationInfo.merchantDevice.osVersion=1990\napplicationInfo.merchantDevice.reference=CASH_REGISTER_1234\nShopper email and shopper reference:\nshopperEmail=S.Hopper@gmail.com and shopperReference=CUST01_34582\nTwo tender options to let the POS app handle printing or sending the receipt, and to ask for a tip:\ntenderOption=ReceiptHandler,AskGratuity\n\nPortanto, a string ficar\u00e1 assim:\napplicationInfo.merchantApplication.name=Acme Adyen Connector&amp;applicationInfo\n.merchantApplication.version=2.0&amp;applicationInfo.externalPlatform.integrator=\nRetail Consultancy Co.&amp;applicationInfo.externalPlatform.name=Acme Corporate P\nOS&amp;applicationInfo.externalPlatform.version=1.0.2&amp;applicationInfo.merchantDev\nice.os=Windows 10 Pro&amp;applicationInfo.merchantDevice.osVersion=1990&amp;applicati\nonInfo.merchantDevice.reference=CASH_REGISTER_1234&amp;shopperEmail=S.Hopper@gmai\nl.com&amp;shopperReference=CUST01_34582&amp;tenderOption=ReceiptHandler,AskGratuity\n\n\nFa\u00e7a um pedido de pagamento com:\n\nSaleData.SaletoAcquirerData: Sua sequ\u00eancia de pares de valores-chave codificados em formul\u00e1rio.\n\n\n\n\nObserve que a resposta do pagamento tem a AdditionalResponse no mesmo formato do SaleToAcquirerData: valores-chave codificados em formul\u00e1rio. Este cont\u00e9m:\n\nO shopperReference e shopperEmail enviados na solicita\u00e7\u00e3o.\nDados resultantes do processamento do pagamento.\n\n\n\nVeja tamb\u00e9m\n\n\n                    Exemplos de SaleToAcquirerData\n                \n                    Enviar informa\u00e7\u00f5es da aplica\u00e7\u00e3o\n                \n                    Enviar tender options\n                \n                    Reconhecimento de clientes e tokeniza\u00e7\u00e3o\n                \n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Adicionar informa\u00e7\u00f5es a um pagamento"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/point-of-sale","lvl2":"\/pt\/point-of-sale\/add-data"},"levels":3,"category":"In-person payments","category_color":"green","tags":["Adicionar","informa\u00e7\u00f5es","pagamento"]},"articleFiles":{"pass-add-data-base64.json":"<p alt=\"\">pass-add-data-base64.json<\/p>","pass-add-data-key-value.json":"<p alt=\"\">pass-add-data-key-value.json<\/p>"}}
