Мониторинг транзакций: быстрый старт за 10 минут

Настройте Мониторинг транзакций менее чем за 10 минут. Вы отправите тестовую транзакцию, проверите её оценку, включите готовое правило, отправите транзакции повторно, чтобы убедиться, что правило срабатывает, и проверите, что webhook приходит.

Предварительные требования

Приложение Didit с включённым мониторингом транзакций (Settings → Transaction Monitoring → Enable).
API-ключ.
Webhook-эндпоинт, доступный из интернета.

Шаги

Отправьте базовую транзакцию

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "baseline-0001",
    "transaction_category": "finance",
    "transaction_details": {
      "direction": "outbound",
      "amount": "500.00",
      "currency": "EUR"
    },
    "subject": { "entity_type": "person", "vendor_data": "user-42", "full_name": "Jane Doe" },
    "counterparty": { "entity_type": "company", "full_name": "Acme Supplier" }
  }'

Ответ содержит:

status: APPROVED, если ни одно правило не сработало, IN_REVIEW или DECLINED, если сработало хотя бы одно.
score: целое число от 0 до 100+.
rule_runs: массив всех правил, которые оценили эту транзакцию.

Включите готовое правило

В Business Console перейдите в Transactions → Rules → Library. Выберите готовое правило, например Structuring (outbound): оно срабатывает, когда один и тот же пользователь отправляет 20+ исходящих переводов на сумму менее €10,000 в течение 30 дней. Включите его и сохраните.

Отправьте транзакции, которые запускают правило

Быстро отправьте 20 транзакций для одного и того же пользователя, каждая на сумму менее €10,000:

for i in $(seq 1 20); do
  curl -X POST https://verification.didit.me/v3/transactions/ \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{
      \"transaction_id\": \"struct-$i\",
      \"transaction_category\": \"finance\",
      \"transaction_details\": {
        \"direction\": \"outbound\",
        \"amount\": \"9500.00\",
        \"currency\": \"EUR\"
      },
      \"subject\": { \"entity_type\": \"person\", \"vendor_data\": \"user-42\", \"full_name\": \"Jane Doe\" },
      \"counterparty\": { \"entity_type\": \"company\", \"full_name\": \"Shell Co $i\" }
    }"
done

К 20-й отправке правило Structuring срабатывает. Транзакция возвращает status: IN_REVIEW, а score отражает score_delta правила.

Подпишитесь на webhook транзакций

curl -X POST https://verification.didit.me/v3/webhook/destinations/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "TM events",
    "url": "https://yourapp.com/webhooks/didit-tm",
    "subscribed_events": ["transaction.created", "transaction.status.updated"]
  }'

Ответ содержит secret_shared_key. Сразу сохраните его как DIDIT_WEBHOOK_SECRET в вашем .env:

DIDIT_WEBHOOK_SECRET=whsec_...   # signing secret returned from webhook registration

Затем проверяйте HMAC X-Signature-V2 для каждого входящего webhook, прежде чем ему доверять: пересчитайте HMAC-SHA256 по канонизированному телу, сравните за константное время и отклоняйте устаревшие метки времени. Payload и полный код проверки см. в разделе TM webhooks.Каждая последующая транзакция отправляется на ваш эндпоинт в реальном времени.

Проверьте в консоли

Перейдите в Transactions в консоли:

Список: последние транзакции, фильтры, массовые действия.
Детали транзакции: запуски правил, обогащение данными IP, данные сторон, граф сети (для криптовалют), связанные оповещения и кейсы.

Получите транзакцию через API

curl https://verification.didit.me/v3/transactions/{transaction_id}/ \
  -H "x-api-key: YOUR_API_KEY"

Возвращает полную схему ответа: оценку, сработавшие правила, обогащение данных стороны, AML-скрининг и многое другое.

Что вы только что настроили

Оценка в реальном времени: каждая транзакция проходит через все активные правила.
AML-скрининг: контрагенты автоматически проверяются по санкционным спискам и негативным публикациям в СМИ.
Обогащение данными IP: каждая транзакция дополняется страной IP, ASN и флагами VPN/Tor.
Webhook: уведомления в реальном времени о каждой транзакции.
Журнал аудита: срабатывания правил, оповещения и переходы статусов можно запрашивать в консоли.

Дальнейшие шаги

Руководство по интеграции

Полная архитектура и паттерны.

Подробно о правилах

Как работают правила, условия, агрегации и действия.

Скоринг рисков

Как оценки объединяются в статусы.

Payload транзакций

Полная схема отправки транзакции.

Статусы

Состояния транзакций, оповещений и кейсов.

Кейсы

Расследуйте и закрывайте.

Начало работы

Функции

Справочник

Консоль

Мониторинг транзакций: быстрый старт за 10 минут

Предварительные требования

Шаги

Что вы только что настроили

Дальнейшие шаги

Руководство по интеграции

Подробно о правилах

Скоринг рисков

Payload транзакций

Статусы

Кейсы

​Предварительные требования

​Шаги

​Что вы только что настроили

​Дальнейшие шаги

Руководство по интеграции

Подробно о правилах

Скоринг рисков

Payload транзакций

Статусы

Кейсы

Предварительные требования

Шаги

Что вы только что настроили

Дальнейшие шаги