> ## Documentation Index
> Fetch the complete documentation index at: https://docs.malga.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Começando em 3DS2 Malga

## O que é 3DS 2.0?

**3DS 2.0** (3-D Secure 2.0) é um protocolo de segurança para pagamentos online que verifica se o comprador é realmente o dono do cartão antes de autorizar a transação.

Funciona como uma verificação extra: quando você faz uma compra online, o banco pode pedir uma confirmação adicional (senha, código SMS, biometria) para garantir que é você mesmo fazendo a compra.

### Por que "3D Secure"?

O nome vem dos **três domínios** que trabalham juntos na transação:

* **Lojista** (sua loja e processador de pagamento)
* **Banco emissor** (banco que emitiu o cartão)
* **Bandeira** (Visa, Mastercard, etc.)

***

## Como funciona na prática?

O 3DS 2.0 é mais inteligente que a versão anterior:

* **Transações de baixo risco**: Autenticação invisível, sem interrupção
* **Transações de alto risco**: Solicita verificação extra (SMS, app do banco, biometria)
* **Dados ricos**: Envia mais de 100 informações para análise de risco
* **Mobile-first**: Funciona perfeitamente em apps e sites mobile

***

## Quem participa do processo?

* **Cliente**: Compra e pode ser solicitado a se autenticar
* **Lojista**: Integra o 3DS no checkout
* **Malga**: Gerencia a comunicação com o protocolo 3DS
* **Bandeira**: Conecta sua loja ao banco emissor
* **Banco emissor**: Verifica a identidade do cliente

***

## Benefícios para sua loja

* ✅ **Menos fraudes** - Cliente autenticado = menos chargebacks
* ✅ **Mais aprovações** - Bancos confiam mais em transações 3DS
* ✅ **Proteção legal** - Em caso de fraude, responsabilidade é do emissor
* ✅ **Débito online** - Muitos bancos exigem 3DS para cartões de débito
* ✅ **Conformidade** - Atende regulamentações como PSD2/SCA

***

## Fluxo básico

O 3DS 2.0 funciona de duas formas, dependendo do nível de risco da transação:

### 1. Autenticação invisível (frictionless)

Quando a transação é de baixo risco, tudo acontece sem interrupção:

```mermaid theme={null}
sequenceDiagram
  participant C as "Cliente"
  participant L as "Loja"
  participant M as "Malga"
  participant X as "3DS"
  participant Y as "Gateway"
  C -->> L: Inicia checkout<br/>e envia dados do cartão
  L -->> M: Requisição de transação<br/>(intenção 3DS)
  M -->> X: Inicia autenticação 3DS
  X -->> M: Devolve tokens para autorização (frictionless)
  M -->> Y: Solicita autorização financeira
  Y -->> M: Aprova ou nega transação
  M -->> L: Retorna status (authorized/failed)
  L -->> C: Mostra resultado do pagamento
```

### 2. Autenticação com desafio

Quando há risco maior, o cliente precisa se autenticar:

```mermaid theme={null}
sequenceDiagram
  participant C as "Cliente"
  participant L as "Loja"
  participant M as "Malga"
  participant X as "3DS"
  participant Y as "Gateway"
  C -->> L: Inicia checkout<br/>e envia dados do cartão
  L -->> M: Requisição de transação<br/>(intenção 3DS)
  M -->> X: Inicia autenticação 3DS
  alt Desafio requerido
    X -->> M: Solicita desafio (Challenge)
    M -->> L: Dados do desafio
    L -->> C: Apresenta desafio para cliente
    C -->> X: Responde desafio (OTP, biometria, etc)
    X -->> M: Resultado do desafio
  end
  M -->> Y: Solicita autorização financeira
  Y -->> M: Aprova ou nega transação
  M -->> L: Retorna status (authorized/failed)
  L -->> C: Mostra resultado do pagamento
```

**Dica:** A maioria das transações é autenticada de forma invisível. O desafio só aparece quando o banco detecta algo suspeito.

***

## Próximos passos

Agora que você entende o básico do 3DS 2.0, vamos para a implementação prática. A Malga oferece uma integração simples que você pode usar no seu checkout.

<Card title="Getting started" href="/documentations/3ds2-malga/3ds-malga/pre-requisitos-configuracao" cta="Comece a integrar agora" horizontal arrow />

## Conheça mais sobre o 3DS 2.0

<CardGroup cols={3}>
  <Card title="3DS Data Only" href="/documentations/3ds2-malga/3ds-data-only">
    Análise de risco sem interrupção do checkout
  </Card>

  <Card title="3DS MPI Externo" href="/documentations/3ds2-malga/3ds-mpi-externo">
    Autenticação com MPI externo
  </Card>

  <Card title="Glossário" href="/documentations/3ds2-malga/glossario-3ds">
    Termos técnicos do 3DS 2.0
  </Card>
</CardGroup>