Saltar para o conteúdo principal
A biblioteca oficial da Didit para Python. Requer Python 3.10 ou posterior e disponibiliza um cliente síncrono, Didit, e um cliente assíncrono, AsyncDidit, com os mesmos métodos. Consulte o resumo dos SDKs de servidor para saber o que todos os SDK têm em comum.

Instalação

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

Configurar o cliente

Didit() lê DIDIT_API_KEY a partir do ambiente. Passe opções para a substituir, ou para definir os IDs da organização e da aplicação de que as chamadas ao nível da aplicação (casos, redes, relatórios regulamentares) precisam.

Criar uma sessão

Crie uma sessão de verificação para um fluxo e envie o seu utilizador para o respetivo URL.

Ler a decisão

Quando o utilizador concluir (ou quando o webhook chegar), leia a decisão. Cada resultado de funcionalidade é uma lista com uma entrada por nó do fluxo.

Verificar um webhook

Passe os bytes brutos exatos do corpo e os cabeçalhos do pedido. verify gera WebhookVerificationError para qualquer entrega que não seja válida e recente, pelo que basta capturar essa classe.
Em Flask, é handle_webhook(request.get_data(), dict(request.headers)); em FastAPI, handle_webhook(await request.body(), request.headers). Enquanto substitui o segredo, passe ambos: [new_secret, old_secret]. Consulte Webhooks para os eventos e o esquema de assinatura.

Fazer a triagem de uma transação

Envie um pagamento, levantamento ou transferência de criptoativos para a monitorização de transações; a resposta inclui o respetivo estado 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 para cada pedido. Também troca códigos, atualiza tokens, verifica e revoga sessões e executa autenticações adicionais.
A verificação de tokens faz 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, ficheiros e assíncrono

As páginas de endpoints do servidor da referência da API têm um exemplo em Python para a respetiva operação, exceto para os endpoints e campos que nenhuma versão 1.0.1 ainda tem, indicados no resumo geral.
Última modificação em 7 de novembro de 2026