> ## 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 Monitorização de Transações em Tempo Real (KYT)

> Didit oferece monitorização de transações em tempo real com regras, velocidade e AML. 1,000 transações/mês incluídas, depois $0.001 cada.

A Monitorização de Transações da Didit permite-lhe analisar cada transação em tempo real, tanto de entrada como de saída, através de 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 limiares.

Esta lição da Didit Academy percorre o motor de regras com dados reais: o fluxo de transações, o modo como a pontuação de risco é calculada, a criação de regras com acionadores e condições, o teste retrospetivo e a ativação da monitorização de criptoativos.

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

É novo na Didit TM? Comece pelo [guia de início rápido](https://docs.didit.me/pt/transaction-monitoring/quickstart.md), que demora cerca de 10 minutos a configurar, e depois leia o [guia de integração](https://docs.didit.me/pt/transaction-monitoring/integration-guide.md) para a arquitetura e os padrões de produção. A [pontuação de risco](https://docs.didit.me/pt/transaction-monitoring/risk-scoring.md) explica exatamente como as pontuações são calculadas.

## Como funciona

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

Envie os dados da transação através da API [Criar transação](https://docs.didit.me/pt/management-api/transactions/create.md). Cada transação inclui o sujeito e a contraparte, os dados financeiros (montante, moeda, sentido), as informações sobre o método de pagamento e, opcionalmente, o contexto do dispositivo e propriedades personalizadas para a avaliação das regras.

A Didit suporta várias categorias de transação, desde transações financeiras padrão a eventos de jogo, transferências Travel Rule e registos de auditoria. Consulte [Envio de transações](https://docs.didit.me/pt/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:

* **Limiares por transação individual**: limites de montante, países de alto risco, entidades em lista de bloqueio
* **Janelas de velocidade**: volume ou número acumulado ao longo do tempo (por exemplo, mais de \$10,000 em 24 horas)
* **Padrões comportamentais**: deteção de fracionamento (structuring), movimentos rápidos de entrada e saída, padrões de valores redondos
* **Triagem AML**: verificações de sanções e de listas de vigilância sobre contrapartes e utilizadores associados, através de fornecedores externos
* **Risco de Carteira**: exposição a mixers, endereços de carteiras de alto risco (para transações com criptoativos)

Cada regra correspondente contribui para a pontuação de risco global da transação.

**3. Pontue e decida**

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

| Estado | Significado |
| - | - |
| `APPROVED` | Abaixo de todos os limiares: transação limpa |
| `IN_REVIEW` | Sinalizada para revisão manual pelo analista |
| `DECLINED` | Recusada automaticamente por uma regra |
| `AWAITING_USER` | Requer verificação adicional do utilizador |

Quando uma transação passa para `AWAITING_USER`, a Didit cria automaticamente uma sessão de remediação associada e devolve um URL de verificação, para que possa continuar o fluxo sem sair do espaço de trabalho da transação.

**4. Monitorize e investigue**

Utilize a Business Console ou a API para:

* Reveja as transações sinalizadas com o contexto completo (pontuações, regras correspondentes, partes associadas)
* Abra casos de investigação e atribua analistas
* Acompanhe o desempenho dos analistas e os tempos de resolução
* Exporte os dados das transações para relatórios de conformidade

## Triagem de criptoativos

Para transações com criptoativos, a Didit faz automaticamente a triagem dos endereços de carteiras e dos hashes de transações junto de fornecedores de análise de blockchain (Crystal, Merkle Science e outros). A triagem é executada no servidor durante a criação da transação, sem necessidade de chamadas de API adicionais da sua parte.

Cada triagem produz uma pontuação de risco padronizada, uma análise da origem dos fundos com a repartição por categorias de exposição, tabelas de exposição e um grafo de rede interativo. Os resultados alimentam diretamente o motor de regras, e regras predefinidas como "Sanctions counterparty" e "Darknet market exposure" são disparadas automaticamente.

Consulte [triagem de criptoativos](https://docs.didit.me/pt/transaction-monitoring/aml-screening.md) para os detalhes dos fornecedores, preços, categorias de exposição e visualização da rede.

## Capacidades principais

| Capacidade | Descrição |
| - | - |
| **Pontuação em tempo real** | Cada transação é pontuada de imediato em relação a todas as regras ativas |
| **Biblioteca de regras integrada** | Regras pré-configuradas para AML/CFT, fraude, cripto, jogo responsável e análise de blockchain |
| **Regras personalizadas** | Crie regras na consola com condições, janelas de velocidade, âmbitos e ações automatizadas |
| **Triagem de criptoativos** | Triagem automática de carteiras e transações através da Crystal, da Merkle Science e de outros |
| **Análise da origem dos fundos** | Repartição da origem dos fundos: bolsas, mixers, entidades sancionadas, burlas |
| **Ligações com contrapartes** | Visão, ao nível da entidade, das contrapartes com quem a carteira transacionou |
| **Grafo da rede** | Grafo visual interativo das relações entre carteiras e dos fluxos de fundos |
| **Conformidade com a Travel Rule** | Acompanhe os dados do ordenante e do beneficiário, os detalhes do protocolo e o estado das obrigações para transferências de ativos virtuais |
| **Fluxos de remediação** | Acione automaticamente a verificação do utilizador quando uma regra exigir verificações adicionais |
| **Gestão de casos** | Abra casos, associe alertas e transações, atribua analistas e anexe evidências |
| **Definições configuráveis** | Ajuste os limiares de pontuação, a moeda predefinida, as preferências de fornecedores e os fluxos de remediação por aplicação |
| **Webhooks** | Receba em tempo real os eventos `transaction.created`, `transaction.status.updated` e `travel_rule.status.updated` através de [webhooks](https://docs.didit.me/pt/integration/webhooks.md) |

## Integração

Envie transações através da API e receba os resultados através de 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" }
  }'
```

Consulte a [Referência da API](https://docs.didit.me/pt/management-api/transactions/create.md) para o esquema completo do payload.

## Preços

O seu plano inclui um número de transações monitorizadas por mês: 1.000 no plano Free, 10.000 no Growth e 100.000 no Scale, e o número definido no seu contrato no plano Enterprise. Cada transação para além da franquia custa o preço de lista de $0.001, menos o desconto do seu plano: $0.001 nos planos Free e Growth, e \$0.0009 no plano Scale.
A franquia é por organização, é reposta no dia 1 de cada mês e nunca transita para o mês seguinte. A Didit avisa quando tiver utilizado 80% da franquia e novamente aos 100%.

A triagem de carteiras de criptoativos numa transação e a triagem AML das partes mantêm os seus próprios preços. Consulte [preços](https://docs.didit.me/pt/getting-started/pricing.md#monitorização-de-transações-kyt) para ver todas as tarifas.

## Próximos passos

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

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

> [card] [Ingestão de eventos](https://docs.didit.me/pt/transaction-monitoring/events.md)
>
> Envie inícios de sessão, jogabilidade, bónus, pagamentos e contestações para o mesmo motor.

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

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

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

> [card] [Definições](https://docs.didit.me/pt/transaction-monitoring/settings.md)
>
> Limiares de pontuação, fornecedores e configuração de remediação.


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