Skip to main content
Когда платформа принимает депозит, она автоматически прогоняет AML-скрин source-of-funds — проверку адреса отправителя входящей транзакции на риск (санкции, миксеры, скам, даркнет и т.п.). Эти эндпоинты отдают результат уже выполненного скрина по существующему депозиту — по его uuid (из ответа на создание депозита) или по вашему order_id.
Это read-only выдача результата. Сам скрин запускает платформа автоматически при обнаружении входящей транзакции — отдельно ничего вызывать не нужно. Чтобы проскринить произвольный адрес или транзакцию по запросу, используйте AML-скрин адресов.
Аутентификация — та же HMAC-подпись, что и у депозитов (см. Аутентификация). Ответы — в конверте { "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
Риск-скор 0100 строкой. null, если проверки не было.
string | null
low, medium, high, severe. См. Уровни риска.
string | null
Решение скрина: pass, flag, block.
string | null
Код AML-провайдера, выполнившего скрин.
string | null
Категория риска с максимальным весом (например mixer, sanctions, scam, darknet).
object | null
Карта категорий риска и их весов 0..1. null, если провайдер их не вернул.
string | 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 — увести средства на отдельный карантинный кошелёк.
amlStatus: "hold" — сигнал вашей CMS не выдавать клиенту средства/услугу по этому депозиту, пока статус не сменится. Конкретные пороги и действие при блокировке (hold или сразу карантин) настраивает оператор, в том числе индивидуально по валюте.
Категория flag (риск между warn- и block-порогом) по умолчанию не блокирует депозит и даёт amlStatus: "flagged", но оператор может настроить более строгое действие для конкретной валюты.

Частые ошибки

Частые вопросы

senderAddress заполняется, когда платформа увидела входящую блокчейн-транзакцию депозита. До этого момента (и пока tx не подтверждена) он будет null, а amlStatusnot_checked.
Нет. Скрин адреса отправителя выполняется автоматически при приёме депозита (если AML включён и сеть поддерживается). Эти эндпоинты только отдают готовый результат.
Это значит, что валюта/сеть не поддерживается провайдером, поэтому скрин пропущен. Оценки риска нет — трактуйте как «не проверено», а не как «чисто».
Используйте вебхуки депозита: статусные изменения приходят на ваш callback_url. Деталь AML затем читайте этими эндпоинтами. Подробнее про депозиты — Депозиты.