> ## 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 de utilizadores: histórico KYT e risco

> Obtenha o histórico de transações na Didit, usado nas regras de Monitorização de transações. 1,000 por mês incluídos, depois $0.001 cada.

Cada transação que submeter com um identificador `vendor_data` (como requerente ou como contraparte) fica associada à entidade User correspondente. O perfil do utilizador passa a funcionar como um registo contínuo da atividade da pessoa, e a Monitorização de transações usa este histórico para alimentar as regras de velocidade e as regras comportamentais.

## Recuperar as transações de um utilizador

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"
```

Devolve todas as transações em que o utilizador é o requerente. Para o histórico do lado da contraparte, filtre na Business Console (o endpoint público de listagem filtra apenas por requerente).

## Como as transações se ligam aos utilizadores

```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 intervenientes (requerente, remetente, beneficiário e contraparte). Quando um interveniente inclui `vendor_data`, a Didit associa-o a esse User. Os intervenientes sem `vendor_data` são guardados como instantâneos externos (sem ligação a uma entidade).

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

## Sinais de risco agregados

As transações alimentam os seguintes sinais ao nível do utilizador:

| Sinal | Utilizado por |
| - | - |
| Volume total de entrada / saída | Regras de velocidade, aplicação de limiares |
| Número de transações num intervalo de tempo | Regras de velocidade |
| Contrapartes únicas | Regras comportamentais |
| Jurisdições de alto risco envolvidas | Regras geográficas |
| Exposição a contrapartes sancionadas | Regras de triagem |
| Diversidade de métodos de pagamento | Regras de fraude |

Estes sinais são calculados em tempo real e avaliados face às suas [regras de transação](https://docs.didit.me/pt/transaction-monitoring/rules.md) ativas. Quando uma regra corresponde, o utilizador pode passar automaticamente para `FLAGGED` ou `BLOCKED`, consoante a ação da regra.

## Como as regras atuam sobre os utilizadores

O campo `actions` de uma regra de transação pode incluir:

* `add_score`: aumenta a pontuação de risco da transação.
* `change_status`: define o estado da transação (`IN_REVIEW`, `DECLINED`, `AWAITING_USER`).
* `add_tags`: marca a transação com etiquetas.
* `add_to_list`: adiciona o `vendor_data` do utilizador a uma lista de bloqueio ou a uma lista personalizada.

Quando uma regra adiciona o utilizador a uma lista de bloqueio, a respetiva entidade User passa para `BLOCKED` e dispara-se um webhook `user.status.updated`.

## Monitorizar o comportamento de um utilizador

Use o separador Transações na página de detalhe do utilizador da Business Console para:

* Ver todas as transações por ordem cronológica.
* Filtrar por estado, montante, 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 criptoativos.
* Abrir um caso sobre o utilizador 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** associada, que exige que o utilizador conclua verificações adicionais (por exemplo, documentação da origem dos fundos ou um documento de identificação atualizado). A sessão de remediação fica associada ao mesmo `vendor_data`; ao concluir, o estado da transação é atualizado automaticamente.

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

## Ingestão histórica

Para carregar retroativamente transações históricas para uma entidade User existente, indique um `txn_date` anterior ao dia de hoje:

```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 continuam a passar pelo motor de regras. Se pretender ingerir o histórico **sem** acionar as regras, use o fluxo de importação da consola, que suporta um modo "dry ingest".

## Próximos passos

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

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

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


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