Saltar para o conteúdo principal
A biblioteca oficial da Didit para PHP. Requer PHP 8.1 ou superior e funciona com qualquer cliente HTTP compatível com PSR-18; o Guzzle é a escolha mais comum. Consulte a visão geral dos SDKs para servidor para ver o que todos os SDKs têm em comum.

Instalação

O pacote é o didit-protocol/sdk-php no Packagist. O código-fonte e o registo de alterações estão em didit-protocol/sdk-php no GitHub. A verificação de tokens do Authentication também requer a extensão openssl.

Configurar o cliente

new DiditClient() lê DIDIT_API_KEY a partir do ambiente. Passe argumentos nomeados para substituir esse valor, ou para definir os identificadores da organização e da aplicação de que as chamadas ao nível da aplicação (casos, redes e relatórios regulamentares) precisam. Os campos do pedido são um único array com os nomes de campos da própria API; as respostas são objetos só de leitura com propriedades em camelCase e toArray().

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 terminar (ou quando o webhook chegar), leia a decisão. Cada resultado de funcionalidade é uma lista com uma entrada por cada nó do fluxo.

Verificar um webhook

Passe o corpo bruto, exatamente como foi recebido, e os cabeçalhos do pedido. verify lança WebhookVerificationException para qualquer entrega que não seja válida e recente, e devolve um evento tipado nos restantes casos.
No Laravel e no Symfony, passe $request->getContent() e $request->headers->all(); com um pedido PSR-7, passe o próprio pedido como cabeçalhos. Enquanto faz a rotação do segredo, passe ambos: [$newSecret, $oldSecret]. Consulte Webhooks para os eventos e o esquema de assinatura.

Fazer a triagem de uma transação

Envie um pagamento, um levantamento ou uma transferência de criptoativos para a monitorização de transações; a resposta indica o respetivo estado e a pontuação de risco.

Verificar tokens de Authentication

Authentication verifica os tokens de acesso assinados pelo emissor do seu Authentication, no seu backend, sem chamar a Didit em cada pedido. Passe uma cache PSR-16 para que as chaves do emissor sejam obtidas uma vez, e não em cada pedido. Também troca códigos, atualiza tokens, verifica e revoga sessões, e executa step-ups.
A verificação de tokens executa as validações descritas em Verificar um token no seu servidor, com base no emissor e nas chaves de assinatura da sua aplicação.

Erros

Listas e ficheiros

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