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

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

> Triagem de transações em tempo real da Didit com pontuação por regras, verificações de velocidade, AML e gestão de casos. $0.02 por transação, sem contratos.

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.

[Detecte fraudes em tempo real: o motor de regras — Didit Academy](https://www.youtube.com/embed/Yhm63_n7HuU?rel=0\&playsinline=1)

Novo no TM da Didit? Comece pelo [início rápido](https://docs.didit.me/pt-br/transaction-monitoring/quickstart.md) para uma configuração em 10 minutos e depois leia o [guia de integração](https://docs.didit.me/transaction-monitoring/integration-guide.md) para conhecer a arquitetura e os padrões de produção. A [pontuação de risco](https://docs.didit.me/transaction-monitoring/risk-scoring.md) explica exatamente como as pontuações são calculadas.

## Como funciona

**1. Enviar uma transação**

Envie os dados da transação pela API [Create Transaction](https://docs.didit.me/management-api/transactions/create.md). 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](https://docs.didit.me/transaction-monitoring/transactions.md) para a referência completa do payload.

**2. 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.

**3. 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.

**4. 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](https://docs.didit.me/transaction-monitoring/aml-screening.md) 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](https://docs.didit.me/integration/webhooks.md) |

## Integração

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

```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": "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](https://docs.didit.me/management-api/transactions/create.md) para o schema completo do payload.

## Próximos passos

> **[Envio de transações](https://docs.didit.me/transaction-monitoring/transactions.md)**
>
> Referência completa do payload da API Create Transaction.

> **[Regras e pontuação](https://docs.didit.me/transaction-monitoring/rules.md)**
>
> Como o motor de regras funciona, pacotes integrados e criação de regras personalizadas.

> **[Ingestão de eventos](https://docs.didit.me/transaction-monitoring/events.md)**
>
> Envie logins, partidas, bônus, pagamentos e disputas para o mesmo motor.

> **[Triagem de criptoativos](https://docs.didit.me/transaction-monitoring/aml-screening.md)**
>
> Triagem de carteiras, origem dos fundos e visualização da rede.

> **[Travel Rule](https://docs.didit.me/transaction-monitoring/travel-rule.md)**
>
> Dados de conformidade da Travel Rule para transferências de ativos virtuais.

> **[Casos e investigações](https://docs.didit.me/transaction-monitoring/cases.md)**
>
> Abra casos, atribua analistas e gerencie fluxos de investigação.

> **[Configurações](https://docs.didit.me/transaction-monitoring/settings.md)**
>
> Limites de pontuação, provedores e configuração de remediação.


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