Skip to main content

O que é 3D Secure

O 3D Secure (3DS) é um protocolo de autenticação que verifica a identidade do portador do cartão junto ao banco emissor durante uma transação online. Ele oferece:
  • Liability shift — a responsabilidade por chargebacks é transferida para o emissor quando a autenticação é bem-sucedida
  • Redução de fraudes — adiciona uma camada de verificação biométrica, SMS ou app bancário
  • Conformidade regulatória — atende requisitos de Strong Customer Authentication (SCA)
O SDK integra o 3DS 2.0 via BP.Mpi (Braspag MPI), que suporta fluxos frictionless (sem interação do usuário) e challenge (com interação).

Fluxo de autenticação

Status possíveis

Uso básico

Parâmetros da autenticação

Endereço (opcional, recomendado)

Opções adicionais

Retorno (ThreeDSResult)

Fluxo frictionless vs. challenge

O emissor decide se o fluxo será frictionless (sem interação) ou challenge (com interação). Essa decisão é baseada em:
  • Perfil de risco da transação
  • Histórico do portador do cartão
  • Valor da transação
  • Dados do dispositivo e navegador
No fluxo frictionless, a autenticação acontece em segundo plano e o resultado é retornado diretamente. No fluxo challenge, o SDK exibe automaticamente um modal com o iframe do banco emissor para que o usuário complete a verificação (SMS, biometria, app bancário etc.).
Enviar o endereço de cobrança (address) e dados completos do comprador aumenta significativamente a chance de um fluxo frictionless.

Informações coletadas automaticamente

O SDK coleta e envia automaticamente dados do navegador necessários para a avaliação de risco do emissor:
  • User Agent, idioma e fuso horário
  • Resolução de tela e profundidade de cor
  • Suporte a Java e JavaScript
  • Endereço IP público (via api.ipify.org)
Nenhuma ação adicional é necessária — essas informações são coletadas transparentemente pelo método authenticate().

Cartões de teste

Esses cartões são para testes apenas. Em produção, o comportamento depende do emissor real do cartão.

Tratamento de erros

Moedas suportadas