Pular para o conteúdo principal
A biblioteca oficial da Didit para PHP. Ela exige PHP 8.1 ou posterior e funciona com qualquer cliente HTTP PSR-18; o Guzzle é a escolha mais comum. Veja a visão geral dos SDKs de servidor para saber o que todos os SDKs têm em comum.

Instalação

O pacote didit-protocol/sdk-php está disponível no Packagist. O código-fonte e o changelog ficam em didit-protocol/sdk-php no GitHub. A verificação de tokens de Authentication também exige a extensão openssl.

Configurar o cliente

new DiditClient() lê DIDIT_API_KEY do ambiente. Passe argumentos nomeados para sobrescrever esse valor ou para definir os ids da organização e da aplicação que as chamadas no escopo da aplicação (casos, redes, relatórios regulatórios) exigem. Os campos da requisição formam um único array com os mesmos nomes de campo da API; as respostas são objetos somente de leitura com propriedades em camelCase e toArray().

Criar uma sessão

Crie uma sessão de verificação para um workflow e envie o 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 o corpo bruto, exatamente como foi recebido, e os cabeçalhos da requisição. verify lança WebhookVerificationException para qualquer coisa que não seja uma entrega válida e recente e, caso contrário, retorna um evento tipado.
No Laravel e no Symfony, passe $request->getContent() e $request->headers->all(); com uma requisição PSR-7, passe a própria requisição como os cabeçalhos. Enquanto você faz a rotação do segredo, passe os dois: [$newSecret, $oldSecret]. Veja Webhooks para conhecer os eventos e o esquema de assinatura.

Analisar uma transação

Envie um pagamento, saque ou transferência de criptomoedas para o monitoramento de transações; a resposta contém seu status e sua pontuação de risco.

Verificar tokens do Authentication

Authentication verifica os tokens de acesso que o seu emissor do Authentication assina, no seu backend, sem chamar a Didit a cada requisição. Passe um cache PSR-16 para que as chaves do emissor sejam buscadas uma única vez, e não 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 faz as checagens descritas em Verificar um token no seu servidor, usando o emissor e as chaves de assinatura da sua aplicação.

Erros

Listas e arquivos

As páginas de endpoints de servidor da referência da API trazem um exemplo em PHP para a operação correspondente, exceto os endpoints e campos que ainda não existem em nenhuma versão 1.0.1, indicados na visão geral.
Última modificação em 1 de novembro de 2026