KYT для криптобирж и он-рампов: Руководство по интеграции (RU)

Криптобиржа или он-рамп имеют ровно два момента, когда риск "на блокчейне" входит или выходит из бизнеса: поступает депозит и осуществляется вывод средств. Правильно настройте проверку в этих двух точках, и вы покроете основу "Знай свою транзакцию" (KYT). Если вы сделаете это неправильно — проверите слишком поздно, проверите не то, что нужно, или будете рассматривать каждое совпадение как ручной запрос — вы либо примете "грязные" средства, либо завалите своих аналитиков работой.

Это руководство по интеграции Wallet Screening от Didit в процесс ввода/вывода средств. Оно охватывает, где проводить проверку, как кодировать политику, чтобы большинство решений были автоматическими, и как обрабатывать те, которые не являются таковыми — все это на унифицированном API /v3/ по цене $0.02 за проверку с использованием собственного ключа (BYOK).

Ключевые выводы

• Две точки проверки: проверяйте адрес депозита при вводе, проверяйте адрес назначения при выводе.
• Контролируйте до расчетов. Предтранзакционный скрининг позволяет отклонить депозит или заблокировать вывод средств до перемещения стоимости.
• Кодируйте политику как правила, чтобы LOW/MEDIUM проходили автоматически, HIGH направлялись на проверку, а CRITICAL отклонялись — аналитики занимаются только пограничными случаями.
• Записи после перевода по хешу транзакции обеспечивают аудиторский след и позволяют выявлять ретроактивные санкционные меры.
• Встроенное управление кейсами + рабочий процесс SAR — оповещения открываются в одной консоли, без отдельного инструмента.
• $0.02 за проверку с BYOK (Crystal или Merkle Science); оплата за вызов, без минимумов.

Что KYT означает для биржи

KYC проверяет, кто ваш пользователь при регистрации. KYT отслеживает, что происходит с его деньгами после этого — в частности, откуда поступила криптовалюта, которую он депонирует, и куда направляется криптовалюта, которую он выводит. Для биржи или он-рампа обязательство конкретно: не принимать средства, связанные с санкциями, миксерами, даркнетом, вымогательством или крадеными средствами, и не отправлять средства на кошельки с такими же связями. Проверка кошельков — это механизм, который обеспечивает это транзакция за транзакцией.

Почему это важно

Депозиты и выводы — это единственные две двери, через которые проходит стоимость, поэтому это единственные две двери, через которые проходит риск. Принятый "грязный" депозит — это риск отмывания денег в вашей бухгалтерии; вывод средств на санкционный кошелек — это нарушение санкций, независимо от намерений. Регуляторные ожидания для VASP — это явный постоянный мониторинг транзакций, а практические ожидания заключаются в том, что вы обнаружите это до расчетов, а не в ежемесячном обзоре.

Причина, по которой команды исторически недооценивали скрининг, заключалась в стоимости: устаревшие подписки на блокчейн-аналитику оценивали скрининг как корпоративный контракт. По цене $0.02 за проверку с BYOK это ограничение исчезло — вы можете проверять каждый депозит и каждый вывод средств и при этом быть примерно в 10 раз дешевле, чем при покупке данных напрямую.

Технические детали

Все работает на POST /v3/transactions/. Установите currency_kind: "crypto", направление и адрес, который вы проверяете.

Депозит (INBOUND) — проверяйте адрес источника перед зачислением:

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "dep_a31f",
    "category": "finance",
    "amount": 8000,
    "currency": "USDT",
    "currency_kind": "crypto",
    "direction": "INBOUND",
    "wallet_address": "0x12ab...90cd",
    "include_crypto_screening": true,
    "subject": { "vendor_data": "user_2201", "role": "RECEIVER" }
  }'

Вывод средств (OUTBOUND) — проверяйте адрес назначения перед выпуском:

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "wd_b58c",
    "category": "finance",
    "amount": 8000,
    "currency": "USDT",
    "currency_kind": "crypto",
    "direction": "OUTBOUND",
    "wallet_address": "0x44de...11ff",
    "include_crypto_screening": true,
    "subject": { "vendor_data": "user_2201", "role": "SENDER" }
  }'

Разветвляйтесь по полосе вердикта:

{
  "transaction_id": "wd_b58c",
  "status": "APPROVED",
  "wallet_screening": {
    "risk_score": 12,
    "risk_band": "LOW",
    "exposure": [ { "category": "EXCHANGE", "type": "DIRECT", "share": 0.96 } ]
  }
}

После расчетов, проверяйте подтвержденную транзакцию по хешу (payment_reference_id), чтобы сохранить аудиторскую запись после перевода.

Вебхуки. Подпишитесь на transaction.status.updated, чтобы ваш реестр отражал решения аналитиков и любые исправления AWAITING_USER.

Цена. $0.02 за проверку с BYOK (Crystal или Merkle Science), за вызов, без минимумов.

Эталонный поток

Запрос на депозит
   └─ POST /v3/transactions/ (INBOUND, wallet_address, screening)
        ├─ LOW / MEDIUM  → зачислить депозит
        ├─ HIGH          → приостановить; открыть оповещение; аналитик проверяет
        └─ CRITICAL      → отклонить; заморозить; открыть оповещение; рассмотреть SAR

Запрос на вывод средств
   └─ POST /v3/transactions/ (OUTBOUND, destination wallet_address, screening)
        ├─ LOW / MEDIUM  → выпустить
        ├─ HIGH          → приостановить; аналитик проверяет
        └─ CRITICAL      → заблокировать; открыть оповещение

После расчетов
   └─ POST /v3/transactions/ (hash as payment_reference_id) → аудиторская запись

Закодируйте обработку LOW/MEDIUM/HIGH/CRITICAL один раз в пакете правил Crypto screening, чтобы статус возвращался уже решенным — ваш бэкэнд просто действует в соответствии с ним.

Случаи использования

• Централизованные биржи — проверяйте каждый депозит и вывод средств; автоматически отклоняйте CRITICAL, ставьте в очередь HIGH, регистрируйте остальное.
• Он/офф-рампы — контролируйте конвертации фиат↔крипто на кошельке контрагента до расчетов по банковским рельсам.
• Брокерские компании, добавляющие криптоактивы — используйте существующую интеграцию мониторинга транзакций; крипто-скрининг использует ту же конечную точку.
• Кастодианы — проверяйте при поступлении и повторно проверяйте при перемещении, используя сетевой граф в качестве доказательства заморозки.
• VASP — сочетайте KYT с обменом данными по правилам FATF Travel Rule на том же движке для сквозного анализа рисков контрагентов.

Как интегрироваться с Didit

1. Настройте провайдера + по умолчанию. В Console → Transactions → Settings установите Crystal или Merkle Science (BYOK или управляемый) и поведение скрининга по умолчанию.
2. Напишите правила политики. Включите пакет правил Crypto screening и установите диапазоны → действия, чтобы большинство решений были автоматическими.
3. Проверяйте на обоих "входах". Вызовите POST /v3/transactions/ для каждого депозита (INBOUND) и вывода средств (OUTBOUND) до расчетов.
4. Записывайте после расчетов. Повторно проверяйте подтвержденную транзакцию по хешу для аудиторского следа.
5. Работайте с пограничными случаями. Скрининг HIGH/CRITICAL открывает оповещения; расследуйте, эскалируйте до дела и подавайте SAR в той же консоли.

Поскольку все это работает на унифицированном API /v3/, тот же пользователь, который вносит депозит, проходит мониторинг транзакций, помеченная транзакция может быть приостановлена через AWAITING_USER и вызвать шаг исправления, а KYC, KYT и AML объединяются в единую платформу для идентификации и предотвращения мошенничества.

Часто задаваемые вопросы

Где именно мне следует проводить скрининг?

В двух точках: адрес источника каждого депозита (INBOUND) перед зачислением и адрес назначения каждого вывода средств (OUTBOUND) перед выпуском. Добавьте посттранзакционный скрининг по хешу для записей.

Не будет ли скрининг каждой транзакции дорогим?

Нет. По цене $0.02 за проверку с BYOK — примерно в 10 раз дешевле, чем покупка аналитики напрямую — проверка каждого депозита и вывода средств доступна даже при больших объемах.

Как избежать ручной проверки каждого совпадения?

Закодируйте политику в пакете правил Crypto screening, чтобы LOW/MEDIUM проходили автоматически, HIGH направлялись к аналитику, а CRITICAL отклонялись. Аналитики занимаются только пограничными случаями.

Это также охватывает правило путешествий (Travel Rule)?

Да. Тот же движок мониторинга транзакций поддерживает правила FATF Travel Rule, поэтому обмен данными контрагентов и проверка кошельков работают вместе.

Каких провайдеров я могу использовать?

Сегодня это Crystal и Merkle Science (BYOK или управляемые); Chainalysis и Elliptic скоро появятся по цене $0.02 за BYOK.

Готовы начать?

Прочитайте обзор Wallet Screening в документации, посмотрите, как он вписывается в платформу на странице продукта Wallet Screening, и проверьте цены за вызов на странице цен. Когда будете готовы, начните бесплатно — 500 бесплатных проверок KYC каждый месяц и проверка кошельков по цене $0.02 за проверку с BYOK.