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

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

Submeter uma transação de referência

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.

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.

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 €:

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.

Subscrever webhooks de transações

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:

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 para ver os payloads e o código completo de verificação.Cada transação seguinte é enviada para o seu endpoint em tempo real.

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.

Obter uma transação através da API

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

Devolve o esquema de resposta 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

Guia de integração

Arquitetura completa e padrões.

Análise aprofundada das regras

Como funcionam as regras, condições, agregações e ações.

Pontuação de risco

Como as pontuações se combinam em estados.

Payload de transações

O esquema completo de submissão de transações.

Estados

Estados de transações, alertas e casos.

Casos

Investigar e resolver.

Primeiros passos

Funcionalidades

Referência

Consola

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

Pré-requisitos

Passos

O que acabou de configurar

Próximos passos comuns

Guia de integração

Análise aprofundada das regras

Pontuação de risco

Payload de transações

Estados

Casos

​Pré-requisitos

​Passos

​O que acabou de configurar

​Próximos passos comuns

Guia de integração

Análise aprofundada das regras

Pontuação de risco

Payload de transações

Estados

Casos

Pré-requisitos

Passos

O que acabou de configurar

Próximos passos comuns