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

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

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

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.

Envie transações que disparem a regra

Envie rapidamente 20 transações do mesmo usuário, 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

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

Assine os webhooks de transação

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:

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

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.

Consulte uma transação pela API

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

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

Arquitetura completa e padrões.

Regras em detalhe

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

Pontuação de risco

Como as pontuações se combinam em status.

Payload de transações

O esquema completo de envio de transações.

Status

Estados de transação, alerta e caso.

Casos

Investigue e resolva.

​Pré-requisitos

​Passos

​O que você acabou de configurar

​Próximos passos comuns