Pular para o conteúdo principal
A biblioteca oficial da Didit para C# e .NET. Compatível com o .NET 8 e o .NET Standard 2.0, e todo método da API é async. No .NET Framework, use C# 11 ou posterior. Consulte a visão geral dos SDKs de servidor para ver o que todos os SDKs têm em comum.

Instalação

Para a injeção de dependência do ASP.NET Core, adicione também Didit.Extensions.DependencyInjection e registre o cliente com services.AddDidit(). Os pacotes são Didit e Didit.Extensions.DependencyInjection no NuGet. O código-fonte e o changelog estão em didit-protocol/sdk-dotnet no GitHub.

Configurar o cliente

new DiditClient() lê DIDIT_API_KEY do ambiente. Passe DiditClientOptions para substituí-la ou para definir os IDs de organização e de aplicação de que as chamadas com escopo de aplicação (casos, redes, relatórios regulatórios) precisam. Crie um único cliente e reutilize-o.
As propriedades obrigatórias da requisição são marcadas como required, então a ausência de uma delas impede a compilação. As opcionais que você não definir não são enviadas.

Criar uma sessão

Crie uma sessão de verificação para um workflow e envie seu usuário para a URL dela.

Ler a decisão

Quando o usuário terminar (ou quando o webhook chegar), leia a decisão. O resultado de cada recurso é uma lista com uma entrada por nó do fluxo.

Verificar um webhook

Passe o corpo bruto, exatamente como foi recebido, e uma forma de ler os cabeçalhos da requisição. DiditWebhooks.Verify lança WebhookVerificationException para tudo o que não for uma entrega válida e recente e, caso contrário, retorna um evento tipado.
Em uma API mínima do ASP.NET Core, leia o corpo com um StreamReader e passe name => request.Headers[name].FirstOrDefault(). Enquanto você faz a rotação do segredo, passe os dois: new[] { newSecret, oldSecret }. Consulte Webhooks para ver os eventos e o esquema de assinatura.

Analisar uma transação

Envie um pagamento, um saque ou uma transferência de criptoativos 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 que o seu emissor de Authentication assina, 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, com base no emissor e nas chaves de assinatura da sua aplicação.

Erros

Listas e arquivos

As páginas dos endpoints do servidor da referência da API têm um exemplo em .NET para a respectiva operação, exceto os endpoints e campos que ainda não estão presentes em nenhuma versão 1.0.1, listados na visão geral.
Última modificação em 1 de novembro de 2026