Перейти к основному содержанию
Официальная библиотека Didit для Java и Kotlin. Для работы нужна Java 11 или новее. Она зависит только от java.net.http, Jackson и аннотаций nullness JSpecify. У каждого метода есть вариант ...Async, который возвращает CompletableFuture. Что общего у всех серверных SDK, описано в обзоре серверных SDK.

Установка

Артефакт доступен как me.didit:didit-java в Maven Central. Исходный код и журнал изменений находятся в didit-protocol/sdk-java на GitHub.

Настройка клиента

new Didit() читает DIDIT_API_KEY из переменных окружения. Чтобы переопределить его, а также задать идентификаторы организации и приложения, которые нужны вызовам в контексте приложения (кейсы, сети, регуляторные отчёты), используйте builder.
Типы запросов представлены билдерами; метод build() проверяет обязательные поля. Необязательные поля ответа представлены значениями Optional. В Kotlin их читают через .getOrNull(). Фрагменты кода на этой странице и на каждой странице справочника API являются телом метода, а нужные импорты указаны над ними.

Создание сессии

Создайте сессию верификации для сценария и отправьте пользователя по её URL.

Получение решения

Когда пользователь завершит процесс (или когда придёт webhook), получите решение. Каждый результат функции представляет собой список с одной записью на каждый узел сценария.

Проверка webhook

Передайте необработанное тело запроса ровно в том виде, в каком оно получено, и заголовки запроса. Webhooks.verify выбрасывает WebhookVerificationException для любой доставки, которая не является действительной и актуальной, а в остальных случаях возвращает типизированное событие.
В Spring Boot тело передаётся как @RequestBody byte[] body, а заголовки как @RequestHeader Map<String, String> headers. Чтобы принимать два секрета во время ротации одного из них, передайте VerifyOptions. События и схема подписи описаны на странице Webhooks.

Скрининг транзакции

Отправьте платёж, вывод средств или криптоперевод в мониторинг транзакций. В ответе будут указаны статус и оценка риска.

Проверка токенов Authentication

Authentication проверяет токены доступа, которые подписывает ваш издатель Authentication, на вашем бэкенде, без вызова Didit для каждого запроса. Также он обменивает коды, обновляет токены, проверяет и отзывает сессии и выполняет проверки с усиленной аутентификацией.
Проверка токенов выполняет проверки из раздела Проверка токена на вашем сервере с учётом издателя и ключей подписи вашего приложения.

Ошибки

Все исключения являются наследниками непроверяемого исключения DiditException.

Списки и файлы

Страницы серверных эндпоинтов справочника API содержат пример на Java для своей операции. Исключение составляют эндпоинты и поля, которых пока нет в релизе 1.0.1. Они перечислены в обзоре.
Последнее изменение 7 ноября 2026 г.