Перейти к основному содержанию
Официальная библиотека Didit для Node.js и TypeScript. Она работает в Node.js 18 и новее, Bun, Deno и edge-средах с fetch, поставляется в сборках ES-модулей и CommonJS и не имеет runtime-зависимостей. Что общего у всех SDK, см. в обзоре серверных SDK.

Установка

Пакет доступен как @didit-protocol/sdk-node на npm. Исходный код и журнал изменений находятся в didit-protocol/sdk-node на GitHub.

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

new Didit() читает DIDIT_API_KEY из переменных окружения в Node.js, Bun и Deno (с --allow-env). В edge-средах переменных окружения процесса нет, поэтому там передайте ключ как опцию: new Didit({ apiKey: env.DIDIT_API_KEY }). Чтобы переопределить ключ или задать идентификаторы организации и приложения, которые нужны вызовам на уровне приложения (кейсы, сети, регуляторные отчёты), передайте опции. Таймаут задаётся в миллисекундах.
При использовании CommonJS применяйте const { Didit } = require("@didit-protocol/sdk-node");.

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

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

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

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

Проверка webhook

Передайте необработанное тело запроса (а не разобранный JSON) и заголовки запроса: объект req.headers в Node.js или Express, объект Headers из Fetch либо пары [name, value] (тип WebhookHeaders). Метод verify возвращает промис и отклоняется с WebhookVerificationError для любой доставки, которая не является действительной и актуальной.
В Express читайте тело через express.raw({ type: "application/json" }) и вызывайте handleWebhook(req.body, req.headers). Пока вы меняете секрет, передавайте оба: [newSecret, oldSecret]. События и схему подписи см. в разделе Webhooks.

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

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

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

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

Ошибки

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

На страницах серверных endpoint’ов справочника API есть пример на Node.js для соответствующей операции, за исключением endpoint’ов и полей, которых пока нет в релизе 1.0.1. Они перечислены в обзоре.
Последнее изменение 7 ноября 2026 г.