Saltar al contingut principal
La biblioteca oficial de Didit per a Python. Requereix Python 3.10 o posterior i ofereix un client síncron, Didit, i un client asíncron, AsyncDidit, amb els mateixos mètodes. Consulta la visió general dels SDK de servidor per veure què comparteix cada SDK.

Instal·lació

El paquet és didit-sdk a PyPI. El codi font i el registre de canvis es troben a didit-protocol/sdk-python a GitHub. Per verificar tokens d’Authentication, instal·la l’extra que afegeix la comprovació de signatura:

Configura el client

Didit() llegeix DIDIT_API_KEY des de l’entorn. Passa opcions per sobreescriure-la, o per definir els identificadors d’organització i d’aplicació que necessiten les crides amb àmbit d’aplicació (casos, xarxes, informes regulatoris).

Crea una sessió

Crea una sessió de verificació per a un flux de treball i envia el teu usuari a la seva URL.

Llegeix la decisió

Quan l’usuari acabi (o quan arribi el webhook), llegeix la decisió. Cada resultat de cada funcionalitat és una llista amb una entrada per cada node del flux de treball.

Verifica un webhook

Passa els bytes exactes del cos brut de la petició i les capçaleres de la petició. verify llança WebhookVerificationError per a qualsevol lliurament que no sigui vàlid i recent, de manera que n’hi ha prou amb capturar aquesta única classe.
A Flask seria handle_webhook(request.get_data(), dict(request.headers)); a FastAPI, handle_webhook(await request.body(), request.headers). Mentre rotes el secret, passa’ls tots dos: [new_secret, old_secret]. Consulta Webhooks per als esdeveniments i per a l’esquema de signatura.

Cribra una transacció

Envia un pagament, una retirada o una transferència de criptoactius al monitoratge de transaccions; la resposta conté el seu estat i la puntuació de risc.

Verifica els tokens d’Authentication

didit.authentication comprova els tokens d’accés que signa el teu emissor d’Authentication, al teu backend, sense cridar Didit per a cada petició. També intercanvia codis, renova tokens, comprova i revoca sessions, i executa autenticacions reforçades.
La verificació de tokens fa les comprovacions descrites a Verifica un token al teu servidor, contra l’emissor i les claus de signatura de la teva aplicació.

Errors

Llistes, fitxers i asíncron

Les pàgines d’endpoints de servidor de la referència de l’API tenen un exemple en Python per a la seva operació, excepte els endpoints i camps que cap versió 1.0.1 encara no té, indicats a la visió general.
Darrera modificació el 7 de novembre del 2026