Чем проверка транзакции отличается от проверки адреса
Проверка адреса оценивает всё, что стоит за адресом: из каких источников на него приходили средства. Проверка транзакции привязана к конкретному переводу — для неё указываются хэш транзакции и адрес получателя.
Стоимость одинаковая: и адрес, и транзакция списывают одну проверку с баланса.
Как читать оценку
Само число мало что значит без раскладки. Ответ содержит поле signals — доли средств по источникам, и именно оно объясняет, почему оценка такая: например, 0.6 из миксера и 0.3 из даркнет-маркета дадут высокий скор.
Статус проверки приходит в поле status: ok — риск ниже порога блокировки, dirty — риск в зоне блокировки (50% и выше), pending — проверка ещё выполняется, error — ошибка провайдера с автоматическим возвратом проверки на баланс.
Как получить оценку через API
Создайте проверку методом POST /v1/checks с типом tx, кодом сети, хэшем транзакции и адресом получателя. В ответ придёт 202 Accepted с идентификатором.
Дальше есть два пути: опрашивать GET /v1/checks/{id} до финального статуса либо указать webhookUrl и получить результат push-уведомлением с подписью HMAC-SHA256.
FAQ
Какое значение считать блокирующим?
Порог зоны риска — 0.5 и выше: такой проверке присваивается статус dirty. Конкретное решение принимает ваша риск-политика.
Что делать, если проверка вернула ошибку?
Списанная проверка автоматически возвращается на баланс. Ошибки провайдера не оплачиваются.