Pular para o conteúdo principal
A biblioteca oficial da Didit para Node.js e TypeScript. Ela roda em Node.js 18 ou versões posteriores, Bun, Deno e runtimes de borda com fetch, inclui builds em ES module e CommonJS e não tem dependências de runtime. Consulte a visão geral dos SDKs de servidor para saber o que todos os SDKs têm em comum.

Instalação

O pacote é o @didit-protocol/sdk-node no npm. O código-fonte e o changelog estão em didit-protocol/sdk-node no GitHub.

Configurar o cliente

new Didit() lê DIDIT_API_KEY do ambiente em Node.js, Bun e Deno (com --allow-env). Runtimes de edge não têm ambiente de processo, então, nesses casos, passe a chave como opção: new Didit({ apiKey: env.DIDIT_API_KEY }). Passe opções para substituí-la ou para definir os IDs de organização e de aplicação exigidos pelas chamadas no escopo da aplicação (casos, redes, relatórios regulatórios). O timeout é em milissegundos.
Com CommonJS, use const { Didit } = require("@didit-protocol/sdk-node");.

Criar uma sessão

Crie uma sessão de verificação para um workflow e envie seu usuário para a URL dela. Os campos da requisição mantêm os nomes da própria API.

Ler a decisão

Quando o usuário terminar a verificação (ou quando o webhook chegar), leia a decisão. Cada resultado de recurso de verificação é uma lista com uma entrada por nó do fluxo, e as datas e horas são objetos Date.

Verificar um webhook

Passe o corpo bruto (não o JSON já interpretado) e os cabeçalhos da requisição: um objeto req.headers do Node.js ou do Express, um objeto Headers da Fetch API ou pares [name, value] (o tipo WebhookHeaders). verify retorna uma promise e é rejeitada com WebhookVerificationError para qualquer coisa que não seja uma entrega válida e recente.
Com Express, leia o corpo com express.raw({ type: "application/json" }) e chame handleWebhook(req.body, req.headers). Enquanto você faz a rotação do segredo, passe os dois: [newSecret, oldSecret]. Consulte Webhooks para ver os eventos e o esquema de assinatura.

Analisar uma transação

Envie um pagamento, saque ou transferência de cripto para o monitoramento de transações; a resposta traz o status e a pontuação de risco.

Verificar tokens de Authentication

Authentication verifica, no seu backend, os tokens de acesso assinados pelo seu emissor de Authentication, sem chamar a Didit a cada requisição. Ele também troca códigos, renova tokens, verifica e revoga sessões e executa step-ups.
A verificação de tokens faz as checagens descritas em Verificar um token no seu servidor, usando o emissor e as chaves de assinatura da sua aplicação.

Erros

Listas e arquivos

As páginas de endpoints de servidor da referência da API têm um exemplo em Node.js para a operação correspondente, exceto para os endpoints e campos que ainda não existem em nenhuma versão 1.0.1 lançada, listados na visão geral.
Última modificação em 1 de novembro de 2026