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

# Транзакции компании: история KYT

> Получите историю транзакций компании в Didit и узнайте, как активность влияет на правила Мониторинга транзакций: скорость, поведение и скрининг.

Каждая транзакция, которую вы отправляете с идентификатором `vendor_data`, совпадающим с идентификатором сущности Business, когда компания выступает заявителем, отправителем, получателем или контрагентом, привязывается к профилю этой компании. Компания становится журналом своей активности, а Мониторинг транзакций использует эту историю для правил контроля частоты операций, поведенческих правил и правил скрининга на уровне компании.

## Получение транзакций компании

Отфильтруйте список транзакций по `vendor_data` компании:

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

Возвращает все транзакции, в которых компания указана как заявитель. Чтобы получить историю со стороны контрагента, используйте фильтр в Business Console (публичный endpoint списка фильтрует только по заявителю).

## Как транзакции связываются с компаниями

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

Каждая транзакция включает до четырёх участников (`applicant`, `remitter`, `beneficiary`, `counterparty`). Если участник содержит `vendor_data`, совпадающий с сущностью Business в вашем приложении, Didit связывает этого участника с данной компанией. Участники без `vendor_data` сохраняются как внешние снимки без связи с сущностью.

Полную модель участников см. в разделе [отправка транзакций](https://docs.didit.me/ru/transaction-monitoring/transactions.md).

## Смешанные типы участников

Одна транзакция может объединять пользователей и компании среди участников, например, когда физическое лицо платит компании:

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

Или B2B-перевод между двумя компаниями:

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

Didit определяет каждого участника независимо на основе `vendor_data`, поэтому одна и та же транзакция попадает в профили всех совпавших сущностей.

## Агрегированные сигналы риска

Транзакции формируют следующие сигналы на уровне компании:

| Сигнал | Используется в |
| - | - |
| Общий объём входящих / исходящих транзакций | Правилах контроля частоты операций, применении порогов |
| Количество транзакций за временной интервал | Правилах контроля частоты операций |
| Уникальные контрагенты | Поведенческих правилах |
| Затронутые юрисдикции высокого риска | Географических правилах |
| Взаимодействие с контрагентами, находящимися под санкциями | Правилах скрининга |
| Разнообразие способов оплаты | Правилах противодействия мошенничеству |

Эти сигналы вычисляются в реальном времени и проверяются по вашим активным [правилам для транзакций](https://docs.didit.me/ru/transaction-monitoring/rules.md). Когда правило срабатывает, компания может быть автоматически переведена в статус `FLAGGED` или `BLOCKED` в зависимости от действия правила.

## Как правила воздействуют на компании

Поле `actions` правила для транзакций может включать:

* `add_score`: увеличивает оценку риска транзакции.
* `change_status`: задаёт статус транзакции (`IN_REVIEW`, `DECLINED`, `AWAITING_USER`).
* `add_tags`: добавляет теги к транзакции.
* `add_to_list`: добавляет `vendor_data` компании в список блокировки или пользовательский список.

Когда правило добавляет компанию в список блокировки, сущность Business переводится в статус `BLOCKED`, и отправляется webhook `business.status.updated`.

## Мониторинг поведения компании

Используйте вкладку «Транзакции» на странице сведений о компании в Business Console, чтобы:

* Видеть все транзакции в хронологическом порядке.
* Фильтровать по статусу, сумме, направлению и контрагенту.
* Открывать любую транзакцию и просматривать результаты выполнения правил, обогащение по IP и результаты скрининга криптовалют.
* Открыть кейс по компании для отслеживания расследования.

## Способы оплаты, принадлежащие компании

Каждая транзакция может содержать один или несколько способов оплаты (банковские карты, банковские счета, электронные кошельки, криптокошельки). Если способ оплаты принадлежит компании, он связывается с ней через `vendor_data`, поэтому на странице сведений о компании видны все способы оплаты, которые она использовала ранее.

## Историческая загрузка

Чтобы загрузить исторические транзакции для существующей компании, передайте `txn_date` с датой в прошлом:

```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]
>
> Исторические транзакции всё равно проходят через движок правил. Если вы хотите загрузить историю **без** запуска правил, используйте импорт через консоль, который поддерживает режим "dry ingest" (загрузка без запуска правил).

## Следующие шаги

> [card] [Отправка транзакций](https://docs.didit.me/ru/transaction-monitoring/transactions.md)
>
> Полный справочник по payload.

> [card] [Правила](https://docs.didit.me/ru/transaction-monitoring/rules.md)
>
> Как правила оценивают транзакции и воздействуют на компании.

> [card] [Статусы](https://docs.didit.me/ru/transaction-monitoring/statuses.md)
>
> Справочник статусов транзакций и статусов устранения проблем.


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