> ## 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.

# Exemplo prático

Para facilitar o entendimento, a Malga disponibiliza um **projeto de demonstração (demo)** open-source ilustrando a integração do 3DS2. Esse projeto contém um servidor Node.js simples (simulando seu backend) e uma página de checkout web, demonstrando todos os passos descritos necessários no checkout.

Você pode encontrar o código-fonte no GitHub: [plughacker/malga-3ds-demo](https://github.com/plughacker/malga-3ds-demo)

No README do projeto há instruções de como executá-lo localmente. Em resumo:

1. **Configure as variáveis de ambiente (.env)** com suas credenciais da Malga e IDs necessários – incluindo `MERCHANT_ID`, `API_KEY` e `CLIENT_ID` da sua conta, além das URLs base da Malga (sandbox ou produção).
2. **Instale as dependências**:
   ```bash theme={null}
   npm install
   ```
3. **Inicie o servidor**:
   ```bash theme={null}
   npm run serve
   ```
4. **Abra o endereço local** (por padrão [http://localhost:3000](http://localhost:3000)), preencha os dados solicitados (informações do cartão, etc.) e clique em "Pay".

O demo então executa o setup, coleta de dados, criação da cobrança e, se necessário, apresenta o desafio em uma interface simplificada, retornando o resultado no final.

Essa demonstração é uma ótima referência para ver a sequência completa em funcionamento e pode servir de base para seus testes iniciais. Recomendamos estudá-la para entender a integração ponta-a-ponta. Lembre-se de usar as credenciais de **Sandbox** da Malga ao testar em ambiente de homologação, para não acionar transações reais.