Saltar al contenido principal
La biblioteca oficial de Didit para C# y .NET. Es compatible con .NET 8 y .NET Standard 2.0, y todos los métodos de la API son async. En .NET Framework, usa C# 11 o posterior. Consulta la visión general de los SDK de servidor para ver lo que comparten todos los SDK.

Instalación

Para la inyección de dependencias de ASP.NET Core, añade también Didit.Extensions.DependencyInjection y registra el cliente con services.AddDidit(). Los paquetes son Didit y Didit.Extensions.DependencyInjection en NuGet. Su código fuente y su registro de cambios están en didit-protocol/sdk-dotnet en GitHub.

Configurar el cliente

new DiditClient() lee DIDIT_API_KEY del entorno. Pasa DiditClientOptions para sobrescribirla, o para establecer los ID de organización y de aplicación que necesitan las llamadas con ámbito de aplicación (casos, redes, informes regulatorios). Crea un único cliente y reutilízalo.
Las propiedades obligatorias de la solicitud son required, por lo que si falta alguna, el código no compila. Las opcionales que dejes sin establecer no se envían.

Crear una sesión

Crea una sesión de verificación para un workflow y envía a tu usuario a su URL.

Leer la decisión

Cuando el usuario finalice (o cuando llegue el webhook), lee la decisión. El resultado de cada función es una lista con una entrada por cada nodo del flujo.

Verificar un webhook

Pasa el cuerpo sin procesar, exactamente como se recibió, y una forma de leer los encabezados de la solicitud. DiditWebhooks.Verify lanza WebhookVerificationException para todo lo que no sea una entrega válida y reciente, y en caso contrario devuelve un evento tipado.
En una API mínima de ASP.NET Core, lee el cuerpo con un StreamReader y pasa name => request.Headers[name].FirstOrDefault(). Mientras rotas el secreto, pasa ambos: new[] { newSecret, oldSecret }. Consulta Webhooks para ver los eventos y el esquema de firma.

Analizar una transacción

Envía un pago, una retirada o una transferencia de criptomonedas a monitorización de transacciones; la respuesta incluye su estado y su puntuación de riesgo.

Verificar tokens de Authentication

Authentication comprueba en tu backend los tokens de acceso que firma tu emisor de Authentication, sin llamar a Didit en cada solicitud. También intercambia códigos, renueva tokens, comprueba y revoca sesiones, y realiza autenticaciones step-up.
La verificación de tokens realiza las comprobaciones descritas en Verificar un token en tu servidor, con el emisor y las claves de firma de tu aplicación.

Errores

Listas y archivos

Las páginas de endpoints de servidor de la referencia de la API incluyen un ejemplo en .NET para utilizarlos, salvo los endpoints y campos que aún no tiene ninguna versión 1.0.1, indicados en la visión general.
Última modificación el 1 de noviembre de 2026