> ## 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 empresas: histórico de KYT

> Consulte o histórico de transações de uma empresa na Didit e veja como a atividade contínua alimenta regras de velocidade, comportamento e triagem.

Toda transação que você envia com um identificador `vendor_data` correspondente a uma entidade Business (como solicitante, remetente, beneficiário ou contraparte) é vinculada a esse perfil de empresa. A empresa passa a funcionar como um registro contínuo da própria atividade, e o Monitoramento de transações usa esse histórico para alimentar regras de velocidade, comportamentais e de triagem no nível da empresa.

## Como obter as transações de uma empresa

Filtre a lista de transações pelo `vendor_data` da empresa:

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

A resposta traz todas as transações em que a empresa aparece como solicitante. Para o histórico do lado da contraparte, filtre no Business Console (o endpoint público de lista filtra apenas pelo solicitante).

## Como as transações se vinculam às empresas

```mermaid theme={null}
flowchart LR
    T["Transaction<br/>txn_id=tx-0042"]
    A["applicant:<br/>vendor_data=biz-acme"]
    C["counterparty:<br/>vendor_data=biz-widgets"]
    B1[Business: biz-acme]
    B2[Business: biz-widgets]
    T --> A
    T --> C
    A -.-> B1
    C -.-> B2
```

Cada transação inclui até quatro partes (`applicant`, `remitter`, `beneficiary`, `counterparty`). Quando uma parte inclui um `vendor_data` correspondente a uma entidade Business na sua aplicação, a Didit vincula essa parte à empresa. Partes sem `vendor_data` são armazenadas como snapshots externos (sem vínculo com entidade).

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

## Partes de tipos diferentes

Uma única transação pode ter usuários e empresas como partes, por exemplo, um usuário pessoa física pagando uma empresa:

```json theme={null}
{
  "txn_id": "tx-0099",
  "direction": "OUTBOUND",
  "amount": "500.00",
  "currency": "EUR",
  "applicant": { "vendor_data": "user-42" },
  "counterparty": { "vendor_data": "biz-acme" }
}
```

Ou uma transferência B2B entre duas empresas:

```json theme={null}
{
  "txn_id": "tx-0100",
  "direction": "OUTBOUND",
  "amount": "120000.00",
  "currency": "USD",
  "applicant": { "vendor_data": "biz-acme" },
  "counterparty": { "vendor_data": "biz-widgets" }
}
```

A Didit faz a correspondência de cada parte de forma independente com base no `vendor_data`, e a mesma transação entra nos perfis de todas as entidades correspondentes.

## Sinais de risco agregados

As transações alimentam estes sinais no nível da empresa:

| Sinal | Usado por |
| - | - |
| Volume total de entrada / saída | Regras de velocidade, definição de limiares |
| Número de transações em uma janela 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 |
| Variedade de métodos de pagamento | Regras de fraude |

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

## Como as regras atuam sobre as empresas

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` da empresa a uma lista de bloqueio ou lista personalizada.

Quando uma regra adiciona a empresa a uma lista de bloqueio, a entidade Business passa para `BLOCKED` e um webhook `business.status.updated` é disparado.

## Monitoramento do comportamento de uma empresa

Use a aba Transações na página de detalhes da empresa 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 execuções de regras, enriquecimento de IP e resultados da triagem de cripto.
* Abrir um caso para a empresa para acompanhar uma investigação.

## Métodos de pagamento de uma empresa

Cada transação pode associar um ou mais métodos de pagamento (cartões bancários, contas bancárias, carteiras digitais, carteiras de cripto). Quando um método de pagamento pertence a uma empresa, ele é vinculado à empresa por meio do `vendor_data`, para que você veja todos os métodos de pagamento que uma empresa já usou, diretamente na página de detalhes da empresa.

## Ingestão de dados históricos

Para carregar transações históricas para uma empresa já existente, informe um `txn_date` 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": "25000.00",
    "currency": "EUR",
    "applicant": { "vendor_data": "biz-acme" },
    "counterparty": { "name": "Historic payer" }
  }'
```

> [!NOTE]
>
> As transações históricas também passam pelo mecanismo de regras. Se quiser ingerir o histórico **sem** acionar regras, use o fluxo de importação do console, que oferece um modo de ingestão sem acionar regras (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 nas empresas.

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