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

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

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

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

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 списка фильтрует только по заявителю).

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

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

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

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

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

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

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

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

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

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

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

Эти сигналы вычисляются в реальном времени и проверяются по вашим активным правилам для транзакций. Когда правило срабатывает, компания может быть автоматически переведена в статус 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 с датой в прошлом:

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" }
  }'

Исторические транзакции всё равно проходят через движок правил. Если вы хотите загрузить историю без запуска правил, используйте импорт через консоль, который поддерживает режим “dry ingest” (загрузка без запуска правил).

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

Отправка транзакций

Полный справочник по payload.

Правила

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

Статусы

Справочник статусов транзакций и статусов устранения проблем.

Обзор

Цены

Сценарии и верификация

Проверка и операции

Сущности (пользователи и компании)

Настройки и кастомизация

Безопасность и комплаенс

Didit Academy

Ресурсы

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

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

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

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

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

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

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

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

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

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

Отправка транзакций

Правила

Статусы

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

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

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

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

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

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

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

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

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

Отправка транзакций

Правила

Статусы

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

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

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

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

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

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

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

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

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