Pular para o conteúdo principal
A biblioteca oficial da Didit para Python. Ela exige Python 3.10 ou superior e oferece um cliente síncrono, Didit, e um assíncrono, AsyncDidit, com os mesmos métodos. Consulte a visão geral dos SDKs de servidor para ver o que todos os SDKs têm em comum.

Instalação

O pacote é o didit-sdk no PyPI. O código-fonte e o changelog estão em didit-protocol/sdk-python no GitHub. Para verificar tokens de Authentication, instale o extra que adiciona a verificação de assinatura:

Configurar o cliente

Didit() lê DIDIT_API_KEY do ambiente. Passe opções para substituí-la ou para definir os IDs da organização e da aplicação exigidos pelas chamadas no escopo da aplicação (casos, redes, relatórios regulatórios).

Criar uma sessão

Crie uma sessão de verificação para um workflow e envie seu usuário para a URL dela.

Ler a decisão

Quando o usuário terminar (ou quando o webhook chegar), leia a decisão. O resultado de cada recurso é uma lista com uma entrada por nó do fluxo.

Verificar um webhook

Passe exatamente os bytes do corpo bruto e os cabeçalhos da requisição. verify lança WebhookVerificationError quando não se tratar de uma entrega válida e recente, então capturar essa única classe é suficiente.
No Flask, isso é handle_webhook(request.get_data(), dict(request.headers)); no FastAPI, handle_webhook(await request.body(), request.headers). Durante a rotação do segredo, passe os dois: [new_secret, old_secret]. Consulte Webhooks para ver os eventos e o esquema de assinatura.

Analisar uma transação

Envie um pagamento, um saque ou uma transferência de criptoativos para o monitoramento de transações; a resposta traz o status e a pontuação de risco.

Verificar tokens de Authentication

didit.authentication verifica os tokens de acesso que o seu emissor de Authentication assina, no seu backend, sem chamar a Didit a cada requisição. Ele também troca códigos, renova tokens, verifica e revoga sessões e executa step-ups.
A verificação de tokens realiza as verificações descritas em Verificar um token no seu servidor, com base no emissor e nas chaves de assinatura da sua aplicação.

Erros

Listas, arquivos e async

As páginas dos endpoints de servidor da referência da API incluem um exemplo em Python de como usá-los, com exceção dos endpoints e campos que ainda não estão em nenhuma versão 1.0.1, listados na visão geral.
Última modificação em 1 de novembro de 2026