uuid
(из ответа на создание депозита) или по вашему order_id.
Это read-only выдача результата. Сам скрин запускает платформа автоматически при обнаружении
входящей транзакции — отдельно ничего вызывать не нужно. Чтобы проскринить произвольный адрес или
транзакцию по запросу, используйте AML-скрин адресов.
{ "ok": true, "data": ... }. Если AML не лицензирован на инстансе, эндпоинты
вернут 403 с кодом LICENSE_REQUIRED.
Эндпоинты
Оба варианта возвращают одинаковую структуру. Запросы скоупятся по вашему сайту — чужой депозит
вернёт
404 (существование чужих данных не раскрывается).
Если AML на инстансе выключен, входящая транзакция ещё не замечена, или сеть/валюта не
поддерживается провайдером — вернётся валидный ответ с
amlStatus: "not_checked" и null в полях
оценки. Это не значит «чисто» — это значит «оценки нет». Поле checkState отражает жизненный
цикл самого запроса к провайдеру.Получить AML депозита
Поля ответа
string
UUID депозита (тот же, что в
GET /v1/public/deposits/{uuid}).string
Ваш
order_id, переданный при создании депозита.string
Код актива депозита (например
USDT_TRC20).string
Код сети депозита.
string | null
Адрес отправителя входящей транзакции — именно он проходит скрин.
null, пока транзакция не замечена.string
Итоговый AML-статус депозита:
not_checked, passed, flagged, hold, rejected. См. ниже.string | null
Состояние запроса к провайдеру:
pending, success, failed, error, skipped. null, если проверки не было.string | null
Риск-скор
0–100 строкой. null, если проверки не было.string | null
string | null
Решение скрина:
pass, flag, block.string | null
Код AML-провайдера, выполнившего скрин.
string | null
Категория риска с максимальным весом (например
mixer, sanctions, scam, darknet).object | null
Карта категорий риска и их весов
0..1. null, если провайдер их не вернул.string | null
Ссылка на полный отчёт провайдера, если доступна.
Публичная share-ссылка на отчёт, если доступна.
string | null
Когда выполнен скрин (ISO-8601).
null, если проверки не было.string | null
Ручное действие оператора над задержанным депозитом:
release (разрешить свип) или quarantine_now. null, если оператор ещё не вмешивался.string | null
Когда применено ручное действие (ISO-8601).
string | null
Комментарий оператора к ручному действию.
Итоговый статус депозита (amlStatus)
amlStatus — это решение платформы по депозиту в целом. Оно выводится из decision скрина по
настроенной оператором политике (пороги риска и действия).
Поведение при высоком риске (hold)
Когда скрин возвращаетdecision: "block" (риск выше блок-порога или обнаружен критичный сигнал
уровня severe — например санкции), платформа по умолчанию переводит депозит в amlStatus: "hold":
- средства не сметаются (sweep) на системные кошельки до явного решения оператора;
- оператор в Админке принимает решение — оно отражается в полях
manualAction/manualActionAt/manualActionReason:release— снять блокировку и разрешить обычный свип;quarantine_now— увести средства на отдельный карантинный кошелёк.
flag (риск между warn- и block-порогом) по умолчанию не блокирует депозит и даёт
amlStatus: "flagged", но оператор может настроить более строгое действие для конкретной валюты.
Частые ошибки
Частые вопросы
Когда появляется senderAddress?
Когда появляется senderAddress?
senderAddress заполняется, когда платформа увидела входящую блокчейн-транзакцию депозита. До этого
момента (и пока tx не подтверждена) он будет null, а amlStatus — not_checked.Нужно ли мне самому запускать скрин депозита?
Нужно ли мне самому запускать скрин депозита?
Нет. Скрин адреса отправителя выполняется автоматически при приёме депозита (если AML включён и сеть
поддерживается). Эти эндпоинты только отдают готовый результат.
checkState = skipped — это плохо?
checkState = skipped — это плохо?
Это значит, что валюта/сеть не поддерживается провайдером, поэтому скрин пропущен. Оценки риска нет —
трактуйте как «не проверено», а не как «чисто».
Как узнать о смене amlStatus, не опрашивая постоянно?
Как узнать о смене amlStatus, не опрашивая постоянно?
Используйте вебхуки депозита: статусные изменения приходят на ваш
callback_url. Деталь AML затем
читайте этими эндпоинтами. Подробнее про депозиты — Депозиты.