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

# Monitorização de transações: início rápido em 10 min

> Com a Didit, envie a primeira transação e veja as regras a disparar em menos de 10 min. 1.000 transações/mês incluídas, depois $0.001 cada.

Configure a Monitorização de transações em menos de 10 minutos. Vai submeter uma transação de teste, consultar a respetiva pontuação, ativar uma regra predefinida, voltar a submeter para ver a regra ser acionada e confirmar que o webhook chega.

## Pré-requisitos

* Uma aplicação Didit com a Monitorização de transações ativada (*Definições → Monitorização de transações → Ativar*).
* Uma chave de API.
* Um endpoint de webhook acessível a partir da internet.

## Passos

**1. Submeter 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 tiver sido acionada, `IN_REVIEW` / `DECLINED` se alguma o tiver sido.
* `score` — inteiro de 0 a 100+.
* `rule_runs` — array de todas as regras que avaliaram esta transação.

**2. Ativar uma regra predefinida**

Aceda a *Transações → Regras → Biblioteca* na Business Console. Escolha uma predefinida, por exemplo **Estruturação (saída)**: é acionada quando o mesmo utilizador envia 20+ transferências de saída, abaixo de 10.000 €, no prazo de 30 dias. Ative-a e guarde.

**3. Submeter transações que acionem a regra**

Submeta 20 transações em rápida sucessão para o mesmo utilizador, 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
```

Na 20.ª submissão, a regra de Estruturação é acionada. A transação devolve `status: IN_REVIEW` e o `score` reflete o `score_delta` da regra.

**4. Subscrever webhooks de transações**

```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`. Guarde-a imediatamente como `DIDIT_WEBHOOK_SECRET` no seu `.env`:

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

Em seguida, verifique o HMAC `X-Signature-V2` em cada webhook recebido, antes de confiar nele (recalcule o HMAC-SHA256 sobre o corpo canonizado, faça a comparação em tempo constante e rejeite carimbos temporais desatualizados). Consulte [webhooks de TM](https://docs.didit.me/pt/transaction-monitoring/webhooks.md) para ver os payloads e o código completo de verificação.

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

**5. Inspecionar na consola**

Aceda a *Transações* na consola:

* Vista 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 associados.

**6. Obter uma transação através da API**

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

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

## O que acabou de configurar

* **Pontuação em tempo real**: cada transação passa por cada regra ativa.
* **Triagem AML**: as contrapartes são verificadas automaticamente contra sanções e notícias adversas.
* **Enriquecimento de IP**: cada transação é enriquecida com o país do IP, o ASN e os indicadores de VPN/Tor.
* **Webhooks**: notificação em tempo real de cada transação.
* **Registo de auditoria**: as execuções de regras, os alertas e as transições de estado são todos consultáveis na consola.

## Próximos passos comuns

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

> [card] [Análise aprofundada das regras](https://docs.didit.me/pt/transaction-monitoring/rules.md)
>
> Como funcionam as regras, condições, agregações e ações.

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

> [card] [Payload de transações](https://docs.didit.me/pt/transaction-monitoring/transactions.md)
>
> O esquema completo de submissão de transações.

> [card] [Estados](https://docs.didit.me/pt/transaction-monitoring/statuses.md)
>
> Estados de transações, alertas e casos.

> [card] [Casos](https://docs.didit.me/pt/transaction-monitoring/cases.md)
>
> Investigar e resolver.


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