Saltar al contenido principal
La biblioteca oficial de Didit para Python. Requiere Python 3.10 o posterior y ofrece un cliente síncrono, Didit, y otro asíncrono, AsyncDidit, con los mismos métodos. Consulta la descripción general de los SDK de servidor para ver lo que comparten todos los SDK.

Instalación

El paquete es didit-sdk en PyPI. Su código fuente y su registro de cambios están en didit-protocol/sdk-python, en GitHub. Para verificar tokens de Autenticación, instala el extra que añade la verificación de firma:

Configurar el cliente

Didit() lee DIDIT_API_KEY del entorno. Pasa opciones para sobrescribirla o para definir los ids de organización y de aplicación que necesitan las llamadas con ámbito de aplicación (casos, redes, informes regulatorios).

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 los bytes exactos del cuerpo sin procesar y los encabezados de la solicitud. verify lanza WebhookVerificationError ante cualquier cosa que no sea una entrega válida y reciente, así que basta con capturar esa única clase.
En Flask es handle_webhook(request.get_data(), dict(request.headers)); en FastAPI, handle_webhook(await request.body(), request.headers). Mientras se rota el secreto, pasa ambos: [new_secret, old_secret]. Consulta Webhooks para ver los eventos y el esquema de firma.

Analizar una transacción

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

Verificar tokens de Autenticación

didit.authentication comprueba los tokens de acceso que firma tu emisor de Autenticación, en tu backend, sin realizar una llamada a Didit en cada solicitud. También intercambia códigos, renueva tokens, comprueba y revoca sesiones y ejecuta autenticaciones reforzadas (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, archivos y async

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