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

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

> Отправьте первую транзакцию и подключите webhooks в Didit за 10 минут. 1,000 транзакций в месяц включены, далее $0.001 за каждую.

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

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

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

## Шаги

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

```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 '{
    "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`: массив всех правил, которые оценили эту транзакцию.

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

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

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

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

```bash theme={null}
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` правила.

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

```bash theme={null}
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`:

```bash theme={null}
DIDIT_WEBHOOK_SECRET=whsec_...   # signing secret returned from webhook registration
```

Затем проверяйте HMAC `X-Signature-V2` для каждого входящего webhook, прежде чем ему доверять: пересчитайте HMAC-SHA256 по канонизированному телу, сравните за константное время и отклоняйте устаревшие метки времени. Payload и полный код проверки см. в разделе [TM webhooks](https://docs.didit.me/ru/transaction-monitoring/webhooks.md).

Каждая последующая транзакция отправляется на ваш эндпоинт в реальном времени.

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

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

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

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

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

Возвращает полную [схему ответа](https://docs.didit.me/ru/transaction-monitoring/response-schema.md): оценку, сработавшие правила, обогащение данных стороны, AML-скрининг и многое другое.

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

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

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

> [card] [Руководство по интеграции](https://docs.didit.me/ru/transaction-monitoring/integration-guide.md)
>
> Полная архитектура и паттерны.

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

> [card] [Скоринг рисков](https://docs.didit.me/ru/transaction-monitoring/risk-scoring.md)
>
> Как оценки объединяются в статусы.

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

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

> [card] [Кейсы](https://docs.didit.me/ru/transaction-monitoring/cases.md)
>
> Расследуйте и закрывайте.


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