> ## 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 и её использование в правилах Мониторинга транзакций. 1,000 в месяц включено, далее $0.001 за каждую.

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

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

Отфильтруйте список транзакций по `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"
```

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

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

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

Каждая транзакция включает до четырёх сторон: заявителя, плательщика, получателя и контрагента. Если сторона содержит `vendor_data`, Didit привязывает её к этому пользователю. Стороны без `vendor_data` сохраняются как внешние снимки без связи с сущностью.

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

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

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

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

Эти сигналы вычисляются в реальном времени и сверяются с вашими активными [правилами для транзакций](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` пользователя в список блокировки или настраиваемый список.

Когда правило добавляет пользователя в список блокировки, его сущность User переходит в статус `BLOCKED`, и отправляется webhook `user.status.updated`.

## Мониторинг поведения пользователя

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

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

## Сессии для устранения проблем

Когда транзакция переходит в статус `AWAITING_USER`, Didit создаёт связанную **сессию устранения**, которая требует от пользователя пройти дополнительную верификацию (например, предоставить документы об источнике средств или обновлённый документ, удостоверяющий личность). Сессия устранения привязана к тому же `vendor_data`: после её завершения статус транзакции обновляется автоматически.

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

## Импорт исторических данных

Чтобы загрузить исторические транзакции для существующей сущности User, укажите в поле `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": "2500.00",
    "currency": "EUR",
    "applicant": { "vendor_data": "user-42" },
    "counterparty": { "name": "Historic payer" }
  }'
```

> [!NOTE]
>
> Исторические транзакции по-прежнему проходят через движок правил. Если вы хотите загрузить историю **без** запуска правил, используйте сценарий импорта через консоль, который поддерживает режим «пробной загрузки» (режим загрузки без запуска правил).

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

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