{"title":"NFC wallet passes","category":"default","creationDate":1596005760,"content":"<p>Os clientes podem vincular seus cart\u00f5es de cr\u00e9dito e d\u00e9bito a um aplicativo de carteira m\u00f3vel e, em seguida, fazer pagamentos na loja com a carteira m\u00f3vel usando um servi\u00e7o como o Apple Pay. O terminal faz interface com a carteira m\u00f3vel por meio de comunica\u00e7\u00e3o por aproxima\u00e7\u00e3o (NFC) entre o terminal e o telefone ou smartwatch do comprador.<\/p>\n<p>Al\u00e9m dos cart\u00f5es de cr\u00e9dito e d\u00e9bito, os clientes tamb\u00e9m podem manter outros passes em sua carteira m\u00f3vel, como cart\u00f5es de fidelidade, vouchers, cart\u00f5es-presente, cart\u00f5es de embarque e passagens. Com esses passes habilitados para NFC, eles podem, por exemplo, resgatar um voucher ou acumular pontos em um cart\u00e3o de fidelidade.<\/p>\n<p>Como comerciante, voc\u00ea pode criar seus pr\u00f3prios passes habilitados para NFC e vincul\u00e1-los ao seu programa de fidelidade. Com a integra\u00e7\u00e3o do Terminal API, voc\u00ea pode verificar se o comprador tem o seu passe na carteira m\u00f3vel e usar o passe para a transa\u00e7\u00e3o.<\/p>\n<p>No momento, oferecemos suporte para:<\/p>\n<ul>\n<li>Apple Wallet passes<\/li>\n<\/ul>\n<h2 id=\"how-it-works\">Como funciona<\/h2>\n<p>Existem v\u00e1rias maneiras de implementar passes habilitados para NFC com um pagamento, dependendo do que faz sentido para seu passe e programa de fidelidade:<\/p>\n<ul>\n<li><strong>Fluxo de pagamento<\/strong>: Voc\u00ea verifica os passes ap\u00f3s o pagamento e atualiza a conta do cliente posteriormente.<\/li>\n<li>\n<p><strong>Fluxo de resgate<\/strong>: Voc\u00ea verifica os passes antes do pagamento por meio de uma solicita\u00e7\u00e3o de aquisi\u00e7\u00e3o de cart\u00e3o. Se houver descontos ou outras vantagens relacionadas ao passe, voc\u00ea pode aplic\u00e1-los ao pagamento antecipado.<\/p>\n<p>Existem duas varia\u00e7\u00f5es do fluxo de resgare: <strong>single-tap redeem flow<\/strong> e <strong>double-tap redeem flow<\/strong>.  Al\u00e9m de uma defini\u00e7\u00e3o de configura\u00e7\u00e3o, a implementa\u00e7\u00e3o \u00e9 a mesma. A diferen\u00e7a \u00e9 que, no fluxo de double-tap, o terminal pede uma segunda vez ao cliente para apresentar o cart\u00e3o. Isso permite que o cliente resgate o passe NFC na primeira vez que o terminal solicitar o cart\u00e3o e, a seguir, mude para outro m\u00e9todo de pagamento na segunda vez que o terminal solicitar o cart\u00e3o.<\/p>\n<\/li>\n<\/ul>\n<p>Selecione as guias abaixo para saber mais. Antes de <a href=\"#configure-in-ca\">configurar seu passe NFC na \u00c1rea do Cliente<\/a>, voc\u00ea precisa entender como esses fluxos funcionam e qual fluxo voc\u00ea deseja implementar.<\/p>\n\n<div id=\"tabMkLiu\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Fluxo de pagamento&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;Voc\\u00ea faz uma solicita\\u00e7\\u00e3o de pagamento. Se o cliente pagar com uma carteira m\\u00f3vel habilitada para NFC, voc\\u00ea ser\\u00e1 informado na resposta do pagamento se o cliente tem o seu passe na carteira m\\u00f3vel. Se o fizerem, a resposta do pagamento incluir\\u00e1 o ID exclusivo do passe do cliente para que voc\\u00ea possa atualizar a conta do cliente.&lt;\\\/p&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;fluxo_de_pagamento_0_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Single-tap redeem flow&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;Primeiro, voc\\u00ea faz uma solicita\\u00e7\\u00e3o de aquisi\\u00e7\\u00e3o de cart\\u00e3o com um valor. O terminal pede ao cliente que apresente seu cart\\u00e3o. Quando o cliente toca seu dispositivo m\\u00f3vel habilitado para NFC no terminal de pagamento, o terminal pesquisa a carteira m\\u00f3vel no dispositivo para:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Seus passes.&lt;\\\/li&gt;\\n&lt;li&gt;Os detalhes do m\\u00e9todo de pagamento (o cart\\u00e3o de cr\\u00e9dito ou d\\u00e9bito vinculado \\u00e0 carteira).&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;Se o cliente tiver o seu passe, a resposta de aquisi\\u00e7\\u00e3o do cart\\u00e3o incluir\\u00e1 o ID exclusivo do passe do comprador para que voc\\u00ea possa consultar a conta do cliente. Voc\\u00ea pode ent\\u00e3o, por exemplo:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Fa\\u00e7a uma &lt;a href=\\&quot;\\\/pt\\\/point-of-sale\\\/shopper-engagement\\\/shopper-input\\&quot;&gt;solicita\\u00e7\\u00e3o de entrada&lt;\\\/a&gt; para perguntar ao comprador se ele deseja resgatar pontos de fidelidade.&lt;\\\/li&gt;\\n&lt;li&gt;Adicione ou recalcule pontos de fidelidade.&lt;\\\/li&gt;\\n&lt;li&gt;Aplique um desconto.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;Em seguida, voc\\u00ea faz uma solicita\\u00e7\\u00e3o de pagamento do valor final. Deve ser igual ou inferior ao valor de aquisi\\u00e7\\u00e3o do cart\\u00e3o.&lt;\\\/p&gt;\\n&lt;p&gt;Nesse fluxo, o cliente conecta seu dispositivo m\\u00f3vel ao terminal apenas uma vez, pois a aquisi\\u00e7\\u00e3o do cart\\u00e3o pesquisa os detalhes do passe e da forma de pagamento ao mesmo tempo.&lt;\\\/p&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;single-tap_redeem_flow_1_2&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Double-tap redeem flow&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;Voc\\u00ea primeiro faz uma solicita\\u00e7\\u00e3o de aquisi\\u00e7\\u00e3o de cart\\u00e3o com ou sem um valor. O terminal pede ao cliente que apresente seu cart\\u00e3o. Quando o cliente liga seu dispositivo m\\u00f3vel habilitado para NFC ao terminal de pagamento, o terminal consulta a carteira m\\u00f3vel do dispositivo para seus passes. Se o cliente tiver o seu passe, a resposta de aquisi\\u00e7\\u00e3o do cart\\u00e3o incluir\\u00e1 o ID exclusivo do passe do cliente para que voc\\u00ea possa consultar a conta do comprador. Voc\\u00ea pode ent\\u00e3o, por exemplo:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Fa\\u00e7a uma &lt;a href=\\&quot;\\\/pt\\\/point-of-sale\\\/shopper-engagement\\\/shopper-input\\&quot;&gt;solicita\\u00e7\\u00e3o de entrada&lt;\\\/a&gt; para perguntar ao cliente se ele deseja resgatar pontos de fidelidade.&lt;\\\/li&gt;\\n&lt;li&gt;icione ou recalcule pontos de fidelidade.&lt;\\\/li&gt;\\n&lt;li&gt;Aplique um desconto.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;Em seguida, voc\\u00ea faz uma solicita\\u00e7\\u00e3o de pagamento do valor final. O terminal pede ao cliente novamente para apresentar seu cart\\u00e3o. O cliente pode escolher pagar com sua carteira m\\u00f3vel e tocar seu dispositivo m\\u00f3vel no terminal uma segunda vez ou usar um m\\u00e9todo de pagamento diferente.&lt;\\\/p&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;double-tap_redeem_flow_2_3&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h3 id=\"enrollment\">Inscri\u00e7\u00e3o do cliente<\/h3>\n<p>Para permitir que os clientes se inscrevam no programa de fidelidade vinculado ao seu passe habilitado para NFC e adicionem o passe \u00e0 carteira m\u00f3vel, voc\u00ea pode inform\u00e1-los por e-mail, m\u00eddia social, seu site e assim por diante.<\/p>\n<p>Tamb\u00e9m podemos ajudar seus compradores a se inscreverem: Quando eles fazem um pagamento de carteira NFC, mas ainda n\u00e3o t\u00eam o seu passe na carteira m\u00f3vel, enviamos um sinal NFC para que os compradores recebam uma mensagem com o URL onde podem se inscrever. Para tornar isso poss\u00edvel, voc\u00ea precisa fornecer essa URL na configura\u00e7\u00e3o da sua <a href=\"#configure-in-ca\">\u00e1rea do cliente<\/a>.<\/p>\n<h2 id=\"before-you-begin\">Antes de voc\u00ea come\u00e7ar<\/h2>\n<ol>\n<li>\n<p>Configure um servidor para seus passes habilitados para NFC. Nesse servidor de passe, voc\u00ea precisa disponibilizar um URL onde os clientes possam se inscrever no programa de fidelidade vinculado ao seu passe habilitado para NFC e adicionar o passe \u00e0 carteira m\u00f3vel.<\/p>\n<div class=\"sc-notice info\"><div>\n<p>Voc\u00ea precisa especificar este URL ao configurar o passe em sua \u00e1rea do cliente.<\/p>\n<\/div><\/div>\n<\/li>\n<li>\n<p>Crie um ou mais passes habilitados para NFC. Consulte, por exemplo, o <a href=\"https:\/\/developer.apple.com\/library\/archive\/documentation\/UserExperience\/Conceptual\/PassKit_PG\/index.html#\/\/apple_ref\/doc\/uid\/TP40012195\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Guia do Desenvolvedor de Carteira<\/a>, que explica como criar um passe da Carteira Apple para o seu programa de fidelidade.<\/p>\n<div class=\"sc-notice info\"><div>\n<p>Ao criar seu passe, um ID do tipo de passe e uma chave privada s\u00e3o gerados. Voc\u00ea precisar\u00e1 deles mais tarde, quando configurar o passe em sua \u00c1rea do Cliente.<\/p>\n<\/div><\/div>\n<\/li>\n<li>\n<p>Make sure that you have built a Terminal API integration that can <a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/make-a-payment\">make a payment<\/a>.<\/p>\n<\/li>\n<li>\n<p>Tie in your loyalty program with your NFC wallet passes. To learn more about how to link a customer in your loyalty program to a transaction, see <a href=\"\/pt\/point-of-sale\/shopper-recognition\">Shopper recognition and tokenization<\/a>.<\/p>\n<\/li>\n<\/ol>\n<h2 id=\"configure-in-ca\">Configure passes habilitados para NFC em sua \u00e1rea do cliente<\/h2>\n<p>Para nos permitir obter a identifica\u00e7\u00e3o exclusiva do passe do comprador, voc\u00ea precisa nos informar sobre seu passe habilitado para NFC e o fluxo que deseja usar:<\/p>\n<ol>\n<li>\n<p>Fa\u00e7a o login na sua <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> e selecione o n\u00edvel da conta onde deseja usar o seu passe habilitado para NFC.<\/p>\n<\/li>\n<li>\n<p>V\u00e1 para <strong>In-person payments<\/strong> &gt; <strong>Terminal settings<\/strong> &gt; <strong>Payment features<\/strong>.<\/p>\n<\/li>\n<li>\n<p>Selecione <strong>View decrypted<\/strong> e v\u00e1 para <strong>Mobile wallet NFC pass services<\/strong>.<\/p>\n<\/li>\n<li>\n<p>Em <strong>Card acquisition VAS mode<\/strong>, selecione uma op\u00e7\u00e3o para o fluxo que deseja usar. Esta configura\u00e7\u00e3o determina o que o terminal tenta fazer quando voc\u00ea faz uma solicita\u00e7\u00e3o de aquisi\u00e7\u00e3o de cart\u00e3o e o comprador conecta um dispositivo com uma carteira NFC ao terminal de pagamento.<\/p>\n<ul>\n<li>\n<p>Para o <a href=\"\/pt\/point-of-sale\/loyalty\/wallet-passes\/?tab=payment_flow_1\">fluxo de pagamento<\/a> e o <a href=\"\/pt\/point-of-sale\/loyalty\/wallet-passes\/?tab=single_tap_redeem_flow_2\">fluxo single-tap redeem<\/a>, selecione <strong>VAS and payment<\/strong>. Isso obt\u00e9m os detalhes da passagem NFC e os detalhes do m\u00e9todo de pagamento NFC.<\/p>\n<\/li>\n<li>\n<p>Para o <a href=\"\/pt\/point-of-sale\/loyalty\/wallet-passes\/?tab=double_tap_redeem_flow_3\">fluxo double-tap redeem<\/a>, selecione <strong>VAS only<\/strong>. Isso obt\u00e9m os detalhes da passagem NFC quando voc\u00ea faz uma solicita\u00e7\u00e3o de aquisi\u00e7\u00e3o de cart\u00e3o.<\/p>\n<\/li>\n<li>\n<p>Existem mais duas op\u00e7\u00f5es que listamos aqui para integridade::<\/p>\n<ul>\n<li>Se voc\u00ea n\u00e3o quiser coletar os detalhes do passe NFC ao fazer uma solicita\u00e7\u00e3o de aquisi\u00e7\u00e3o de cart\u00e3o, selecione <strong>Payment only<\/strong>.<\/li>\n<li>\n<p>Para deixar a cargo do cliente se os detalhes do passe NFC s\u00e3o coletados com a solicita\u00e7\u00e3o de aquisi\u00e7\u00e3o do cart\u00e3o, selecione <strong>VAS or payment<\/strong>.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Digite o <strong>Nome<\/strong> do seu passe.<\/p>\n<\/li>\n<li>\n<p>Em <strong>Merchant pass type identifier<\/strong>, insira a ID do tipo de passe que foi gerada quando voc\u00ea criou seu passe NFC.<br \/>\nUsamos isso para pesquisar apenas o seu passe e n\u00e3o os passes de outras organiza\u00e7\u00f5es que o comprador possa ter em sua carteira m\u00f3vel. Para um passe da Apple Wallet, tem o formato <strong>pass.com.company.pass-name<\/strong>.<\/p>\n<\/li>\n<li>\n<p>Em <strong>Vendor type<\/strong>, selecione a empresa respons\u00e1vel pelo protocolo no qual seu passe NFC se baseia. Por exemplo, Apple.<\/p>\n<\/li>\n<li>\n<p>Insira o <strong>URL<\/strong> onde as pessoas podem adicionar o passe \u00e0 carteira m\u00f3vel.<br \/>\nUsamos isso quando o comprador ainda n\u00e3o tem o seu passe na carteira, para enviar um sinal NFC para que o comprador receba uma mensagem com a URL onde ele pode se inscrever.<\/p>\n<\/li>\n<li>\n<p>Na caixa <strong>Private key slot<\/strong>, selecione o slot onde voc\u00ea fornecer\u00e1 sua chave privada. Por exemplo, <em>Private key 1<\/em>.<\/p>\n<\/li>\n<li>\n<p>Em <strong>Private key slots<\/strong>, v\u00e1 para o slot que voc\u00ea selecionou na etapa anterior e insira a chave privada para o seu passe NFC.<br \/>\nEsta chave foi gerada quando voc\u00ea criou o passe. Iremos proteg\u00ea-lo e criptograf\u00e1-lo em nosso back end. O terminal usa essa chave para descriptografar a mensagem NFC e retornar o ID exclusivo do passe do comprador na resposta.<\/p>\n<\/li>\n<li>\n<p>Para adicionar mais passes habilitados para NFC, selecione <strong>Add wallet<\/strong> e repita as etapas para completar as configura\u00e7\u00f5es.<\/p>\n<\/li>\n<li>\n<p>Selecione <strong>Save<\/strong>.<\/p>\n<\/li>\n<\/ol>\n<p>Depois de concluir a configura\u00e7\u00e3o, voc\u00ea est\u00e1 pronto para aceitar seu passe habilitado para NFC com um pagamento, usando o <a href=\"#payment-flow\">fluxo de pagamento<\/a> ou o <a href=\"#redeem-flow\">fluxo de resgate<\/a>.<\/p>\n<h2 id=\"payment-flow\">Use o fluxo de pagamento<\/h2>\n<p>Para fazer uma solicita\u00e7\u00e3o de pagamento e depois atualizar a conta do passe NFC do cliente:<\/p>\n<ol>\n<li>\n<p>Fa\u00e7a um <a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/make-a-payment\">\n  <code>PaymentRequest<\/code>\n<\/a>:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><code>SaleData.TokenRequestedType<\/code><\/td>\n<td style=\"text-align: left;\"><strong>Cliente<\/strong>. Isso retorna o alias do cart\u00e3o no campo da resposta <code>TokenValue<\/code>. Se voc\u00ea n\u00e3o incluir o <code>TokenRequestedType<\/code>, o alias do cart\u00e3o ser\u00e1 retornado apenas no <code>AdditionalResponse<\/code>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"''\" :id=\"'single-tap-payment'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":[{\"name\":\"request\",\"content\":\"{\\n    \\\"SaleToPOIRequest\\\": {\\n        \\\"MessageHeader\\\": {\\n            \\\"ProtocolVersion\\\": \\\"3.0\\\",\\n            \\\"MessageClass\\\": \\\"Service\\\",\\n            \\\"MessageCategory\\\": \\\"Payment\\\",\\n            \\\"MessageType\\\": \\\"Request\\\",\\n            \\\"ServiceID\\\": \\\"s9wrxa\\\",\\n            \\\"SaleID\\\": \\\"POSSystemID12345\\\",\\n            \\\"POIID\\\": \\\"V400m-324689265\\\"\\n        },\\n        \\\"PaymentRequest\\\": {\\n            \\\"SaleData\\\": {\\n                \\\"SaleTransactionID\\\": {\\n                    \\\"TransactionID\\\": \\\"a1b2c3\\\",\\n                    \\\"TimeStamp\\\": \\\"2020-06-16T16:13:16\\\"\\n                },\\n                \\\"TokenRequestedType\\\": \\\"Customer\\\"\\n            },\\n            \\\"PaymentTransaction\\\": {\\n                \\\"AmountsReq\\\": {\\n                    \\\"Currency\\\": \\\"EUR\\\",\\n                    \\\"RequestedAmount\\\": 10.99\\n                }\\n            }\\n        }\\n    }\\n}\"},{\"name\":\"response\",\"content\":\"{\\n    \\\"SaleToPOIResponse\\\": {\\n        \\\"PaymentResponse\\\": {\\n            \\\"POIData\\\": {\\n                \\\"POITransactionID\\\": {\\n                    \\\"TimeStamp\\\": \\\"2020-06-15T16:13:16.000Z\\\",\\n                    \\\"TransactionID\\\": \\\"fanx001580400796015.8535804008080700\\\"\\n                },\\n                \\\"POIReconciliationID\\\": \\\"1000\\\"\\n            },\\n            \\\"SaleData\\\": {\\n                \\\"SaleTransactionID\\\": {\\n                    \\\"TimeStamp\\\": \\\"2020-06-15T16:13:16.000Z\\\",\\n                    \\\"TransactionID\\\": \\\"a1b2c3\\\"\\n                }\\n            },\\n            \\\"PaymentReceipt\\\": [...],\\n            \\\"PaymentResult\\\": {\\n                \\\"AuthenticationMethod\\\": [\\n                    \\\"SecuredChannel\\\"\\n                ],\\n                \\\"OnlineFlag\\\": true,\\n                \\\"PaymentAcquirerData\\\": {...},\\n                    \\\"MerchantID\\\": \\\"ADYEN_MERCHANT_ACCOUNT\\\"\\n                },\\n                \\\"PaymentInstrumentData\\\": {\\n                    \\\"CardData\\\": {\\n                        \\\"EntryMode\\\": [\\n                            \\\"Contactless\\\"\\n                        ],\\n                        \\\"PaymentToken\\\": {\\n                            \\\"TokenRequestedType\\\": \\\"Customer\\\",\\n                            \\\"TokenValue\\\": \\\"G526627978654924\\\"\\n                        },\\n                        \\\"PaymentBrand\\\": \\\"visa\\\",\\n                        \\\"MaskedPan\\\": \\\"481749 **** 1108\\\",\\n                        \\\"CardCountryCode\\\": \\\"076\\\",\\n                        \\\"SensitiveCardData\\\": {\\n                            \\\"CardSeqNumb\\\": \\\"00\\\",\\n                            \\\"ExpiryDate\\\": \\\"1223\\\"\\n                        }\\n                    },\\n                    \\\"PaymentInstrumentType\\\": \\\"Card\\\"\\n                },\\n                \\\"AmountsResp\\\": {\\n                    \\\"AuthorizedAmount\\\": 10.99,\\n                    \\\"Currency\\\": \\\"EUR\\\"\\n                }\\n            },\\n            \\\"LoyaltyResult\\\": [\\n                {\\n                    \\\"LoyaltyAccount\\\": {\\n                        \\\"LoyaltyAccountID\\\": {\\n                            \\\"IdentificationType\\\": \\\"AccountNumber\\\",\\n                            \\\"EntryMode\\\": [\\n                                \\\"Contactless\\\"\\n                            ],\\n                            \\\"LoyaltyID\\\": \\\"rEqQFLnckxJ3jCvmQoLmBh\\\"\\n                        },\\n                        \\\"LoyaltyBrand\\\": \\\"AppleVAS\\\"\\n                    }\\n                }\\n            ],\\n            \\\"Response\\\": {\\n                \\\"Result\\\": \\\"Success\\\",\\n                \\\"AdditionalResponse\\\": \\\"...\\\"\\n            }\\n        },\\n        \\\"MessageHeader\\\": {...}\\n    }\\n}\"}]}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>No <code>PaymentResponse<\/code>, observe o seguinte:<\/p>\n<p>Se a resposta n\u00e3o incluir um <code>LoyaltyResult<\/code>, o cliente ainda n\u00e3o adicionou seu passe habilitado para NFC \u00e0 carteira m\u00f3vel.<\/p>\n<\/li>\n<li>\n<p>Usando o <code>LoyaltyID<\/code> e o alias do cart\u00e3o retornado na resposta, procure o comprador em seu servidor de passes e programa de fidelidade e atualize os dados do comprador. Por exemplo, os pontos de fidelidade acumulados.<\/p>\n<\/li>\n<\/ol>\n<h2 id=\"redeem-flow\">Use o fluxo de resgate<\/h2>\n<p>Aqui, descrevemos como voc\u00ea pode primeiro verificar se o cliente tem seu passe habilitado para NFC em seu aplicativo de carteira antes de iniciar o pagamento. Isso permite que voc\u00ea aplique um desconto ou outras vantagens relacionadas ao passe.<br \/>\nSe o cliente precisa tocar em seu telefone ou smartwatch uma segunda vez para concluir o pagamento, depende da configura\u00e7\u00e3o da <a href=\"#configure-in-ca\">\u00e1re a do cliente<\/a> de seu passe.<\/p>\n<h3 id=\"redeem-card-acquisition\">Etapa 1: obtenha os detalhes do passe do cliente<\/h3>\n<ol>\n<li>\n<p>Fa\u00e7a um <a href=\"\/pt\/point-of-sale\/card-acquisition\">CardAcquisitionRequest<\/a> com:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><code>SaleData.TokenRequestedType<\/code><\/td>\n<td style=\"text-align: left;\"><strong>CLiente<\/strong>. Isso retorna o alias do cart\u00e3o no campo da resposta <code>TokenValue<\/code>. Se voc\u00ea n\u00e3o incluir o <code>TokenRequestedType<\/code>, o alias do cart\u00e3o ser\u00e1 retornado apenas no <code>AdditionalResponse<\/code>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>CardAcquisitionTransaction<\/code><\/td>\n<td style=\"text-align: left;\">No fluxo de single-tap redeem, esrte objeto deve conter: <ul><li markdown=\"1\"><code>TotalAmount<\/code>: O valor da transa\u00e7\u00e3o.<\/li><\/ul> <p>No fluxo de double-tap redeem, voc\u00ea pode deixar este objeto vazio se voc\u00ea espera que o valor mude na maioria dos casos, por exemplo, se voc\u00ea fizer uma aquisi\u00e7\u00e3o de cart\u00e3o assim que o primeiro item for digitalizado.<\/p><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"''\" :id=\"'redeem-card-acquisition'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":[{\"name\":\"request\",\"content\":\"{\\n    \\\"SaleToPOIRequest\\\":{\\n        \\\"MessageHeader\\\":{\\n            \\\"ProtocolVersion\\\":\\\"3.0\\\",\\n            \\\"MessageClass\\\":\\\"Service\\\",\\n            \\\"MessageCategory\\\":\\\"CardAcquisition\\\",\\n            \\\"MessageType\\\":\\\"Request\\\",\\n            \\\"ServiceID\\\":\\\"0305Acq\\\",\\n            \\\"SaleID\\\":\\\"POSSystemID12345\\\",\\n            \\\"POIID\\\":\\\"V400m-346403161\\\"\\n        },\\n        \\\"CardAcquisitionRequest\\\":{\\n            \\\"SaleData\\\":{\\n                \\\"SaleTransactionID\\\":{\\n                    \\\"TransactionID\\\":\\\"0422024\\\",\\n                    \\\"TimeStamp\\\":\\\"2020-06-19T12:18:04\\\"\\n                },\\n                \\\"TokenRequestedType\\\":\\\"Customer\\\"\\n            },\\n            \\\"CardAcquisitionTransaction\\\":{\\n                \\\"TotalAmount\\\": 14.98\\n            }\\n        }\\n    }\\n}\"},{\"name\":\"response\",\"content\":\"{\\n    \\\"SaleToPOIResponse\\\": {\\n        \\\"CardAcquisitionResponse\\\": {\\n            \\\"LoyaltyAccount\\\": [\\n                {\\n                    \\\"LoyaltyAccountID\\\": {\\n                        \\\"EntryMode\\\": [\\n                           \\\"Contactless\\\"\\n                        ],\\n                        \\\"IdentificationType\\\": \\\"AccountNumber\\\",\\n                        \\\"LoyaltyID\\\": \\\"rEqQFLnckxJ3jCvmQoLmBh\\\"\\n                 },\\n                 \\\"LoyaltyBrand\\\": \\\"AppleVAS\\\"\\n              }\\n           ]\\n            \\\"POIData\\\": {\\n                \\\"POIReconciliationID\\\": \\\"1000\\\",\\n                \\\"POITransactionID\\\": {\\n                    \\\"TimeStamp\\\": \\\"2020-06-19T10:18:48.000Z\\\",\\n                    \\\"TransactionID\\\": \\\"8ha5001592561928000\\\"\\n                }\\n            },\\n            \\\"SaleData\\\": {\\n                \\\"SaleTransactionID\\\": {\\n                    \\\"TimeStamp\\\": \\\"2020-06-19T12:18:04.000Z\\\",\\n                    \\\"TransactionID\\\": \\\"0422024\\\"\\n                }\\n            },\\n            \\\"PaymentInstrumentData\\\": {\\n                \\\"CardData\\\": {...},\\n                \\\"PaymentInstrumentType\\\": \\\"Card\\\"\\n            },\\n            \\\"Response\\\": {\\n                \\\"AdditionalResponse\\\": \\\"...\\\",\\n                \\\"Result\\\": \\\"Success\\\"\\n            }\\n        },\\n        \\\"MessageHeader\\\": {...}\\n    }\\n}\"}]}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>No <code>CardAcquisitionResponse<\/code>, observe o seguinte:<\/p>\n<ul>\n<li><code>POIData.POITransactionID<\/code>: O <code>TimeStamp<\/code> e <code>TransactionID<\/code> desta solicita\u00e7\u00e3o de aquisi\u00e7\u00e3o de cart\u00e3o. Voc\u00ea precisar\u00e1 desses dados posteriormente, quando continuar com o pagamento.<\/li>\n<li><code>AdditionalResponse<\/code>: Se voc\u00ea j\u00e1 tiver o cliente registrado, este cont\u00e9m a <code>shopperReference<\/code>.<\/li>\n<\/ul>\n<p>Se a resposta n\u00e3o incluir um <code>LoyaltyResult<\/code>, o cliente ainda n\u00e3o adicionou seu passe habilitado para NFC \u00e0 carteira m\u00f3vel.<\/p>\n<\/li>\n<li>\n<p>Usando <code>LoyaltyID<\/code> e <code>shopperReference<\/code>retornado na resposta, procure o comprador em seu servidor de passes e programa de fidelidade e aplique sua l\u00f3gica de neg\u00f3cios.<br \/>\nPor exemplo:<\/p>\n<ul>\n<li>Fa\u00e7a uma <a href=\"\/pt\/point-of-sale\/shopper-engagement\/shopper-input#confirmation\">solicita\u00e7\u00e3o de confirma\u00e7\u00e3o de entrada<\/a> para perguntar ao comprador se ele deseja resgatar pontos de fidelidade.<\/li>\n<li>Adicione ou recalcule pontos de fidelidade.<\/li>\n<li>Aplique um desconto.<\/li>\n<li>\n<p>Recalcule o valor da transa\u00e7\u00e3o.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<p>Ou se voc\u00ea ainda n\u00e3o tem o cliente registrado, voc\u00ea pode querer:<\/p>\n<ul>\n<li>Pergunte ao comprador se ele deseja se inscrever em seu programa de fidelidade e adicionar seu passe \u00e0 carteira m\u00f3vel. Se o fizerem, voc\u00ea precisar\u00e1 coletar os detalhes do comprador, como o endere\u00e7o de e-mail. Voc\u00ea pode usar uma <a href=\"\/pt\/point-of-sale\/shopper-engagement\/shopper-input\">solicita\u00e7\u00f5es de entrada<\/a> para coletar essas informa\u00e7\u00f5es ou permitir que sua equipe insira as informa\u00e7\u00f5es no software da caixa registradora.<\/li>\n<li>Crie um perfil de cliente para o comprador em seu programa de fidelidade e passe o servidor com as informa\u00e7\u00f5es que voc\u00ea coletou.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<h3 id=\"redeem-payment\">Etapa 2: Continue com o pagamento<\/h3>\n<ol>\n<li>\n<p>Fa\u00e7a um <a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/make-a-payment\">PaymentRequest<\/a> com:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><code>SaleData.TokenRequestedType<\/code><\/td>\n<td style=\"text-align: left;\"><strong>Cliente<\/strong>. Isso retorna o alias do cart\u00e3o no campo de resposta <code>TokenValue<\/code> field of the response. Consulte <a href=\"\/pt\/point-of-sale\/shopper-recognition\">Reconhecimento e tokeniza\u00e7\u00e3o do comprador<\/a>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>SaleData.SaleToAcquirerData<\/code><\/td>\n<td style=\"text-align: left;\">Se voc\u00ea ainda n\u00e3o tinha o cliente registrado, use este par\u00e2metro para criar identificadores de cliente em nossa plataforma para que da pr\u00f3xima vez o comprador seja reconhecido. <p>Veja as <a href=\"#sale-to-acquirer-data\">instru\u00e7\u00f5es abaixo<\/a>.<\/p><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>PaymentTransaction.AmountsReq<\/code><\/td>\n<td style=\"text-align: left;\">An object with: <ul><li markdown=\"1\"><code>Currency<\/code>: A <a href=\"\/pt\/development-resources\/currency-codes\">moeda<\/a> da transa\u00e7\u00e3o.<\/li><li markdown=\"1\"><code>RequestedAmount<\/code>: O valor final da transa\u00e7\u00e3o.<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>PaymentData.CardAcquisitionReference<\/code><\/td>\n<td style=\"text-align: left;\">Um objeto que faz refer\u00eancia \u00e0 aquisi\u00e7\u00e3o do cart\u00e3o:: <ul><li markdown=\"1\"><code>TimeStamp<\/code>: O carimbo de data \/ hora retornado na reposta <code>POIData.POITransactionID<\/code> de aquisi\u00e7\u00e3o do cart\u00e3o.<\/li> <li markdown=\"1\"><code>TransactionID<\/code>: O ID da transa\u00e7\u00e3o retornado na resposta <code>POIData.POITransactionID<\/code> da aquisi\u00e7\u00e3o do cart\u00e3o.<\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Para um cliente n\u00e3o reconhecido, voc\u00ea pode incluir o seguinte em <code>SaleData.SaleToAcquirerData<\/code>:<br \/>\n<a id=\"sale-to-acquirer-data\"><\/a><\/p>\n<ul>\n<li><code>shopperEmail<\/code>: O endere\u00e7o de e-mail do cliente, se voc\u00ea o coletou..<\/li>\n<li><code>shopperReference<\/code>: Sua refer\u00eancia exclusiva para este cliente (comprimento m\u00ednimo de tr\u00eas caracteres).<\/li>\n<li>\n<p><code>recurringContract<\/code>: <strong>ONECLICK,RECURRING<\/strong>.<\/p>\n <!-- list separator -->\n<\/li>\n<\/ul>\n<p>Passe o valor <code>SaleToAcquirerData<\/code> em um dos seguintes formatos:<\/p>\n<ul>\n<li>Op\u00e7\u00e3o 1: um objeto JSON convertido em uma string codificada em Base64. Consulte <a href=\"\/pt\/point-of-sale\/add-data#base64-json\">Adicionar informa\u00e7\u00f5es a um pagamento <\/a>.<\/li>\n<li>Op\u00e7\u00e3o 2: pares de valores-chave codificados por formul\u00e1rio (usando <strong>&amp;<\/strong> como separador). Por exemplo:<br \/>\n<code>shopperEmail=S.Hopper@example.com&amp;recurringContract=ONECLICK,RECURRING<\/code><\/li>\n<\/ul>\n<p>O formato que voc\u00ea usa aqui tamb\u00e9m ser\u00e1 o formato do <code>AdditionalResponse<\/code> que voc\u00ea receber.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"''\" :id=\"'redeem-payment'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":[{\"name\":\"request\",\"content\":\"{\\n    \\\"SaleToPOIRequest\\\":{\\n        \\\"MessageHeader\\\":{\\n            \\\"ProtocolVersion\\\":\\\"3.0\\\",\\n            \\\"MessageClass\\\":\\\"Service\\\",\\n            \\\"MessageCategory\\\":\\\"Payment\\\",\\n            \\\"MessageType\\\":\\\"Request\\\",\\n            \\\"ServiceID\\\":\\\"0305p\\\",\\n            \\\"SaleID\\\":\\\"POSSystemID12345\\\",\\n            \\\"POIID\\\":\\\"V400m-346403161\\\"\\n        },\\n        \\\"PaymentRequest\\\":{\\n            \\\"SaleData\\\":{\\n                \\\"SaleTransactionID\\\":{\\n                    \\\"TimeStamp\\\": \\\"2020-06-19T12:23:04.000Z\\\",\\n                    \\\"TransactionID\\\": \\\"042208\\\"\\n                },\\n                \\\"SaleToAcquirerData\\\":\\\"shopperEmail=S.Hopper@example.com&amp;shopperReference=YOUR_UNIQUE_SHOPPER_ID\\\",\\n                \\\"TokenRequestedType\\\":\\\"Customer\\\"\\n            },\\n            \\\"PaymentTransaction\\\":{\\n                \\\"AmountsReq\\\":{\\n                    \\\"Currency\\\":\\\"EUR\\\",\\n                    \\\"RequestedAmount\\\":14.48\\n                }\\n            },\\n            \\\"PaymentData\\\":{\\n                \\\"CardAcquisitionReference\\\":{\\n                    \\\"TimeStamp\\\": \\\"2020-06-19T10:21:27.000Z\\\",\\n                    \\\"TransactionID\\\": \\\"8ha5001592562087001\\\"\\n                }\\n            }\\n        }\\n    }\\n}\"},{\"name\":\"response\",\"content\":\"{\\n    \\\"SaleToPOIResponse\\\": {\\n        \\\"PaymentResponse\\\": {\\n            \\\"LoyaltyResult\\\": [\\n                {\\n                    \\\"LoyaltyAccount\\\": {\\n                        \\\"LoyaltyAccountID\\\": {\\n                            \\\"EntryMode\\\": [\\n                                \\\"Contactless\\\"\\n                            ],\\n                           \\\"IdentificationType\\\": \\\"AccountNumber\\\",\\n                           \\\"LoyaltyID\\\": \\\"rEqQFLnckxJ3jCvmQoLmBh\\\"\\n                        },\\n                    \\\"LoyaltyBrand\\\": \\\"AppleVAS\\\"\\n                 }\\n              }\\n            ],\\n            \\\"POIData\\\": {\\n                \\\"POITransactionID\\\": {\\n                    \\\"TimeStamp\\\": \\\"2020-06-19T10:24:03.000Z\\\",\\n                    \\\"TransactionID\\\": \\\"8ha5001592562087001.NC6HT9CRT65ZGN82\\\"\\n                },\\n                \\\"POIReconciliationID\\\": \\\"1000\\\"\\n            },\\n            \\\"SaleData\\\": {\\n                \\\"SaleTransactionID\\\": {\\n                    \\\"TimeStamp\\\": \\\"2020-06-19T12:23:04.000Z\\\",\\n                    \\\"TransactionID\\\": \\\"042208\\\"\\n                }\\n            },\\n            \\\"PaymentReceipt\\\": [...],\\n            \\\"PaymentResult\\\": {\\n                \\\"OnlineFlag\\\": true,\\n                \\\"PaymentAcquirerData\\\": {...},\\n                    \\\"MerchantID\\\": \\\"ADYEN_MERCHANT_ACCOUNT\\\"\\n                },\\n                \\\"PaymentInstrumentData\\\": {\\n                    \\\"CardData\\\": {\\n                        \\\"EntryMode\\\": [\\n                            \\\"Contactless\\\"\\n                        ],\\n                        \\\"PaymentToken\\\": {\\n                            \\\"TokenRequestedType\\\": \\\"Customer\\\",\\n                            \\\"TokenValue\\\": \\\"M469509594859802\\\"\\n                        },\\n                        \\\"PaymentBrand\\\": \\\"mc\\\",\\n                        \\\"MaskedPan\\\": \\\"541333 **** 9999\\\",\\n                        \\\"CardCountryCode\\\": \\\"056\\\",\\n                        \\\"SensitiveCardData\\\": {\\n                            \\\"CardSeqNumb\\\": \\\"83\\\",\\n                            \\\"ExpiryDate\\\": \\\"0228\\\"\\n                        }\\n                    },\\n                    \\\"PaymentInstrumentType\\\": \\\"Card\\\"\\n                },\\n                \\\"AmountsResp\\\": {\\n                    \\\"AuthorizedAmount\\\": 14.48,\\n                    \\\"Currency\\\": \\\"EUR\\\"\\n                },\\n            },\\n            \\\"Response\\\": {\\n                \\\"AdditionalResponse\\\": \\\"...&amp;alias=M469509594859802&amp;...recurring.shopperReference=YOUR_UNIQUE_SHOPPER_ID&amp;...shopperReference=YOUR_UNIQUE_SHOPPER_ID&amp;shopperEmail=S.Hopper%40example.com&amp;...\\\",\\n                \\\"Result\\\": \\\"Success\\\"\\n            }\\n        },\\n        \\\"MessageHeader\\\": {...}\\n    }\\n}\"}]}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>No <code>PaymentResponse<\/code>, observe que voc\u00ea recebe o mesmo  <code>LoyaltyResult<\/code> que no <code>CardAcquisitionResponse<\/code>.<\/p>\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\/shopper-recognition\"\n                        target=\"_self\"\n                        >\n                    Reconhecimento e tokeniza\u00e7\u00e3o do cliente\n                <\/a><\/li><li><a href=\"\/point-of-sale\/card-acquisition\"\n                        target=\"_self\"\n                        >\n                    Aquisi\u00e7\u00e3o de cart\u00e3o\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/loyalty\/wallet-passes","articleFields":{"description":"Learn how to process transactions with NFC wallet passes.","last_edit_on":"15-12-2020 15:39"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/loyalty\/wallet-passes","title":"NFC wallet passes","content":"Os clientes podem vincular seus cart\u00f5es de cr\u00e9dito e d\u00e9bito a um aplicativo de carteira m\u00f3vel e, em seguida, fazer pagamentos na loja com a carteira m\u00f3vel usando um servi\u00e7o como o Apple Pay. O terminal faz interface com a carteira m\u00f3vel por meio de comunica\u00e7\u00e3o por aproxima\u00e7\u00e3o (NFC) entre o terminal e o telefone ou smartwatch do comprador.\nAl\u00e9m dos cart\u00f5es de cr\u00e9dito e d\u00e9bito, os clientes tamb\u00e9m podem manter outros passes em sua carteira m\u00f3vel, como cart\u00f5es de fidelidade, vouchers, cart\u00f5es-presente, cart\u00f5es de embarque e passagens. Com esses passes habilitados para NFC, eles podem, por exemplo, resgatar um voucher ou acumular pontos em um cart\u00e3o de fidelidade.\nComo comerciante, voc\u00ea pode criar seus pr\u00f3prios passes habilitados para NFC e vincul\u00e1-los ao seu programa de fidelidade. Com a integra\u00e7\u00e3o do Terminal API, voc\u00ea pode verificar se o comprador tem o seu passe na carteira m\u00f3vel e usar o passe para a transa\u00e7\u00e3o.\nNo momento, oferecemos suporte para:\n\nApple Wallet passes\n\nComo funciona\nExistem v\u00e1rias maneiras de implementar passes habilitados para NFC com um pagamento, dependendo do que faz sentido para seu passe e programa de fidelidade:\n\nFluxo de pagamento: Voc\u00ea verifica os passes ap\u00f3s o pagamento e atualiza a conta do cliente posteriormente.\n\nFluxo de resgate: Voc\u00ea verifica os passes antes do pagamento por meio de uma solicita\u00e7\u00e3o de aquisi\u00e7\u00e3o de cart\u00e3o. Se houver descontos ou outras vantagens relacionadas ao passe, voc\u00ea pode aplic\u00e1-los ao pagamento antecipado.\nExistem duas varia\u00e7\u00f5es do fluxo de resgare: single-tap redeem flow e double-tap redeem flow.  Al\u00e9m de uma defini\u00e7\u00e3o de configura\u00e7\u00e3o, a implementa\u00e7\u00e3o \u00e9 a mesma. A diferen\u00e7a \u00e9 que, no fluxo de double-tap, o terminal pede uma segunda vez ao cliente para apresentar o cart\u00e3o. Isso permite que o cliente resgate o passe NFC na primeira vez que o terminal solicitar o cart\u00e3o e, a seguir, mude para outro m\u00e9todo de pagamento na segunda vez que o terminal solicitar o cart\u00e3o.\n\n\nSelecione as guias abaixo para saber mais. Antes de configurar seu passe NFC na \u00c1rea do Cliente, voc\u00ea precisa entender como esses fluxos funcionam e qual fluxo voc\u00ea deseja implementar.\n\n\n    \n        \n        \n    \n\n\nInscri\u00e7\u00e3o do cliente\nPara permitir que os clientes se inscrevam no programa de fidelidade vinculado ao seu passe habilitado para NFC e adicionem o passe \u00e0 carteira m\u00f3vel, voc\u00ea pode inform\u00e1-los por e-mail, m\u00eddia social, seu site e assim por diante.\nTamb\u00e9m podemos ajudar seus compradores a se inscreverem: Quando eles fazem um pagamento de carteira NFC, mas ainda n\u00e3o t\u00eam o seu passe na carteira m\u00f3vel, enviamos um sinal NFC para que os compradores recebam uma mensagem com o URL onde podem se inscrever. Para tornar isso poss\u00edvel, voc\u00ea precisa fornecer essa URL na configura\u00e7\u00e3o da sua \u00e1rea do cliente.\nAntes de voc\u00ea come\u00e7ar\n\n\nConfigure um servidor para seus passes habilitados para NFC. Nesse servidor de passe, voc\u00ea precisa disponibilizar um URL onde os clientes possam se inscrever no programa de fidelidade vinculado ao seu passe habilitado para NFC e adicionar o passe \u00e0 carteira m\u00f3vel.\n\nVoc\u00ea precisa especificar este URL ao configurar o passe em sua \u00e1rea do cliente.\n\n\n\nCrie um ou mais passes habilitados para NFC. Consulte, por exemplo, o Guia do Desenvolvedor de Carteira, que explica como criar um passe da Carteira Apple para o seu programa de fidelidade.\n\nAo criar seu passe, um ID do tipo de passe e uma chave privada s\u00e3o gerados. Voc\u00ea precisar\u00e1 deles mais tarde, quando configurar o passe em sua \u00c1rea do Cliente.\n\n\n\nMake sure that you have built a Terminal API integration that can make a payment.\n\n\nTie in your loyalty program with your NFC wallet passes. To learn more about how to link a customer in your loyalty program to a transaction, see Shopper recognition and tokenization.\n\n\nConfigure passes habilitados para NFC em sua \u00e1rea do cliente\nPara nos permitir obter a identifica\u00e7\u00e3o exclusiva do passe do comprador, voc\u00ea precisa nos informar sobre seu passe habilitado para NFC e o fluxo que deseja usar:\n\n\nFa\u00e7a o login na sua Customer Area e selecione o n\u00edvel da conta onde deseja usar o seu passe habilitado para NFC.\n\n\nV\u00e1 para In-person payments &gt; Terminal settings &gt; Payment features.\n\n\nSelecione View decrypted e v\u00e1 para Mobile wallet NFC pass services.\n\n\nEm Card acquisition VAS mode, selecione uma op\u00e7\u00e3o para o fluxo que deseja usar. Esta configura\u00e7\u00e3o determina o que o terminal tenta fazer quando voc\u00ea faz uma solicita\u00e7\u00e3o de aquisi\u00e7\u00e3o de cart\u00e3o e o comprador conecta um dispositivo com uma carteira NFC ao terminal de pagamento.\n\n\nPara o fluxo de pagamento e o fluxo single-tap redeem, selecione VAS and payment. Isso obt\u00e9m os detalhes da passagem NFC e os detalhes do m\u00e9todo de pagamento NFC.\n\n\nPara o fluxo double-tap redeem, selecione VAS only. Isso obt\u00e9m os detalhes da passagem NFC quando voc\u00ea faz uma solicita\u00e7\u00e3o de aquisi\u00e7\u00e3o de cart\u00e3o.\n\n\nExistem mais duas op\u00e7\u00f5es que listamos aqui para integridade::\n\nSe voc\u00ea n\u00e3o quiser coletar os detalhes do passe NFC ao fazer uma solicita\u00e7\u00e3o de aquisi\u00e7\u00e3o de cart\u00e3o, selecione Payment only.\n\nPara deixar a cargo do cliente se os detalhes do passe NFC s\u00e3o coletados com a solicita\u00e7\u00e3o de aquisi\u00e7\u00e3o do cart\u00e3o, selecione VAS or payment.\n\n\n\n\n\n\n\nDigite o Nome do seu passe.\n\n\nEm Merchant pass type identifier, insira a ID do tipo de passe que foi gerada quando voc\u00ea criou seu passe NFC.\nUsamos isso para pesquisar apenas o seu passe e n\u00e3o os passes de outras organiza\u00e7\u00f5es que o comprador possa ter em sua carteira m\u00f3vel. Para um passe da Apple Wallet, tem o formato pass.com.company.pass-name.\n\n\nEm Vendor type, selecione a empresa respons\u00e1vel pelo protocolo no qual seu passe NFC se baseia. Por exemplo, Apple.\n\n\nInsira o URL onde as pessoas podem adicionar o passe \u00e0 carteira m\u00f3vel.\nUsamos isso quando o comprador ainda n\u00e3o tem o seu passe na carteira, para enviar um sinal NFC para que o comprador receba uma mensagem com a URL onde ele pode se inscrever.\n\n\nNa caixa Private key slot, selecione o slot onde voc\u00ea fornecer\u00e1 sua chave privada. Por exemplo, Private key 1.\n\n\nEm Private key slots, v\u00e1 para o slot que voc\u00ea selecionou na etapa anterior e insira a chave privada para o seu passe NFC.\nEsta chave foi gerada quando voc\u00ea criou o passe. Iremos proteg\u00ea-lo e criptograf\u00e1-lo em nosso back end. O terminal usa essa chave para descriptografar a mensagem NFC e retornar o ID exclusivo do passe do comprador na resposta.\n\n\nPara adicionar mais passes habilitados para NFC, selecione Add wallet e repita as etapas para completar as configura\u00e7\u00f5es.\n\n\nSelecione Save.\n\n\nDepois de concluir a configura\u00e7\u00e3o, voc\u00ea est\u00e1 pronto para aceitar seu passe habilitado para NFC com um pagamento, usando o fluxo de pagamento ou o fluxo de resgate.\nUse o fluxo de pagamento\nPara fazer uma solicita\u00e7\u00e3o de pagamento e depois atualizar a conta do passe NFC do cliente:\n\n\nFa\u00e7a um \n  PaymentRequest\n:\n\n\n\nParameter\nDescription\n\n\n\n\nSaleData.TokenRequestedType\nCliente. Isso retorna o alias do cart\u00e3o no campo da resposta TokenValue. Se voc\u00ea n\u00e3o incluir o TokenRequestedType, o alias do cart\u00e3o ser\u00e1 retornado apenas no AdditionalResponse.\n\n\n\n\n\n\nNo PaymentResponse, observe o seguinte:\nSe a resposta n\u00e3o incluir um LoyaltyResult, o cliente ainda n\u00e3o adicionou seu passe habilitado para NFC \u00e0 carteira m\u00f3vel.\n\n\nUsando o LoyaltyID e o alias do cart\u00e3o retornado na resposta, procure o comprador em seu servidor de passes e programa de fidelidade e atualize os dados do comprador. Por exemplo, os pontos de fidelidade acumulados.\n\n\nUse o fluxo de resgate\nAqui, descrevemos como voc\u00ea pode primeiro verificar se o cliente tem seu passe habilitado para NFC em seu aplicativo de carteira antes de iniciar o pagamento. Isso permite que voc\u00ea aplique um desconto ou outras vantagens relacionadas ao passe.\nSe o cliente precisa tocar em seu telefone ou smartwatch uma segunda vez para concluir o pagamento, depende da configura\u00e7\u00e3o da \u00e1re a do cliente de seu passe.\nEtapa 1: obtenha os detalhes do passe do cliente\n\n\nFa\u00e7a um CardAcquisitionRequest com:\n\n\n\nParameter\nDescription\n\n\n\n\nSaleData.TokenRequestedType\nCLiente. Isso retorna o alias do cart\u00e3o no campo da resposta TokenValue. Se voc\u00ea n\u00e3o incluir o TokenRequestedType, o alias do cart\u00e3o ser\u00e1 retornado apenas no AdditionalResponse.\n\n\nCardAcquisitionTransaction\nNo fluxo de single-tap redeem, esrte objeto deve conter: TotalAmount: O valor da transa\u00e7\u00e3o. No fluxo de double-tap redeem, voc\u00ea pode deixar este objeto vazio se voc\u00ea espera que o valor mude na maioria dos casos, por exemplo, se voc\u00ea fizer uma aquisi\u00e7\u00e3o de cart\u00e3o assim que o primeiro item for digitalizado.\n\n\n\n\n\n\n\n\nNo CardAcquisitionResponse, observe o seguinte:\n\nPOIData.POITransactionID: O TimeStamp e TransactionID desta solicita\u00e7\u00e3o de aquisi\u00e7\u00e3o de cart\u00e3o. Voc\u00ea precisar\u00e1 desses dados posteriormente, quando continuar com o pagamento.\nAdditionalResponse: Se voc\u00ea j\u00e1 tiver o cliente registrado, este cont\u00e9m a shopperReference.\n\nSe a resposta n\u00e3o incluir um LoyaltyResult, o cliente ainda n\u00e3o adicionou seu passe habilitado para NFC \u00e0 carteira m\u00f3vel.\n\n\nUsando LoyaltyID e shopperReferenceretornado na resposta, procure o comprador em seu servidor de passes e programa de fidelidade e aplique sua l\u00f3gica de neg\u00f3cios.\nPor exemplo:\n\nFa\u00e7a uma solicita\u00e7\u00e3o de confirma\u00e7\u00e3o de entrada para perguntar ao comprador se ele deseja resgatar pontos de fidelidade.\nAdicione ou recalcule pontos de fidelidade.\nAplique um desconto.\n\nRecalcule o valor da transa\u00e7\u00e3o.\n\n\n\nOu se voc\u00ea ainda n\u00e3o tem o cliente registrado, voc\u00ea pode querer:\n\nPergunte ao comprador se ele deseja se inscrever em seu programa de fidelidade e adicionar seu passe \u00e0 carteira m\u00f3vel. Se o fizerem, voc\u00ea precisar\u00e1 coletar os detalhes do comprador, como o endere\u00e7o de e-mail. Voc\u00ea pode usar uma solicita\u00e7\u00f5es de entrada para coletar essas informa\u00e7\u00f5es ou permitir que sua equipe insira as informa\u00e7\u00f5es no software da caixa registradora.\nCrie um perfil de cliente para o comprador em seu programa de fidelidade e passe o servidor com as informa\u00e7\u00f5es que voc\u00ea coletou.\n\n\n\nEtapa 2: Continue com o pagamento\n\n\nFa\u00e7a um PaymentRequest com:\n\n\n\nParameter\nDescription\n\n\n\n\nSaleData.TokenRequestedType\nCliente. Isso retorna o alias do cart\u00e3o no campo de resposta TokenValue field of the response. Consulte Reconhecimento e tokeniza\u00e7\u00e3o do comprador.\n\n\nSaleData.SaleToAcquirerData\nSe voc\u00ea ainda n\u00e3o tinha o cliente registrado, use este par\u00e2metro para criar identificadores de cliente em nossa plataforma para que da pr\u00f3xima vez o comprador seja reconhecido. Veja as instru\u00e7\u00f5es abaixo.\n\n\nPaymentTransaction.AmountsReq\nAn object with: Currency: A moeda da transa\u00e7\u00e3o.RequestedAmount: O valor final da transa\u00e7\u00e3o.\n\n\nPaymentData.CardAcquisitionReference\nUm objeto que faz refer\u00eancia \u00e0 aquisi\u00e7\u00e3o do cart\u00e3o:: TimeStamp: O carimbo de data \/ hora retornado na reposta POIData.POITransactionID de aquisi\u00e7\u00e3o do cart\u00e3o. TransactionID: O ID da transa\u00e7\u00e3o retornado na resposta POIData.POITransactionID da aquisi\u00e7\u00e3o do cart\u00e3o.\n\n\n\nPara um cliente n\u00e3o reconhecido, voc\u00ea pode incluir o seguinte em SaleData.SaleToAcquirerData:\n\n\nshopperEmail: O endere\u00e7o de e-mail do cliente, se voc\u00ea o coletou..\nshopperReference: Sua refer\u00eancia exclusiva para este cliente (comprimento m\u00ednimo de tr\u00eas caracteres).\n\nrecurringContract: ONECLICK,RECURRING.\n \n\n\nPasse o valor SaleToAcquirerData em um dos seguintes formatos:\n\nOp\u00e7\u00e3o 1: um objeto JSON convertido em uma string codificada em Base64. Consulte Adicionar informa\u00e7\u00f5es a um pagamento .\nOp\u00e7\u00e3o 2: pares de valores-chave codificados por formul\u00e1rio (usando &amp; como separador). Por exemplo:\nshopperEmail=S.Hopper@example.com&amp;recurringContract=ONECLICK,RECURRING\n\nO formato que voc\u00ea usa aqui tamb\u00e9m ser\u00e1 o formato do AdditionalResponse que voc\u00ea receber.\n\n\n\nNo PaymentResponse, observe que voc\u00ea recebe o mesmo  LoyaltyResult que no CardAcquisitionResponse.\n\n\nVeja tamb\u00e9m\n\n\n                    Reconhecimento e tokeniza\u00e7\u00e3o do cliente\n                \n                    Aquisi\u00e7\u00e3o de cart\u00e3o\n                \n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Shopper loyalty","lvl3":"NFC wallet passes"},"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\/loyalty","lvl3":"\/pt\/point-of-sale\/loyalty\/wallet-passes"},"levels":4,"category":"In-person payments","category_color":"green","tags":["wallet","passes"]},"articleFiles":{"redeem-card-acquisition.request.json":"<p alt=\"\">redeem-card-acquisition.request.json<\/p>","redeem-card-acquisition.response.json":"<p alt=\"\">redeem-card-acquisition.response.json<\/p>","redeem-payment.request.json":"<p alt=\"\">redeem-payment.request.json<\/p>","redeem-payment.response.json":"<p alt=\"\">redeem-payment.response.json<\/p>","single-tap-payment.request.json":"<p alt=\"\">single-tap-payment.request.json<\/p>","single-tap-payment.response.json":"<p alt=\"\">single-tap-payment.response.json<\/p>"}}
