Pular para o conteúdo principal
Aprimore a segurança dos seus pagamentos online com o 3D Secure, o protocolo de autenticação padrão. Reduza as transações não autorizadas com uma camada extra de verificação, protegendo sua empresa e seus clientes sem comprometer a experiência do usuário. O 3D Secure (3DS) é um protocolo de autenticação desenvolvido para aumentar a segurança das transações online com cartão. Ele ajuda a prevenir o uso não autorizado do cartão, exigindo verificação adicional do titular durante o processo de pagamento. Essa camada extra de autenticação reduz a fraude e garante que a transação esteja sendo realizada pelo legítimo proprietário do cartão. O 3D Secure é amplamente utilizado por comerciantes, provedores de pagamento e instituições financeiras para melhorar a segurança das transações, mantendo uma experiência tranquila para o cliente.

Como funciona o 3D Secure

Quando um cliente inicia uma compra online e o processador de pagamentos tem o 3D Secure ativado, ocorre o seguinte processo:
  1. Iniciação da transação: O cliente insere os dados do cartão no seu site.
  2. Solicitação de autenticação: A transação é enviada para a Localpayment, que avalia se a autenticação é necessária.
  3. Verificação do usuário: Se a autenticação for necessária, o cliente será redirecionado para uma página segura onde deverá verificar sua identidade (por exemplo, usando uma senha de uso único, biometria ou autenticação por aplicativo bancário). Se nenhuma autenticação do titular do cartão for necessária (fluxo sem atrito), o fluxo de pagamento estabelecido em seu site continua de acordo com o resultado do processamento da solicitação.
  4. Resultado da autenticação:
    • Se a autenticação for bem-sucedida, o cliente será redirecionado para o URL especificado na propriedade redirectUrl.onSuccess da solicitação.
    • Caso a autenticação falhe, o cliente será redirecionado para o URL especificado na propriedade redirectUrl.onError.
    • O resultado da autenticação também será retornado na resposta da API.
  5. Conclusão do pagamento: Se a autenticação for bem-sucedida, a transação prossegue normalmente. Se a autenticação falhar, o pagamento é recusado.

Diagrama de fluxo de autenticação

A sequência abaixo mostra os dois resultados possíveis: o fluxo sem atrito (sem desafio) e o fluxo com desafio, onde o titular do cartão deve inserir uma senha de uso único (OTP) na página de autenticação do emissor. O status final que o Localpayment envia ao comerciante (na resposta da API ou no webhook) depende do fluxo de captura do pagamento:
  • AUTHORIZED: para transações em duas etapas (autorização e captura ocorrem separadamente).
  • APPROVED: a transação foi confirmada, mas os fundos ainda não foram liquidados. Você pode sacar os fundos quando o status mudar para COMPLETE, geralmente em 1 a 2 dias, dependendo do provedor.
  • COMPLETE: os fundos foram liquidados em tempo real.
  • REJECTED: a autenticação falhou ou expirou, ou a transação foi recusada por outro motivo (por exemplo, fundos insuficientes).

O que o titular do cartão vê durante o fluxo do desafio

As telas de desafio abaixo pertencem ao banco emissor do cartão e à rede do cartão (por exemplo, Visa ou Mastercard), não à Localpayment. A redação, a marca e o layout exatos variam de acordo com o emissor. Os exemplos abaixo usam dados fictícios para ilustrar o padrão geral.
Passo 1 — Escolha um método de verificação Dependendo da emissora do cartão, o fluxo de verificação pode permitir que o titular do cartão escolha como receber o código OTP (por exemplo, por e-mail ou SMS), conforme mostrado abaixo. Outras emissoras omitem essa opção e enviam o código por um único canal fixo.
Passo 2 — Insira o código de verificação
Se o titular do cartão não concluir o desafio ou inserir um código inválido, a transação será rejeitada e ele será redirecionado para redirectUrl.onError, conforme descrito na Etapa 2 abaixo.

Principais atores envolvidos

Diversas entidades estão envolvidas no processo 3D Secure:
  • Titular do cartão: A pessoa que realiza a transação com seu cartão de crédito ou débito.
  • Comerciante: a empresa online que aceita pagamentos com cartão.
  • Emissor: A instituição financeira que emitiu o cartão do cliente (por exemplo, um banco).
  • Adquirente: A instituição financeira que gerencia as transações do comerciante (Localpayment).
  • Servidor 3D Secure (3DSS): Um sistema que facilita a autenticação entre o comerciante, o emissor e as redes de pagamento.
  • Servidor de Controle de Acesso (ACS): Um sistema gerenciado pela instituição emissora que verifica a identidade do titular do cartão durante a autenticação.
  • Servidor de diretório: Um sistema gerenciado pela rede de cartões (por exemplo, Visa, Mastercard) que ajuda a encaminhar as solicitações de autenticação para o emissor correto.

Benefícios do 3D Secure

A implementação do 3D Secure oferece diversos benefícios tanto para comerciantes quanto para clientes:
  • Segurança reforçada: Reduz o risco de transações fraudulentas, garantindo que somente o titular do cartão possa autorizar pagamentos.
  • Maior confiança do cliente: Oferece uma camada adicional de proteção, dando aos clientes confiança ao fazer compras online.
  • Redução das taxas de fraude: Diminui significativamente as transações não autorizadas e as potenciais perdas financeiras.

Antes de começar

Certifique-se de ter:

Credenciais da API

Credenciais de API e token de acesso válidos para autenticação.

Configuração da conta

Configuração adequada da conta para o país de destino e verificação da empresa.

Lista branca de IPs

Adicione os endereços IP do seu servidor à lista de permissões para acesso à API.

Endpoint do webhook

Configure um URL de webhook para receber notificações de pagamento.

Etapa 1: Autenticação 3D Secure

Envie o objeto redirectUrl ao fazer um Pagamento único ou uma Assinatura , incluindo as propriedades onSuccess e onError. Essas propriedades definem os URLs para onde seu cliente será redirecionado em caso de autenticação bem-sucedida ou de erro, respectivamente. O paymentMethod.code depende do país, da bandeira do cartão e do produto (crédito ou débito). No Peru, ele também depende da moeda. Consulte Códigos de método de pagamento com cartão para ver a lista completa.

Exemplo de solicitação

Abaixo está um exemplo usando curl:
curl

Etapa 2: Lidar com a resposta

Resposta bem-sucedida

Se for necessária autenticação adicional durante o processo de pagamento, a resposta da API incluirá a propriedade redirectUrl. Esse URL aponta para um modal ou página que deve ser exibido ao titular do cartão, permitindo que ele conclua o desafio de autenticação com o emissor do cartão.
Se a transação exigir autenticação pelo titular do cartão, ela permanece com o status INPROGRESS até que a autenticação seja concluída. Dependendo do fluxo de captura do pagamento, uma autenticação bem-sucedida move a transação para AUTHORIZED (transações em duas etapas aguardando captura), APPROVED (aguardando liquidação) ou COMPLETE (fundos liquidados em tempo real). Se a autenticação falhar, expirar ou a transação for recusada por outro motivo (por exemplo, fundos insuficientes), o status será REJECTED. Após a autenticação do cliente (bem-sucedida ou não), o cliente será redirecionado para o URL especificado na solicitação, de acordo com o resultado. As propriedades internalId e externalId serão incluídas como parâmetros de consulta, permitindo que você implemente a lógica necessária (por exemplo, verificar o status da transação e exibir uma mensagem ao usuário).
Última modificação em 20 de novembro de 2026