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

# Transações do usuário: histórico KYT e risco

> Consulte o histórico de transações de um usuário e veja como a Didit o usa nas regras de monitoramento. 1,000 por mês incluídas, depois $0.001 cada.

Toda transação que você envia com um identificador `vendor_data` (seja como requerente ou como contraparte) fica vinculada à entidade de usuário correspondente. O perfil do usuário passa a ser um registro contínuo da atividade da pessoa, e o Monitoramento de transações usa esse histórico para alimentar as regras de frequência e comportamentais.

## Como recuperar as transações de um usuário

Filtre a lista de transações por `vendor_data`:

```bash theme={null}
curl -G https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42" \
  --data-urlencode "page_size=50"
```

Retorna todas as transações em que o usuário é o requerente. Para o histórico da contraparte, filtre no Business Console (o endpoint público de listagem filtra apenas por requerente).

## Como as transações são vinculadas aos usuários

```mermaid theme={null}
flowchart LR
    T["Transaction<br/>txn_id=tx-0001"]
    A["applicant:<br/>vendor_data=user-42"]
    C["counterparty:<br/>vendor_data=user-99"]
    U1[User: user-42]
    U2[User: user-99]
    T --> A
    T --> C
    A -.-> U1
    C -.-> U2
```

Cada transação inclui até quatro partes (requerente, remetente, beneficiário, contraparte). Quando uma parte inclui `vendor_data`, a Didit a vincula a esse usuário. As partes sem `vendor_data` são armazenadas como snapshots externos (sem vínculo com uma entidade).

Consulte [envio de transações](https://docs.didit.me/pt-br/transaction-monitoring/transactions.md) para ver o modelo completo de partes.

## Sinais de risco agregados

As transações alimentam os seguintes sinais no nível do usuário:

| Sinal | Usado por |
| - | - |
| Volume total de entrada / saída | Regras de velocidade, definição de limiares |
| Quantidade de transações em uma janela de tempo | Regras de velocidade |
| Contrapartes únicas | Regras de comportamento |
| Jurisdições de alto risco envolvidas | Regras de geografia |
| Exposição a contrapartes sancionadas | Regras de triagem |
| Variedade de métodos de pagamento | Regras de fraude |

Esses sinais são calculados em tempo real e avaliados com base nas suas [regras de transação](https://docs.didit.me/pt-br/transaction-monitoring/rules.md) ativas. Quando uma regra é atendida, o status do usuário pode ser alterado automaticamente para `FLAGGED` ou `BLOCKED`, dependendo da ação da regra.

## Como as regras atuam sobre os usuários

As `actions` de uma regra de transação podem incluir:

* `add_score`: aumenta a pontuação de risco da transação.
* `change_status`: define o status da transação (`IN_REVIEW`, `DECLINED`, `AWAITING_USER`).
* `add_tags`: adiciona tags à transação.
* `add_to_list`: adiciona o `vendor_data` do usuário a uma lista de bloqueio ou a uma lista personalizada.

Quando uma regra adiciona o usuário a uma lista de bloqueio, a entidade User dele passa para `BLOCKED` e um webhook `user.status.updated` é disparado.

## Como monitorar o comportamento de um usuário

Use a aba Transações na página de detalhes do usuário no Business Console para:

* Ver todas as transações em ordem cronológica.
* Filtrar por status, valor, direção e contraparte.
* Abrir qualquer transação para inspecionar as execuções de regras, o enriquecimento de IP e os resultados da triagem de cripto.
* Abrir um caso para o usuário para acompanhar uma investigação.

## Sessões de remediação

Quando uma transação entra em `AWAITING_USER`, a Didit cria uma **sessão de remediação** vinculada, que exige que o usuário conclua uma verificação adicional (por exemplo, documentação de origem dos recursos ou um documento de identidade atualizado). A sessão de remediação está vinculada ao mesmo `vendor_data`: ao ser concluída, o status da transação é atualizado automaticamente.

Consulte [status das transações](https://docs.didit.me/pt-br/transaction-monitoring/statuses.md) para ver a máquina de estados completa.

## Ingestão de histórico

Para carregar transações históricas em uma entidade User existente, envie `txn_date` com uma data no passado:

```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 '{
    "txn_id": "legacy-0001",
    "txn_date": "2024-03-15T10:00:00Z",
    "direction": "INBOUND",
    "amount": "2500.00",
    "currency": "EUR",
    "applicant": { "vendor_data": "user-42" },
    "counterparty": { "name": "Historic payer" }
  }'
```

> [!NOTE]
>
> As transações históricas também passam pelo mecanismo de regras. Se você quiser importar o histórico **sem** acionar regras, use o fluxo de importação do console, que oferece um modo de "dry ingest".

## Próximos passos

> [card] [Enviar transações](https://docs.didit.me/pt-br/transaction-monitoring/transactions.md)
>
> Referência completa do payload.

> [card] [Regras](https://docs.didit.me/pt-br/transaction-monitoring/rules.md)
>
> Como as regras avaliam transações e atuam sobre os usuários.

> [card] [Status](https://docs.didit.me/pt-br/transaction-monitoring/statuses.md)
>
> Referência de status de transação e de remediação.


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