--- title: "Ativação de funcionalidades VTEX (legado)" url: "https://devcenter.stone.com.br/legacy-ativacao-funcionalidades-vtex" image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_~QXRpdmHDp8OjbyBkZSBmdW5jaW9uYWxpZGFkZXMgVlRFWCAobGVnYWRvKQ,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9sZWdhY3ktYXRpdmFjYW8tZnVuY2lvbmFsaWRhZGVzLXZ0ZXgi,s_bkq7hkjCkbBs8PnV.png" --- # Ativação de funcionalidades VTEX Entenda como ativar a utilização das principais funcionalidades do nosso APP! Documentação legada do Pagar.me v5 Esta página descreve um conceito da **Pagar.me v5** (versão clássica). Para projetos novos, explore o **[API Catalog](https://devcenter.stone.com.br/catalog)**. Entenda como ativar a utilização das principais funcionalidades do nosso APP! ## [3DS 2.0 (Piloto)](#_3ds-20-piloto) O 3DS (Three Domain Secure) é um protocolo de verificação, que valida suas informações, confirmando sua identidade durante uma compra online. ![](https://files.readme.io/fb33dd2-POWERPNT_haALUNfMDI.png) Como o próprio **emissor do cartão** faz a **validação de segurança** para dizer que aquela é uma compra confiável, a probabilidade de aprovação é muito maior, além disso, uma vez que o emissor confirma autenticação bem-sucedida, ele mesmo passa a assumir o risco daquela compra, com isso, você **não receberá chargeback por motivo de fraude**! ### [Pré-requisitos de uso](#pré-requisitos-de-uso) - Estar integrado no **Conector PagarMeV3** para VTEX - Conta Pagar.me habilitada para transacionar com 3DS, no modelo **PSP Pagar.me** ou **gateway com adquirência Stone** - Aplicativo [Pagar.me Checkout Extension](https://devcenter.stone.com.br/legacy-ativacao-funcionalidades-vtex#instalando-o-pagarme-checkout-extension) instalado na VTEX - Verificar as [limitações conhecidas para utilização do 3DS](https://devcenter.stone.com.br/legacy-ativacao-funcionalidades-vtex#limita%C3%A7%C3%B5es-conhecidas) na plataforma ### [Ativação do 3DS](#ativação-do-3ds) Para facilitar o processo esteja logado em sua [Dashboard](https://id.pagar.me/signin) do Pagar.me e no admin sua loja VTEX (myvtex). #### [Habilitar conta para transacionar com 3DS](#habilitar-conta-para-transacionar-com-3ds) Antes de ativar a funcionalidade em sua plataforma, certifique-se de que a sua conta já está habilitada para receber transações com autenticação 3DS. O processo de credenciamento é gratuito e está disponível apenas para contas no modelo **PSP Pagar.me** ou **gateway com adquirência Stone**. Realizamos o credenciamento para 3DS de forma automática para contas elegíveis. Caso não tenha recebido um e-mail de confirmação indicando que o 3DS está ativo para sua conta, entre em contato com nosso time de atendimento para habilitação:`relacionamento@pagar.me` Atenção Caso o 3DS seja ativado na plataforma e a conta não estiver credenciada, irá ocorrer um erro ao transacionar. #### [Instalando o Pagar.me Checkout Extension](#instalando-o-pagarme-checkout-extension) 1. No admin da sua loja VTEX, na url, acrescente a informação: **`apps/pagarme.threeds-app@2.0.13/setup`** _Exemplo:`https://[SUALOJA].myvtex.com/admin/apps/pagarme.threeds-app@2.0.13/setup`_\\ 2. Após ser encaminhado ao APP na loja VTEX, clique em **Instalar**\\ 3. Recarregue a página clicando em **F5** Por aqui tudo ok! Vamos finalizar a ativação no HUB Pagar.me na próxima etapa. #### [Configurações de uso 3DS](#configurações-de-uso-3ds) 1. Acesse o [HUB Pagar.me](https://hub.pagar.me/) em **Entrar** faça login com as mesmas credenciais utilizadas para acesso a Dashboard\\ 2. No canto superior esquerdo, clique em **Minhas integrações**\\ 3. Localize a loja que está integrada com a VTEX atualmente e clique em **Editar**\\ 4. Abrirão então todas as configurações e vamos atualizar as de 3DS: ![](https://files.readme.io/0d224d0cb25de31bb2267814ae1bb0ef7f8ea167cf3318f051295a137536d307-chrome_rYiawPo85b.png) | Campo | Valor | Função | | :------------------------------------------------- | :-------------- | :------------------------------------------------------------------------------- | | Habilitar 3DS | Ativo / Inativo | Ativa/desativa a função de 3DS para sua loja VTEX | | Valor mínimo em reais para enviar para o 3DS | Numérico | Valor mínimo do pedido para envio a autenticação 3DS | | Desafio recusado: processar somente com AntiFraude | Ativo / Inativo | Quando ativo, caso o desafio não for cumprido corretamente pelo comprador, processamos o pedido no fluxo comum com validação do AF | | Falha no 3DS: processar somente com AntiFraude | Ativo / Inativo | Quando ativo, caso o 3DS apresente qualquer falha no checkout e impossibilitando o cumprimento correto do desafio pelo comprador, processamos o pedido no fluxo comum com validação do AF | 5. Finalize clicando em **Atualizar configurações** Pronto, a funcionalidade foi ativada com sucesso e você já está pronto para processar pagamentos com validação 3DS! ### [Limitações conhecidas](#limitações-conhecidas) Durante o uso do 3DS 2.0 em sua loja VTEX, existem algumas funcionalidades que apresentam restrições conhecidas. Abaixo listamos os principais casos, com seus respectivos comportamentos. #### [Pagamento com 2 cartões](#pagamento-com-2-cartões) A VTEX disponibiliza em seu checkout a funcionalidade de **pagamento com dois cartões**, permitindo que o comprador divida o valor da compra em dois meios de pagamento diferentes. No entanto, **essa funcionalidade não é compatível com o fluxo de autenticação 3DS 2.0**. Essa é uma **limitação da própria VTEX**, conforme descrito em sua [documentação oficial](https://help.vtex.com/pt/tutorial/configurar-fluxo-de-autenticacao-3ds-2--58XMn5LOA6fwrSkoDoAsg2) e [na lista de problemas conhecidos](https://help.vtex.com/pt/known-issues/pagamento-com-dois-cartoes-nao-funciona-com-3ds2--7tjxz6qEsQz9o42diSqMpt). **Como proceder:** Caso não deseje exibir a opção de pagamento com dois cartões em sua loja, recomendamos ocultá-la no checkout. A VTEX fornece instruções detalhadas sobre como esconder essa forma de pagamento na seção de [Características gerais do SmartCheckout](https://help.vtex.com/pt/tutorial/caracteristicas-gerais-smartcheckout-v5--tutorials_3811#iframe-nas-formas-de-pagamento-com-cartao). Atenção Caso o 3DS estiver ativado e o comprador realizar uma compra com 2 cartões, a VTEX apresentará um erro no processo de finalização da compra e o pedido será cancelado. #### [Google Pay](#google-pay) .O **Google Pay** já possui mecanismos próprios de autenticação no momento da compra. Por isso, ele **não é compatível com o fluxo de autenticação 3DS 2.0**. Caso o Google Pay esteja configurado junto com o 3DS em sua loja, **a transação será processada normalmente, mas sem passar pelo fluxo 3DS**. #### [Recorrência](#recorrência) A VTEX oferece a funcionalidade de **recorrência nativa**, que permite cobranças automáticas em intervalos definidos. No entanto, **essa funcionalidade não é suportada em conjunto com o 3DS 2.0 neste momento**. Assim, se a recorrência estiver configurada junto ao 3DS em sua loja, **as transações recorrentes serão processadas diretamente sem autenticação 3DS**. ### [Testando o 3DS](#testando-o-3ds) Se desejar, utilize nossos [cartões de teste](https://docs.pagar.me/docs/manual-de-integracao-3ds#lista-de-cart%C3%B5es-teste) para simular a experiência do comprador em vários cenários de autenticação. ### [Fluxo de funcionamento e desafio](#fluxo-de-funcionamento-e-desafio) A interação do comprador com o **3DS será no checkout**, nós enviamos seus dados ao banco emissor que pode solicitar ou não uma **validação de segurança** para o comprador. O próprio banco emissor escolhe a forma de validar os dados: via SMS, Face ID, biometria, token do internet banking, etc. O tipo de desafio **varia de banco para banco**. Abaixo temos um exemplo de como aparecerá para o comprador: ![Desafio de exemplo NuBank, mas varia de banco para banco](https://files.readme.io/bbc89f3c2a39f4af1c0876da820f4a70643f9ad704ef9e3b5778632c2ce7d4ed-chrome_F3eLbFHIZq.png) Desafio de exemplo NuBank, mas varia de banco para banco Após a autenticação ser concluída, os status de resultados possíveis são: | Sigla | Significado | | :---- | :--------------------------------------------- | | Y | Transação aprovada e autenticada pelo Emissor | | A | Transação aprovada e autenticada pela Bandeira | | I | Apenas dados enviados a Bandeira e Emissor | | U | Autenticação indisponível | | N | Transação rejeitada pelo Emissor | | R | Transação rejeitada pelo Emissor (pós-desafio) | Uso do Antifraude Para as compras com autenticação aprovada pelo banco emissor (status Y e A) como ele se responsabliliza pelo risco, essas não são enviadas ao Antifraude por não apresentarem risco de fraude real. Para os demais status, mesmo após a autenticação, as transações passam pelo fluxo de antifraude normalmente. --- **Jornada: [Conectar minha plataforma de e-commerce](https://devcenter.stone.com.br/legacy-plataformas)** Etapa 13 de 26 [**Etapa anterior**VTEX: Instalando o conector](https://devcenter.stone.com.br/legacy-instalando-conector-pagarme)[**Próxima etapa**VTEX: Sellers (Marketplace)](https://devcenter.stone.com.br/legacy-vtex-sellers-marketplace) Siga a Stone nas redes sociais [](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ) © Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57 Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.