Pular para o conteúdo principal
Nesta página

O 3D Secure (3DS) autentica o titular da carteira com o banco emissor antes de uma transação com cartão ser concluída. A DEUNA integra essa autenticação ao mesmo fluxo de pagamento, seja a DEUNA gerenciando a experiência 3DS ou o provedor selecionado fornecendo seu fluxo 3DS suportado.

Como uma transação 3DS funciona#

Diagrama de sequência
1Cliente2Checkout3DEUNA4Banco emissorEnvie o pagamento comcartãoEnvie o pagamento uma únicavezSolicite a autenticação dotitularApresente next_action apenasquando retornadopending_3ds + next_actionquando necessárioAbra a experiência deautenticação retornadaAs verificações do navegadorocorrem apenas quandonecessáriasColete sinais do navegador e dodispositivoAutenticação sem desafioResultado da autenticaçãoDesafio necessárioApresente o desafio na experiência deautenticaçãoConclua a autenticaçãoResultado da autenticaçãoConclua ou confirme aautorização dopagamento quandoelegívelConsulte o pedido originalno backendStatus atual do pagamento
Comerciante ou clienteDEUNA

Uma ação 3DS retornada pode começar com verificações automáticas do navegador e do dispositivo, às vezes chamadas de 3DS Method. O cliente pode ver uma tela de carregamento antes de um desafio aparecer, ou o fluxo pode terminar sem solicitar nenhuma ação. Mantenha a experiência retornada aberta enquanto a DEUNA coordena essas etapas.

O emissor determina se o cliente precisa de um desafio. As etapas mostradas acima são condicionais; nem todo pagamento passa por todas as telas.

O sucesso na autenticação não garante o pagamento. Permite que a autorização continue. Sempre avalie o status final de pagamento após a etapa 3DS.

Dependendo da conexão, a autenticação pode terminar junto com a autorização ou antes dela. A DEUNA conclui as etapas restantes do pagamento. Seu checkout não deve enviar outra compra após o cliente concluir um desafio.

Modelos 3DS suportados#

3DS gerenciado pela DEUNA

A DEUNA coordena a autenticação e passa o resultado para a autorização de pagamento. Isso oferece aos comerciantes uma única integração e um único contrato com o cliente em conexões de aceitação compatíveis.

Utilize este modelo quando desejar que a DEUNA gerencie a jornada de autenticação e mantenha o comportamento de checkout consistente em diferentes provedores.

3DS gerenciado pelo provedor

Alguns provedores de pagamento expõem seu próprio fluxo 3DS através de sua conexão DEUNA. A DEUNA normaliza a ação necessária do cliente na resposta de pagamento e continua o pagamento quando a autenticação termina.

O suporte varia de acordo com o provedor, o país, a rede da placa e a configuração da conexão. Utilize o ao vivo catálogo de gateway de pagamento para verificar os recursos 3DS anunciados e, em seguida, confirme a ativação com seu gerente técnico de contas (TAM) da DEUNA.

Onde funciona#

IntegraçãoExperiência do compradorResponsabilidade do comerciante
Widget de pagamentoA DEUNA apresenta o fluxo dentro da experiência ou redirecionamento do widget suportado.Monitore o resultado do widget e confirme o status final do pagamento.
Link de PagamentoA DEUNA apresenta e completa a experiência de autenticação suportada.Configure a experiência de retorno e recupere o status de pagamento final da DEUNA.
API DiretaA resposta do pagamento pode retornar pending_3ds e uma próxima ação para verificações do navegador ou um desafio.Apresente a ação retornada com um SDK DEUNA compatível ou com a integração de navegador acordada e, em seguida, verifique o status do pagamento.
Cofre de PagamentosUm pagamento de cartão salvo pode retornar a mesma ação 3DS.Uso initNextAction Implemente a ação retornada com segurança, usando um SDK suportado.

Dados que melhoram a autenticação#

Dados completos e verdadeiros do comprador e do dispositivo ajudam o emissor a tomar uma decisão de risco melhor e podem aumentar a chance de um resultado sem atrito.

Grupo de dadosCampos recomendados
PagamentoValor, moeda ISO 4217, cartão ou token de cartão e referência do comerciante
CompradorNome, sobrenome, e-mail e número de telefone
Endereço de cobrançaLinha de endereço, cidade, código postal, país ISO 3166-1 alfa-2 e código de estado ISO 3166-2 quando aplicável
PedidoDescrição do item, quantidade, valor e contexto de envio, quando disponível
DispositivoIdentificador do dispositivo/sessão, endereço IP, agente do usuário, idioma do navegador, dimensões da tela, profundidade de cor e fuso horário.

Não enviar marcadores. Para os Estados Unidos, Canadá e China, envie um código de subdivisão ISO 3166-2 válido quando o endereço incluir um estado ou província. A enriquecimento de endereços pode estar disponível para configurações de conta selecionadas, mas o comerciante é responsável por coletar dados de checkout precisos.

Status e orientação de responsabilidade.#

  • pending_3ds significa que o fluxo de pagamento 3DS permanece sem resolução. Isso não garante que um desafio visível aparecerá.
  • processed confirma uma compra concluída; authorized confirma fundos reservados, ainda exigindo captura.
  • denied, cancelled, ou expired Indica que o pagamento não foi concluído.
  • Uma autenticação bem-sucedida pode fornecer benefícios de proteção contra fraudes, mas a elegibilidade depende da rede do cartão, ECI, valor de autenticação, tipo de transação, regras de mercado e motivo da disputa. Não se deve inferir a transferência de responsabilidade apenas com base no status do pagamento.

Veja Fluxo de Pagamento & Statuses para todo o ciclo de vida e fluxo de compra 3DS para integração com a API.

Próximos passos#

Nesta seção