API de monitoramento de transações em tempo real (KYT)

O monitoramento de transações da Didit permite triar cada transação em tempo real, de entrada e de saída, com um motor de regras configurável. Cada transação recebe uma pontuação de risco, e as regras podem aprovar automaticamente, sinalizar para revisão ou recusar com base nos seus limites. Esta lição da Didit Academy percorre o motor de regras com dados reais: o feed de transações, como a pontuação de risco é calculada, a criação de regras com gatilhos e condições, o backtest e a ativação do monitoramento de criptoativos. Novo no TM da Didit? Comece pelo início rápido para uma configuração em 10 minutos e depois leia o guia de integração para conhecer a arquitetura e os padrões de produção. A pontuação de risco explica exatamente como as pontuações são calculadas.

Como funciona

Enviar uma transação

Envie os dados da transação pela API Create Transaction. Cada transação inclui as partes titular e contraparte, os detalhes financeiros (valor, moeda, direção), informações do meio de pagamento e, opcionalmente, contexto do dispositivo e propriedades personalizadas para a avaliação das regras.A Didit oferece suporte a várias categorias de transação, de transações financeiras padrão a eventos de apostas, transferências da Travel Rule e registros de trilha de auditoria. Veja Envio de transações para a referência completa do payload.

O motor de regras avalia

A Didit executa a transação contra todas as regras ativas da sua aplicação. As regras podem verificar:

Limites por transação - limites de valor, países de alto risco, entidades na lista de bloqueio
Janelas de velocidade - volume ou quantidade acumulados ao longo do tempo (por exemplo, mais de $10,000 em 24 horas)
Padrões de comportamento - detecção de fracionamento, entrada e saída rápidas de recursos, padrões de valores redondos
Análise AML - verificações de sanções e listas de observação sobre contrapartes e usuários vinculados, por provedores externos
Risco da carteira - exposição a mixers, endereços de carteira de alto risco (para transações com criptoativos)

Cada regra que corresponde contribui para a pontuação de risco geral da transação.

Pontuar e decidir

Com base na pontuação acumulada e na correspondência de regra de maior severidade, a transação recebe um status:

Status	Significado
`APPROVED`	Abaixo de todos os limites - a transação está limpa
`IN_REVIEW`	Sinalizada para revisão manual de um analista
`DECLINED`	Rejeitada automaticamente por uma regra
`AWAITING_USER`	Exige uma verificação adicional do usuário

Quando uma transação entra em AWAITING_USER, a Didit cria automaticamente uma sessão de remediação vinculada e devolve uma URL de verificação, para que você continue o fluxo sem sair do espaço de trabalho da transação.

Monitorar e investigar

Use o Business Console ou a API para:

Revisar transações sinalizadas com todo o contexto (pontuações, regras acionadas, partes vinculadas)
Abrir casos de investigação e atribuir analistas
Acompanhar o desempenho dos analistas e os tempos de resolução
Exportar dados de transações para relatórios de conformidade

Triagem de criptoativos

Para transações com criptomoedas, a Didit tria automaticamente endereços de carteira e hashes de transação em provedores de análise de blockchain (Crystal, Merkle Science e outros). A triagem é executada no servidor durante a criação da transação - sem chamadas de API adicionais do seu lado. Cada triagem produz uma pontuação de risco padronizada, uma análise da origem dos fundos com detalhamento por categoria de exposição, tabelas de exposição e um grafo de rede interativo. Os resultados alimentam diretamente o motor de regras: regras predefinidas como “Sanctions counterparty” e “Darknet market exposure” disparam automaticamente. Veja a triagem de criptoativos para detalhes dos provedores, preços, categorias de exposição e visualização da rede.

Principais recursos

Recurso	Descrição
Pontuação em tempo real	Cada transação é pontuada instantaneamente contra todas as regras ativas
Biblioteca de regras integrada	Regras pré-configuradas para AML/CFT, fraude, criptoativos, jogo responsável e análise de blockchain
Regras personalizadas	Crie regras no console com condições, janelas de velocidade, escopos e ações automáticas
Triagem de criptoativos	Triagem automática de carteiras e transações por Crystal, Merkle Science e outros
Análise da origem dos fundos	Detalhamento da origem dos recursos - corretoras, mixers, entidades sancionadas, golpes
Conexões de contrapartes	Visão por entidade de com quem a carteira já transacionou
Grafo de rede	Grafo visual interativo das relações entre carteiras e dos fluxos de fundos
Conformidade com a Travel Rule	Acompanhe os dados do originador e do beneficiário, os detalhes do protocolo e o status da obrigação em transferências de ativos virtuais
Fluxos de remediação	Dispare automaticamente a verificação do usuário quando uma regra exige verificações adicionais
Gestão de casos	Abra casos, vincule alertas e transações, atribua analistas e anexe evidências
Configurações ajustáveis	Ajuste limites de pontuação, moeda padrão, preferências de provedores e fluxos de remediação por aplicação
Webhooks	Receba os eventos `transaction.created`, `transaction.updated`, `transaction.status.changed` e `transaction.alert.generated` em tempo real por webhooks

Integração

Envie transações pela API e receba os resultados por webhooks:

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "finance0001",
    "transaction_category": "finance",
    "transaction_details": {
      "direction": "outbound",
      "amount": "1200.00",
      "currency": "EUR"
    },
    "subject": { "entity_type": "person", "vendor_data": "user-123", "full_name": "John Doe" },
    "counterparty": { "entity_type": "person", "full_name": "Jane Doe" }
  }'

Veja a referência da API para o schema completo do payload.

Próximos passos

Envio de transações

Referência completa do payload da API Create Transaction.

Regras e pontuação

Como o motor de regras funciona, pacotes integrados e criação de regras personalizadas.

Ingestão de eventos

Envie logins, partidas, bônus, pagamentos e disputas para o mesmo motor.

Triagem de criptoativos

Triagem de carteiras, origem dos fundos e visualização da rede.

Travel Rule

Dados de conformidade da Travel Rule para transferências de ativos virtuais.

Casos e investigações

Abra casos, atribua analistas e gerencie fluxos de investigação.

Configurações

Limites de pontuação, provedores e configuração de remediação.

​Como funciona

​Triagem de criptoativos

​Principais recursos

​Integração

​Próximos passos

Envio de transações

Regras e pontuação

Ingestão de eventos

Triagem de criptoativos

Travel Rule

Casos e investigações

Configurações

Como funciona

Triagem de criptoativos

Principais recursos

Integração

Próximos passos