Saltar para o conteúdo principal
Biblioteca oficial da Didit para C# e .NET. Destina-se ao .NET 8 e ao .NET Standard 2.0, e todos os métodos da API são async. No .NET Framework, use C# 11 ou superior. Consulte a visão geral dos SDK de servidor para ver o que todos os SDK partilham.

Instalar

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

Configurar o cliente

new DiditClient() lê DIDIT_API_KEY do ambiente. Passe DiditClientOptions para o substituir, ou para definir os identificadores da organização e da aplicação de que as chamadas com âmbito de aplicação (casos, redes, relatórios regulamentares) precisam. Crie um cliente e reutilize-o.
As propriedades obrigatórias dos pedidos são marcadas com required, pelo que uma propriedade em falta falha na compilação. As opcionais que deixar por definir não são enviadas.

Criar uma sessão

Crie uma sessão de verificação para um fluxo e envie o seu utilizador para o respetivo URL.

Ler a decisão

Quando o utilizador concluir (ou quando o webhook chegar), leia a decisão. Cada resultado de funcionalidade é 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 do pedido. DiditWebhooks.Verify lança WebhookVerificationException para qualquer entrega que não seja válida e recente, e devolve um evento tipado caso contrário.
Numa API mínima do ASP.NET Core, leia o corpo com um StreamReader e passe name => request.Headers[name].FirstOrDefault(). Durante a rotação do segredo, passe ambos os segredos: new[] { newSecret, oldSecret }. Consulte Webhooks para ver os eventos e o esquema de assinatura.

Analisar uma transação

Envie um pagamento, um levantamento ou uma transferência de criptomoeda para a monitorização de transações; a resposta inclui o respetivo estado e a pontuação de risco.

Verificar tokens de Authentication

Authentication verifica os tokens de acesso que o emissor da Authentication assina, no seu backend, sem chamar a Didit em cada pedido. Também troca códigos, renova tokens, verifica e revoga sessões e executa autenticações adicionais (autenticação reforçada).
A verificação de tokens faz as validações descritas em Verificar um token no seu servidor, com base no emissor e nas chaves de assinatura da sua aplicação.

Erros

Listas e ficheiros

As páginas de endpoints de servidor da referência da API têm um exemplo em .NET para a respetiva operação, exceto os endpoints e campos que nenhuma versão 1.0.1 ainda inclui, indicados na visão geral.
Última modificação em 7 de novembro de 2026