API de Monitoramento de Transações: Regras em Tempo Real, Gestão de Casos e Fluxos de SAR (PT-BR)

Integrar um usuário com KYC informa quem ele é no primeiro dia. Mas não diz nada sobre o que ele faz no nonagésimo dia. O monitoramento de transações é a outra metade da conformidade — a camada contínua que observa o movimento do dinheiro e sinaliza os padrões que importam: estruturação, entradas e saídas rápidas, picos de velocidade, contrapartes sancionadas e jurisdições de alto risco.

A API de Monitoramento de Transações da Didit é um motor de regras em tempo real para exatamente isso. Você envia uma transação, ela retorna uma decisão em milissegundos, e qualquer coisa que aciona uma regra é direcionada para um gerenciador de casos integrado, onde seus analistas investigam, escalam e registram Relatórios de Atividades Suspeitas (SARs). Funciona tanto para moedas fiduciárias quanto para criptomoedas, e custa US$ 0,02 por transação, sem mínimo.

Este guia explica como funciona, o que o motor de regras oferece e como integrá-lo.

Principais pontos

• Tomada de decisão em tempo real. Cada transação retorna um dos quatro status — APROVADO, EM_REVISÃO, RECUSADO ou AGUARDANDO_USUÁRIO — para que você possa agir antes que o dinheiro seja liquidado.
• 11 pacotes de regras integrados cobrem AML/CTF, detecção de anomalias, padrões FATF, inteligência de dispositivo, fraude, monitoramento de cripto, triagem de cripto, jogo responsável e e-commerce. Construa os seus próprios em cima disso.
• Gerenciamento de casos e fluxo de trabalho SAR integrados — alertas, atribuição de analistas, estados de investigação e registro de SARs vivem dentro do mesmo produto, não em uma ferramenta separada.
• Remediação automática AGUARDANDO_USUÁRIO permite que uma transação sinalizada acione uma etapa de verificação (re-KYC, prova de fundos) e seja retomada automaticamente assim que o usuário a concluir.
• Moedas fiduciárias e cripto em um único motor. Transações de cripto podem acionar automaticamente a triagem de carteiras on-chain.
• US$ 0,02 por transação, pago por chamada, sem mínimo. A triagem AML de uma parte sinalizada é cobrada separadamente a US$ 0,20 por verificação.

O que o monitoramento de transações faz

Uma verificação KYC é um instantâneo; o monitoramento de transações é o filme. Uma vez que o usuário é integrado, cada pagamento, transferência, depósito, saque, aposta ou negociação que ele faz é um sinal. Vistos individualmente, a maioria desses sinais são ruídos. Vistos como um fluxo — com janelas de velocidade, agregação e contexto de contraparte — os padrões que indicam lavagem de dinheiro, fraude ou evasão de sanções se tornam visíveis.

A Didit pontua cada transação à medida que ela ocorre, usando uma biblioteca de regras, atribui uma pontuação de risco e um status. Transações de baixo risco passam silenciosamente. Qualquer coisa que ultrapasse um limite é retida para revisão, recusada diretamente ou encaminhada de volta ao usuário para remediação — e um alerta é aberto para um analista.

Por que isso importa

Os reguladores esperam monitoramento contínuo, não apenas verificações de integração. As diretivas AML da UE, as recomendações do FATF e regimes equivalentes em todo o mundo exigem que as empresas regulamentadas monitorem as transações com base no risco e relatem atividades suspeitas. As falhas são caras: estruturação perdida, contrapartes sancionadas não detectadas ou um padrão de velocidade que se revela uma rede de “mulas”.

O problema operacional é igualmente real. A maioria das equipes monta o monitoramento a partir de um fornecedor de regras, uma ferramenta de gerenciamento de casos separada e um processo manual de SAR em planilhas. A Didit consolida essa pilha em uma única API e um único console: regras, alertas, investigação e relatórios no mesmo lugar, com preço por transação para que o custo aumente com o uso, em vez de licenças por assento.

Detalhes técnicos

As transações são criadas usando a API unificada /v3/. Cada transação é idempotente em um transaction_id que você controla (único por aplicativo), então as tentativas de repetição nunca contam em dobro.

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "txn_8f3a91",
    "category": "finance",
    "amount": 9800,
    "currency": "EUR",
    "currency_kind": "fiat",
    "txn_date": "2026-05-21T10:32:00Z",
    "subject": {
      "vendor_data": "user_4521",
      "role": "SENDER",
      "entity_type": "INDIVIDUAL"
    },
    "counterparty": {
      "role": "RECEIVER",
      "entity_type": "INDIVIDUAL"
    },
    "payment_method": "BANK_TRANSFER"
  }'

O motor avalia a transação contra cada regra ativa e retorna um status, além das regras que foram acionadas:

{
  "transaction_id": "txn_8f3a91",
  "status": "IN_REVIEW",
  "risk_score": 62,
  "triggered_rules": [
    { "name": "Estruturação — valor abaixo do limite de relatório", "bundle": "AML/CTF", "action": "ADD_SCORE" },
    { "name": "Alta velocidade — contagem do remetente em 24h", "bundle": "Detecção de anomalias", "action": "CHANGE_STATUS" }
  ],
  "alert_id": "alrt_2c70d4"
}

Status. Toda transação é resolvida para um dos quatro status:

Status	Significado
APROVADO	Nenhuma regra ultrapassou um limite de recusa — a transação prossegue.
EM_REVISÃO	Uma regra sinalizou a transação — um alerta é aberto para um analista.
RECUSADO	Uma regra rígida (por exemplo, contraparte sancionada) bloqueou a transação.
AGUARDANDO_USUÁRIO	A transação é retida aguardando uma ação do usuário — re-verificação ou prova de fundos.

Categorias. As transações possuem uma category para que as regras sejam aplicadas no contexto: finance, kyc, travel_rule, user_platform_event, gambling_bet, gambling_limit_change, gambling_bonus_change e audit_trail_event.

Velocidade e agregação. As regras personalizadas são avaliadas em janelas de tempo com agregações de contagem, soma e contagem distinta — para que você possa expressar “mais de 5 transferências de entrada de contrapartes distintas em 24 horas” ou “volume cumulativo acima de €10.000 em 7 dias” sem escrever seu próprio processador de fluxo.

Webhooks. Assine transaction.created e transaction.status.updated para manter seu registro sincronizado quando um analista resolver um alerta.

Preço. US$ 0,02 por transação, cobrado por chamada, sem mínimo. Se uma transação sinalizada acionar a triagem AML em uma parte, essa verificação é cobrada separadamente a US$ 0,20.

Os 11 pacotes de regras integrados

Você não começa com um livro de regras em branco. A Didit inicializa o motor com 11 pacotes que você pode ativar e ajustar:

1. Finanças — estruturação, grandes transações, evasão de limites.
2. AML/CTF — volume cumulativo, entradas/saídas rápidas, sanções, exposição a PEPs, jurisdições de alto risco.
3. Detecção de anomalias — picos de velocidade, reativação de contas dormentes, outliers comportamentais.
4. FATF — padrões alinhados aos indicadores de alerta vermelho do FATF.
5. Inteligência de dispositivo — impressão digital do dispositivo e sinais de risco de sessão.
6. Prevenção de fraude — padrões de “mulas”, múltiplas contas, sinais de apropriação de conta.
7. Monitoramento de cripto — padrões de transação on-chain.
8. Triagem de cripto — risco de carteira e exposição à origem dos fundos.
9. Jogo responsável — velocidade de depósito, mudanças de limite, abuso de bônus.
10. E-commerce — padrões de chargeback e abuso de reembolso.
11. Personalizado — suas próprias regras com condições, janelas de velocidade e ações.

A ação de cada regra pode adicionar à pontuação de risco, alterar o status, adicionar tags ou notas, ou adicionar a parte a uma lista — de modo que a política é expressa de forma declarativa, e as alterações são revisadas no Console em vez de serem enviadas em código.

Cripto, triagem de carteira e a Regra de Viagem (Travel Rule)

Defina currency_kind: "crypto" com uma direção (INBOUND ou OUTBOUND) e o motor pode executar automaticamente a triagem de carteira on-chain no endereço da contraparte — verificando a exposição a entidades sancionadas, mercados da darknet, misturadores, ransomware e fundos roubados. A triagem de carteira começa em US$ 0,02 por triagem com BYOK (Crystal ou Merkle Science).

Para Provedores de Serviços de Ativos Virtuais (VASPs), o mesmo motor oferece suporte à Regra de Viagem (Travel Rule) do FATF: troca de dados do originador e beneficiário com rastreamento de obrigações entre protocolos e status dedicados da regra de viagem (COMPLIANT, PENDING_ACTION, PENDING_COUNTERPARTY, EXEMPT e outros). Um produto abrange monitoramento, triagem e a Regra de Viagem.

Gerenciamento de casos e fluxo de trabalho SAR

Quando uma regra é acionada, um alerta é aberto. A Didit oferece o ambiente de trabalho para lidar com isso — nenhuma ferramenta de caso separada é necessária.

• Alertas possuem uma origem (acionado por regra, acionado por provedor ou criado por analista) e passam por estados: ABERTO, INVESTIGANDO, AGUARDANDO_USUÁRIO, SAR_PENDENTE, SAR_REGISTRADO, RESOLVIDO, IGNORADO.
• Casos agrupam alertas relacionados, contêm prioridade e gravidade, e rastreiam uma investigação por ABERTO, EM_REVISÃO, AGUARDANDO_USUÁRIO, EM_ESPERA e RESOLVIDO.
• Analistas são atribuídos, o desempenho é mensurável e o fluxo de trabalho SAR reside no mesmo console onde o alerta foi gerado.

O caminho AGUARDANDO_USUÁRIO é o que torna isso prático em escala: em vez de uma recusa rígida, uma transação sinalizada pode pausar e pedir ao usuário para resolvê-la — re-verificar a identidade, fornecer prova de fundos — e então retomar automaticamente assim que ele o fizer. O atrito ocorre apenas onde o risco existe.

Como integrar com a Didit

1. Construa o fluxo de trabalho. No Business Console, ative os pacotes de regras relevantes para o seu negócio e ajuste os limites. O construtor de regras personalizadas é exclusivo do Console por design, para que a conformidade revise cada alteração.
2. Envie transações. POST /v3/transactions/ do seu backend conforme o dinheiro se move. Use um transaction_id estável para idempotência e passe vendor_data para que as transações se vinculem ao usuário ou entidade comercial a que pertencem.
3. Gerencie webhooks. Monitore transaction.status.updated para reagir quando um analista resolver um alerta ou uma remediação AGUARDANDO_USUÁRIO for concluída.
4. Trabalhe com alertas no Console. Investigue, escale para um caso e registre SARs na mesma interface.

Como tudo está na API unificada /v3/, uma sessão KYB pode gerar sessões KYC para seus UBOs, esses usuários fluem para o monitoramento de transações, e uma transação sinalizada pode gerar um KYC de remediação — uma plataforma de identidade e fraude, de ponta a ponta.

Perguntas frequentes

Quanto custa o monitoramento de transações?

US$ 0,02 por transação, cobrado por chamada, sem mínimo. A triagem AML em uma parte sinalizada é cobrada separadamente a US$ 0,20 por verificação, e a triagem de carteira on-chain começa em US$ 0,02 por triagem com BYOK.

Funciona para cripto e para moedas fiduciárias?

Sim. Defina currency_kind como fiat ou crypto. Transações de cripto podem acionar automaticamente a triagem de carteira on-chain e possuem suporte à Regra de Viagem (Travel Rule) do FATF.

Preciso construir minha própria ferramenta de gerenciamento de casos?

Não. Alertas, atribuição de analistas, estados de investigação e o fluxo de trabalho SAR são integrados ao mesmo produto e console.

Posso escrever minhas próprias regras?

Sim. Além dos 11 pacotes predefinidos, você pode criar regras personalizadas com condições, janelas de velocidade e agregações. As regras são gerenciadas no Console para que a conformidade revise cada alteração.

O que é a remediação automática AGUARDANDO_USUÁRIO?

Em vez de uma recusa rígida, uma transação sinalizada pode pausar e solicitar uma ação do usuário — re-verificação ou prova de fundos — e então retomar automaticamente assim que o usuário a concluir.

Pronto para começar?

Leia a visão geral do Monitoramento de Transações na documentação, veja como ele se encaixa no resto da plataforma na página do produto Monitoramento de Transações, e verifique os preços transparentes por chamada na página de preços. Quando estiver pronto, comece gratuitamente — 500 verificações KYC gratuitas todos os meses e monitoramento de transações a US$ 0,02 por chamada.