Ativação de funcionalidades VTEX
Entenda como ativar a utilização das principais funcionalidades do nosso APP!
Documentação legada do Pagar.me v5
Entenda como ativar a utilização das principais funcionalidades do nosso APP!
3DS 2.0 (Piloto)
O 3DS (Three Domain Secure) é um protocolo de verificação, que valida suas informações, confirmando sua identidade durante uma compra online.
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
- 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 instalado na VTEX
- Verificar as limitações conhecidas para utilização do 3DS na plataforma
Ativação do 3DS
Para facilitar o processo esteja logado em sua Dashboard do Pagar.me e no admin sua loja VTEX (myvtex).
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
Instalando o Pagar.me Checkout Extension
- 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\ - Após ser encaminhado ao APP na loja VTEX, clique em Instalar\
- 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
- Acesse o HUB Pagar.me em Entrar faça login com as mesmas credenciais utilizadas para acesso a Dashboard\
- No canto superior esquerdo, clique em Minhas integrações\
- Localize a loja que está integrada com a VTEX atualmente e clique em Editar\
- Abrirão então todas as configurações e vamos atualizar as de 3DS:
| 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 |
- 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
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
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 e na lista de problemas conhecidos.
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.
Atenção
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
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
Se desejar, utilize nossos cartões de teste para simular a experiência do comprador em vários cenários de autenticação.
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
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
Jornada: Conectar minha plataforma de e-commerce
Etapa 13 de 26