Biblioteca Sopague

Ir para a página da Sopague

Biblioteca 3DS

Introdução à Biblioteca 3DS 2.0

Em situações específicas, além do antifraude, é necessário utilizar a Biblioteca 3DS 2.0 para transações como vendas em cartões de débito. Essa implementação é feita através de uma biblioteca JavaScript fornecida por Sopague, projetada para minimizar fraudes sem comprometer a taxa de conversão.

O que é o 3DS 2.0?

O 3DS 2.0 é uma tecnologia avançada que segue normas rigorosas de segurança, principalmente vindas da Europa. Seu objetivo é facilitar a identificação de fraudes por bancos emissores enquanto mantém a experiência do cliente fluida e segura.

Funcionamento

1. Informações do cliente: O cliente preenche os dados do cartão (crédito ou débito) e confirma a compra.
2. Coleta de dados: O processador de pagamentos reúne até 100 informações sobre a transação (ex.: número do cartão, endereço IP, entre outros).
3. Envio ao banco: Essas informações são enviadas ao banco emissor com tecnologia certificada.
4. Validação: Em alguns casos, um "desafio" é solicitado para o cliente confirmar sua identidade, garantindo máxima segurança.

Fluxos Possíveis

Para a autenticação 3DS, há dois cenários principais:

1. Sem desafio: O banco emissor não solicita nenhuma ação adicional do cliente.
2. Com desafio: O cliente precisa validar a transação, como confirmar um código enviado ao celular.

Coleta de Dados do Navegador

Antes de processar o pagamento, a biblioteca coleta informações do navegador do cliente, que são enviadas ao endpoint /payments/3ds. Os dados necessários incluem:

• Idioma do navegador (httpBrowserLanguage)
• Suporte a Java (httpBrowserJavaEnabled)
• Suporte a JavaScript (httpBrowserJavaScriptEnabled)
• Profundidade de cor (httpBrowserColorDepth)
• Resolução da tela (httpBrowserScreenHeight e httpBrowserScreenWidth)
• Diferença de fuso horário (httpBrowserTimeDifference)
• Agente do navegador (userAgentBrowserValue)

É necessário obter alguns dados através do navegador do cliente para enviar para o endpoints de pagamento /payments/3ds, tais como:

const browserData = {
  httpBrowserLanguage: navigator.language || navigator.userLanguage,
  httpBrowserJavaEnabled: navigator.javaEnabled() ? "Y" : "N",
  httpBrowserJavaScriptEnabled: "Y", // Presumindo que o JS está habilitado
  httpBrowserColorDepth: screen.colorDepth,
  httpBrowserScreenHeight: window.innerHeight,
  httpBrowserScreenWidth: window.innerWidth,
  httpBrowserTimeDifference: new Date().getTimezoneOffset(),
  userAgentBrowserValue: navigator.userAgent
};

Além disso, a biblioteca 3DS irá gerar um "code3ds" que também deve ser enviado ao backend. Complementar ao serviço de 3DS, também deve ser implementada a biblioteca do antifraude.

Benefícios do 3DS 2.0

• Maior segurança: Reduz o risco de fraudes em transações online.
• Experiência otimizada: Integração fluida entre sites e aplicativos.
• Conformidade internacional: Alinhado às normas de segurança mais rigorosas.

Dicas para Desenvolvedores

• Certifique-se de que o ambiente de integração seja seguro e compatível.
• Realize testes abrangentes em cenários comuns e raros.
• Consulte atualizações da biblioteca para garantir que está usando a versão mais recente.

Para dúvidas ou suporte, entre em contato com a equipe técnica da Sopague.