> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitoramento de Transações

> Detecção de fraude em tempo real, conformidade AML e análise de transações — no produto de monitoramento de transações gu1 para fraude e AML.

## Introdução

O monitoramento de transações é a capacidade central do gu1 para analisar transações financeiras em tempo real. Nosso sistema permite que você detecte fraudes, garanta a conformidade AML, aplique limites de transação e identifique padrões suspeitos antes que se tornem problemas graves.

## Principais Recursos

<CardGroup cols={2}>
  <Card title="Análise em Tempo Real" icon="bolt">
    Analise transações em \< 500ms com decisões instantâneas
  </Card>

  <Card title="Motor de Regras Flexível" icon="sliders">
    Crie regras personalizadas com modos de execução síncronos e assíncronos
  </Card>

  <Card title="Alertas Inteligentes" icon="bell">
    Consolidação automática de alertas em investigações acionáveis
  </Card>

  <Card title="Multi-Moeda" icon="globe">
    Suporte nativo para mais de 150 moedas com conversão automática
  </Card>

  <Card title="Resolução de Entidades" icon="link">
    Vinculação automática de entidades (usuários, comerciantes, contas)
  </Card>

  <Card title="Conformidade" icon="shield-check">
    Conformidade integrada com regulamentações AML/CFT
  </Card>
</CardGroup>

## Casos de Uso

### 1. Detecção de Fraude em Tempo Real

Detecte e bloqueie transações fraudulentas antes que sejam processadas:

* Teste de cartões
* Comprometimento de contas
* Viagem impossível
* Padrões de velocidade de transações
* Geografias de alto risco

[Saiba mais sobre detecção de fraudes →](/pt/use-cases/transaction-monitoring/fraud-detection)

### 2. Monitoramento AML

Garanta a conformidade com regulamentações anti-lavagem de dinheiro:

* Estruturação (Smurfing)
* Padrões de camadas
* Países de alto risco (FATF)
* PEPs (Pessoas Politicamente Expostas)
* Relatórios de transações de alto valor

[Saiba mais sobre monitoramento AML →](/pt/use-cases/transaction-monitoring/aml-monitoring)

### 3. Limites de Transação

Imponha limites diários, semanais e mensais:

* Limites por usuário
* Limites por comerciante
* Por tipo de transação
* Por geografia
* Limites dinâmicos baseados em risco

### 4. Padrões Suspeitos

Detecte padrões comportamentais complexos:

* Frequência de transações incomum
* Valores atípicos
* Anomalias geográficas
* Mudanças no comportamento de transações
* Correlação entre múltiplas entidades

### 5. Monitoramento de Comerciantes

Para adquirentes e sub-adquirentes:

* Monitoramento de chargebacks
* Fraude de comerciantes
* Detecção de phishing
* Conformidade com termos
* Picos de velocidade de transações

[Saiba mais sobre monitoramento de comerciantes →](/pt/use-cases/transaction-monitoring/merchant-monitoring)

## Arquitetura do Sistema

```mermaid theme={null}
sequenceDiagram
    participant Client as Seu Sistema
    participant API as gu1 API
    participant Rules as Motor de Regras
    participant Alerts as Sistema de Alertas
    participant Intel as Inteligência

    Client->>API: POST /transaction/analyze
    API->>API: Validar payload
    API->>API: Resolver entidades origem/destino
    API->>API: Conversão de moeda (se aplicável)
    API->>API: Criar entidade de transação
    API->>Rules: Executar regras SYNC
    Rules->>Rules: Avaliar condições
    Rules-->>Alerts: Gerar alertas (se aplicável)
    Alerts-->>Intel: Consolidar em investigação
    Rules->>API: Retornar decisão
    API->>Client: Resposta (APPROVE/REJECT/HOLD)
```

## Fluxo de Processamento de Transações

### Etapa 1: Validação

O sistema valida o payload da transação contra schemas rigorosos, garantindo que todos os campos obrigatórios estejam presentes e corretamente formatados.

### Etapa 2: Resolução de Entidades

As entidades de origem e destino são resolvidas ou criadas. Isso permite rastrear o histórico de transações e padrões comportamentais.

### Etapa 3: Conversão de Moeda

Se a transação estiver em uma moeda diferente da sua moeda base, a conversão automática é realizada usando taxas em tempo real.

### Etapa 4: Criação da Entidade de Transação

Uma entidade de transação é criada no sistema com todas as informações relevantes, incluindo metadados, dados do dispositivo e relacionamentos de entidades.

### Etapa 5: Execução de Regras Síncronas

**Regras síncronas** são executadas e podem afetar a decisão da transação em tempo real. Essas regras podem:

* Aprovar a transação
* Rejeitá-la
* Colocá-la em espera para revisão
* Exigir autenticação adicional

### Etapa 6: Execução de Regras Assíncronas

**Regras assíncronas** são executadas em paralelo. Essas regras:

* Não afetam a decisão da transação
* Geram alertas para monitoramento
* São usadas para análise de padrões
* Alimentam o Dashboard de Inteligência

### Etapa 7: Resposta

O sistema retorna uma resposta completa incluindo:

* Decisão (APPROVE, REJECT, HOLD, etc.)
* Pontuação de risco
* Alertas gerados
* Ações recomendadas
* Metadados de execução

## Regras Síncronas vs Assíncronas

### Regras Síncronas

**Quando usar:**

* Precisa bloquear transações em tempo real
* Impor limites rígidos (valores, frequência)
* Detectar padrões críticos de fraude
* Requisitos regulatórios que proíbem a transação

**Características:**

* Executam durante a chamada da API
* Afetam a decisão da transação
* Retornam na resposta da API
* Meta de desempenho: \< 100ms por regra

**Exemplo de caso de uso:**

```
Se valor da transação > $10.000 E usuário não verificado
Então REJEITAR transação
```

### Regras Assíncronas

**Quando usar:**

* Monitoramento e análise de padrões
* Alertas que não requerem ação imediata
* Agregações complexas ao longo do tempo
* Detecção de comportamento suspeito

**Características:**

* Executam em paralelo
* Não afetam a transação
* Aparecem apenas no dashboard
* Podem realizar consultas complexas

**Exemplo de caso de uso:**

```
Se usuário tem > 10 transações na última hora
Então gerar alerta de severidade MÉDIA
```

## Geração e Consolidação de Alertas

### Como os Alertas são Gerados

Alertas são gerados quando:

1. Uma regra é configurada com ação `generate_alert`
2. As condições da regra são atendidas
3. O alerta é criado com severidade especificada

### Consolidação Automática

O motor de consolidação do gu1 automaticamente:

* Agrupa alertas relacionados em investigações
* Identifica padrões através de múltiplos alertas
* Prioriza com base em severidade e frequência
* Atribui às equipes apropriadas

### Integração com Inteligência

Todos os alertas fluem diretamente para o Dashboard de Inteligência onde:

* Equipes podem colaborar em investigações
* Contexto completo está disponível (histórico de entidades, transações relacionadas)
* Ações podem ser tomadas (aceitar, escalar, marcar como falso positivo)
* Trilha de auditoria é mantida automaticamente

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Referência da API" icon="code" href="/pt/use-cases/transaction-monitoring/api-reference">
    Documentação completa do endpoint
  </Card>

  <Card title="Configuração de Regras" icon="sliders" href="/pt/use-cases/transaction-monitoring/rules-configuration">
    Aprenda a criar e configurar regras
  </Card>

  <Card title="Detecção de Fraudes" icon="shield" href="/pt/use-cases/transaction-monitoring/fraud-detection">
    Proteja contra fraudes em tempo real
  </Card>

  <Card title="Monitoramento AML" icon="building-columns" href="/pt/use-cases/transaction-monitoring/aml-monitoring">
    Conformidade regulatória e detecção de lavagem de dinheiro
  </Card>
</CardGroup>