Vai al contenuto principale
La libreria ufficiale Didit per C# e .NET. Supporta .NET 8 e .NET Standard 2.0, e ogni metodo dell’API è async. Su .NET Framework, usa C# 11 o versioni successive. Consulta la panoramica degli SDK server per ciò che condividono tutti gli SDK.

Installazione

Per l’iniezione delle dipendenze di ASP.NET Core, aggiungi anche Didit.Extensions.DependencyInjection e registra il client con services.AddDidit(). I pacchetti sono Didit e Didit.Extensions.DependencyInjection su NuGet. Il loro codice sorgente e il changelog si trovano in didit-protocol/sdk-dotnet su GitHub.

Configurare il client

new DiditClient() legge DIDIT_API_KEY dall’ambiente. Passa DiditClientOptions per sovrascriverlo, oppure per impostare gli id dell’organizzazione e dell’applicazione di cui hanno bisogno le chiamate con ambito di applicazione (casi, reti, report normativi). Crea un solo client e riutilizzalo.
Le proprietà obbligatorie della richiesta sono required, quindi una proprietà mancante causa un errore di compilazione. Le proprietà opzionali che lasci non impostate non vengono inviate.

Creare una sessione

Crea una sessione di verifica per un workflow e invia il tuo utente al relativo URL.

Leggere la decisione

Quando l’utente termina la procedura (o quando arriva il webhook), leggi la decisione. Il risultato di ogni funzionalità è una lista con una voce per ogni nodo del flusso.

Verificare un webhook

Passa il corpo grezzo, esattamente come ricevuto, e un modo per leggere le intestazioni della richiesta. DiditWebhooks.Verify genera WebhookVerificationException per qualsiasi consegna che non sia valida e recente, e restituisce un evento tipizzato in caso contrario.
In un’API minimal di ASP.NET Core, leggi il corpo con un StreamReader e passa name => request.Headers[name].FirstOrDefault(). Mentre ruoti il segreto, passa entrambi: new[] { newSecret, oldSecret }. Consulta Webhook per gli eventi e lo schema di firma.

Screening di una transazione

Invia un pagamento, un prelievo o un trasferimento di criptovalute al monitoraggio delle transazioni; la risposta contiene il suo stato e il punteggio di rischio.

Verificare i token di Authentication

Authentication verifica i token di accesso che l’emittente della tua Authentication firma, nel tuo backend, senza chiamare Didit per ogni richiesta. Inoltre scambia i codici, aggiorna i token, verifica e revoca le sessioni ed esegue gli step-up.
La verifica dei token esegue i controlli descritti in Verifica un token sul tuo server, con l’emittente e le chiavi di firma della tua applicazione.

Errori

Liste e file

Le pagine degli endpoint server della documentazione API includono un esempio .NET per la relativa operazione, ad eccezione degli endpoint e dei campi che non sono ancora presenti in alcuna release 1.0.1, indicati nella panoramica.
Ultima modifica il 7 novembre 2026