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

# Início rápido do Monitoramento de transações: 10 minutos

> Envie sua primeira transação, veja as regras dispararem e configure webhooks, de ponta a ponta em menos de 10 minutos. $0.02 por transação, sem contratos.

Com este guia, a Didit coloca o Monitoramento de transações no ar em menos de 10 minutos. Você vai enviar uma transação de teste, inspecionar a pontuação, ativar uma regra predefinida, reenviar para vê-la disparar e confirmar que o webhook chega.

## Pré-requisitos

* Uma aplicação Didit com o Monitoramento de transações ativado (*Configurações → Monitoramento de transações → Ativar*).
* Uma chave de API.
* Um endpoint de webhook acessível pela internet.

## Passos

**1. Envie uma transação de referência**

```bash theme={null}
curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "baseline-0001",
    "transaction_category": "finance",
    "transaction_details": {
      "direction": "outbound",
      "amount": "500.00",
      "currency": "EUR"
    },
    "subject": { "entity_type": "person", "vendor_data": "user-42", "full_name": "Jane Doe" },
    "counterparty": { "entity_type": "company", "full_name": "Acme Supplier" }
  }'
```

A resposta inclui:

* `status` - `APPROVED` se nenhuma regra disparou, `IN_REVIEW` / `DECLINED` se alguma disparou.
* `score` - inteiro de 0 a 100+.
* `rule_runs` - array com todas as regras que avaliaram esta transação.

**2. Ative uma regra predefinida**

Acesse *Transações → Regras → Biblioteca* no Business Console. Escolha uma regra predefinida, por exemplo **Structuring (outbound)**: dispara quando o mesmo usuário envia 20+ transferências de saída abaixo de €10,000 em 30 dias. Ative e salve.

**3. Envie transações que disparem a regra**

Envie rapidamente 20 transações do mesmo usuário, cada uma abaixo de €10,000:

```bash theme={null}
for i in $(seq 1 20); do
  curl -X POST https://verification.didit.me/v3/transactions/ \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{
      \"transaction_id\": \"struct-$i\",
      \"transaction_category\": \"finance\",
      \"transaction_details\": {
        \"direction\": \"outbound\",
        \"amount\": \"9500.00\",
        \"currency\": \"EUR\"
      },
      \"subject\": { \"entity_type\": \"person\", \"vendor_data\": \"user-42\", \"full_name\": \"Jane Doe\" },
      \"counterparty\": { \"entity_type\": \"company\", \"full_name\": \"Shell Co $i\" }
    }"
done
```

No 20º envio, a regra Structuring dispara. A transação retorna `status: IN_REVIEW` e `score` reflete o `score_delta` da regra.

**4. Assine os webhooks de transação**

```bash theme={null}
curl -X POST https://verification.didit.me/v3/webhook/destinations/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "TM events",
    "url": "https://yourapp.com/webhooks/didit-tm",
    "subscribed_events": ["transaction.created", "transaction.status.updated"]
  }'
```

A resposta inclui `secret_shared_key` - salve-a imediatamente como `DIDIT_WEBHOOK_SECRET` no seu `.env`:

```bash theme={null}
DIDIT_WEBHOOK_SECRET=whsec_...   # signing secret returned from webhook registration
```

Depois, verifique o HMAC `X-Signature-V2` de cada webhook recebido antes de confiar nele (recalcule o HMAC-SHA256 sobre o corpo canonicalizado, compare em tempo constante e rejeite timestamps antigos). Veja os [webhooks de TM](https://docs.didit.me/transaction-monitoring/webhooks.md) para os payloads e o código completo de verificação.

Cada transação seguinte é enviada ao seu endpoint em tempo real.

**5. Inspecione no console**

Acesse *Transações* no console:

* Visão de lista: transações recentes, filtros, ações em massa.
* Detalhe da transação: execuções de regras, enriquecimento de IP, dados das partes, grafo de rede (para cripto), alertas e casos vinculados.

**6. Consulte uma transação pela API**

```bash theme={null}
curl https://verification.didit.me/v3/transactions/{transaction_id}/ \
  -H "x-api-key: YOUR_API_KEY"
```

Retorna o [esquema de resposta](https://docs.didit.me/transaction-monitoring/response-schema.md) completo: pontuação, regras acionadas, enriquecimento das partes, triagem AML e mais.

## O que você acabou de configurar

* **Pontuação em tempo real** - cada transação passa por todas as regras ativas.
* **Triagem AML** - as contrapartes são triadas automaticamente contra sanções e mídia negativa.
* **Enriquecimento de IP** - cada transação é enriquecida com país do IP, ASN e sinalizações de VPN/Tor.
* **Webhooks** - notificação em tempo real a cada transação.
* **Trilha de auditoria** - execuções de regras, alertas e transições de status podem ser consultados no console.

## Próximos passos comuns

> **[Guia de integração](https://docs.didit.me/transaction-monitoring/integration-guide.md)**
>
> Arquitetura completa e padrões.

> **[Regras em detalhe](https://docs.didit.me/transaction-monitoring/rules.md)**
>
> Como as regras funcionam: condições, agregações, ações.

> **[Pontuação de risco](https://docs.didit.me/transaction-monitoring/risk-scoring.md)**
>
> Como as pontuações se combinam em status.

> **[Payload de transações](https://docs.didit.me/transaction-monitoring/transactions.md)**
>
> O esquema completo de envio de transações.

> **[Status](https://docs.didit.me/transaction-monitoring/statuses.md)**
>
> Estados de transação, alerta e caso.

> **[Casos](https://docs.didit.me/transaction-monitoring/cases.md)**
>
> Investigue e resolva.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.