API верификации и рисков транзакций

С помощью API-ключа платформы запускайте из своих систем проверку физических лиц (KYC), проверку компаний (KYB), мониторинг транзакций и проверку адресов кошельков, а также получайте записи проверок. Открытый API и консоль используют один и тот же процесс проверки: те же цены и те же правила для результатов, возвратов и сверки.

Сначала нажмите «Подключить» в разделе «Верификация и риски транзакций» консоли, затем создайте ключ в разделе «Управление API» и выдайте разрешения группы «Проверка и риски»: verification.read — для запроса цен и записей, verification.write — для запуска проверок. Плата за каждую проверку списывается с баланса аккаунта.

Интерфейсы

• GET /api/v1/verification/info: Возвращает, подключён ли сервис для вашего аккаунта, доступность и цену (USD) каждого из четырёх типов проверки, а также сети и активы, доступные для мониторинга транзакций и проверки кошельков. Для недоступных типов цена не указывается.
• POST /api/v1/verification/checks: Запускает проверку; списание и создание записи выполняются в одном запросе. Проверка личности возвращает ссылку для передачи handoff_url — отправьте её проверяемому; мониторинг транзакций и проверка кошелька обычно сразу возвращают результат.
• GET /api/v1/verification/checks: Список отсортирован по времени запуска, от новых к старым; поддерживаются фильтры kind, status, verdict и keyword (идентификатор / адрес / номер оплаты) и постраничный вывод через page и page_size (не более 100 записей на странице). Запрос одной записи включает handoff_url, пока сеанс ещё находится у проверяемого. Обновление заново запрашивает результат у провайдера (проверку кошелька обновить нельзя: повторная проверка оплачивается заново).

Повтор с тем же idempotency_key и тем же содержимым возвращает исходную запись без повторного списания; тот же ключ с другим содержимым отклоняется (400). Повторный запуск проверки личности для идентификатора с незавершённым сеансом возвращает этот сеанс (reused равно true) — также без списания.

Обратный вызов с результатом

Укажите https-адрес обратного вызова в разделе «Настройки интеграции» консоли и включите его. Когда статус или результат записи проверки меняется асинхронно (завершена проверка личности, результат изменён после ручной проверки, обновлён результат по транзакции, проверка не выполнена и плата возвращена), платформа отправляет событие POST-запросом. О запуске, который вы выполнили сами, событие не отправляется: синхронный ответ уже содержит результат.

Заголовок X-Tovanix-Event — тип события (check.updated или ping для теста), X-Tovanix-Delivery — event_id, X-Tovanix-Timestamp — время в секундах Unix, X-Tovanix-Signature — sha256=, за которым следует шестнадцатеричное значение HMAC-SHA256(секрет подписи, временная метка + "." + исходное тело запроса).

Ответ 2xx считается доставкой; во всех остальных случаях (включая тайм-аут) отправка повторяется с интервалами 1 минута, 5 минут, 15 минут, 1 час, 3 часа, 6 часов и 12 часов, всего не более 8 раз, после чего прекращается. Повторы отправляют тот же event_id и то же тело события — удаляйте дубли по event_id. События могут приходить не по порядку: ориентируйтесь на более новое data.updated_at либо после получения запросите актуальный статус через интерфейс запроса. После отключения обратного вызова недоставленные события больше не отправляются.

Связанные страницы: Верификация и риски транзакций · Проверка личности: физические лица и компании · Проверка транзакций: мониторинг и проверка кошельков · Документация API