Проверка кошельков до и после перевода (RU)

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

API проверки кошельков Didit поддерживает оба метода. Предварительная проверка принимает адрес кошелька и выдает вердикт о риске до того, как вы примете депозит или выпустите вывод средств. Пост-транзакционная проверка принимает хеш транзакции и оценивает подтвержденную транзакцию постфактум. Оба метода возвращают одинаковый показатель риска от 0 до 100 с диапазонами НИЗКИЙ/СРЕДНИЙ/ВЫСОКИЙ/КРИТИЧЕСКИЙ и разбивкой по источникам средств, и оба стоят $0.02 за проверку.

В этом руководстве объясняется разница и как интегрировать каждый метод в реальный рабочий процесс.

Основные выводы

• Предварительная проверка = адрес, до перемещения средств. Проверьте адрес кошелька, чтобы разрешить или запретить депозит или вывод средств до того, как это произойдет.
• Пост-транзакционная проверка = хеш транзакции, после завершения. Проверьте подтвержденную транзакцию (по payment_reference_id) для ведения учета и постоянного мониторинга.
• Одинаковая форма вердикта для обоих — оценка риска от 0 до 100, диапазон НИЗКИЙ/СРЕДНИЙ/ВЫСОКИЙ/КРИТИЧЕСКИЙ и подверженность по категории источников средств.
• Используйте оба метода вместе в большинстве рабочих процессов: предварительная проверка для принятия решения, пост-транзакционная проверка для документирования и повторной проверки.
• Активируется по currency_kind: "crypto" плюс направление (INBOUND / OUTBOUND); переопределяется для каждого вызова с помощью include_crypto_screening.
• $0.02 за проверку с BYOK (Crystal или Merkle Science), независимо от используемого времени.

Что проверяет каждый метод

Предварительная проверка оценивает адрес кошелька. Вы еще не знаете, будут ли перемещены какие-либо средства — вы спрашиваете: «если я приму средства с (или отправлю средства на) этот адрес, какому риску я подвергаюсь?» API отслеживает входящую и исходящую историю адреса и возвращает его риск. Это точка принятия решения: пропустить, отложить для проверки или отклонить до того, как что-либо будет завершено.

Пост-транзакционная проверка оценивает конкретную транзакцию по ее хешу. Средства уже перемещены; вы фиксируете риск того, что произошло, и поддерживаете его в актуальном состоянии. Поскольку ончейн-метки меняются — адрес может быть добавлен в санкционный список после того, как вы совершили с ним транзакцию — пост-транзакционная проверка (и периодическая повторная проверка) обеспечивает точность ваших записей для аудита и выполнения обязательств по постоянному мониторингу.

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

Выбор неправильного момента создает реальные пробелы. Если вы проверяете только после перевода, вы уже приняли средства, прежде чем узнали, что они рискованные — теперь вы отменяете завершенную транзакцию вместо того, чтобы отклонить ожидающую. Если вы проверяете только до перевода, ваши записи устаревают: вердикт, который вы получили во время депозита, не отражает информацию, появившуюся позже, что ослабляет любой аудиторский след и пропускает ретроактивные санкционные обозначения.

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

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

Оба режима работают в унифицированном API /v3/ в рамках Transaction Monitoring. Разница заключается в том, передаете ли вы адрес кошелька или ссылку на транзакцию.

Предварительная проверка — проверка адреса перед приемом депозита:

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_61a0",
    "category": "finance",
    "currency_kind": "crypto",
    "direction": "INBOUND",
    "wallet_address": "0x4d2a...91bc",
    "include_crypto_screening": true,
    "subject": { "vendor_data": "user_5012", "role": "RECEIVER" }
  }'

Пост-транзакционная проверка — проверка завершенной транзакции по ее хешу:

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_77f3",
    "category": "finance",
    "currency_kind": "crypto",
    "direction": "OUTBOUND",
    "payment_reference_id": "0xabc123...def",
    "include_crypto_screening": true,
    "subject": { "vendor_data": "user_5012", "role": "SENDER" }
  }'

Оба возвращают одинаковую структуру вердикта:

{
  "wallet_screening": {
    "risk_score": 41,
    "risk_band": "MEDIUM",
    "exposure": [
      { "category": "HIGH_RISK_EXCHANGE", "type": "DIRECT", "share": 0.27 }
    ]
  }
}

Триггер. Проверка срабатывает, когда currency_kind равен "crypto" и установлено direction (INBOUND или OUTBOUND). Настройка по умолчанию — автоматически ли проверяются криптотранзакции — настраивается в Console → Transactions → Settings, а include_crypto_screening переопределяет ее для каждого вызова.

Ключевое поле. Передайте wallet_address для предварительной проверки; передайте хеш транзакции как payment_reference_id для пост-транзакционной проверки.

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

Когда использовать каждый метод

Сценарий	Использование	Почему
Прием депозита	Предварительная проверка (адрес)	Принять решение до того, как средства станут вашими
Выпуск вывода средств	Предварительная проверка (адрес назначения)	Блокировать отправку на рискованный кошелек
Запись завершенного перевода	Пост-транзакционная проверка (хеш)	Точный аудиторский след того, что было перемещено
Периодическая повторная проверка	Пост-транзакционная проверка (хеш)	Отслеживать ретроактивные санкционные обозначения
Как шлюзование, так и ведение учета	Оба	Шлюзование на входе, документирование после

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

• Криптовалютные биржи — предварительная проверка каждого депозита и вывода средств для контроля потока; пост-транзакционная проверка для ведения полного, перепроверяемого реестра.
• On/off-рампы — предварительная проверка для блокировки конвертаций с участием высокорисковых кошельков до завершения.
• Кастодианы — предварительная проверка при поступлении, пост-транзакционная повторная проверка хранимых активов по мере изменения меток.
• Кошельки — предварительная проверка для предупреждения пользователя перед отправкой на помеченный адрес.
• VASP — записи пост-транзакционной проверки в сочетании с данными Travel Rule для надежного соответствия требованиям.

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

1. Установите значение по умолчанию в Transactions → Settings — выберите, будут ли криптотранзакции проверяться автоматически и какой ключ провайдера использовать.
2. Шлюзуйте на входе. Перед приемом депозита или выпуском вывода средств, POST /v3/transactions/ с wallet_address и действуйте в соответствии с диапазоном.
3. Записывайте после завершения. Как только транзакция подтвердится, проверьте ее снова с хешем в качестве payment_reference_id.
4. Обрабатывайте оповещения. Проверки с высоким/критическим риском открывают оповещения во встроенном менеджере дел для расследования и подачи отчетов о подозрительной деятельности (SAR).

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

В чем практическая разница между предварительной и пост-транзакционной проверкой?

Предварительная проверка анализирует адрес кошелька до перемещения средств, чтобы вы могли отклонить транзакцию. Пост-транзакционная проверка анализирует завершенную транзакцию по ее хешу, чтобы у вас была точная, перепроверяемая запись.

Нужно ли мне делать и то, и другое?

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

Как мне проверить хеш транзакции?

Передайте хеш как payment_reference_id в POST /v3/transactions/ с currency_kind: "crypto" и направлением.

Стоит ли выполнение обеих проверок в два раза дороже?

Да — $0.02 каждая — но при такой цене две проверки все равно значительно дешевле, чем одна проверка по устаревшей подписке на блокчейн-аналитику.

Могу ли я включить проверку только для некоторых транзакций?

Да. Установите значение по умолчанию в Console → Transactions → Settings и переопределите для каждого вызова с помощью include_crypto_screening.

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

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